Kurento应用开发指南(以Kurento 6.0为模板) 之七:Kurento API 参考

2024-08-21 17:58

本文主要是介绍Kurento应用开发指南(以Kurento 6.0为模板) 之七:Kurento API 参考,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

13.1 Kurento API 参考
Kurento媒体服务器提供了一套API给高级语言使用,以用于应用程序开发人员来控制它。
这些API可以被用于Java或Javascript开发的Kurento 客户端。
如果你更喜欢其它开发语言,你可以使用基于WebSocket或JSON-PRC的Kurento协议。

在下面的章节中,我们将讲解Kurento API, 我们将显示Kurento媒体服务器提供给客户端的媒体能力。
如果你想看使用kurento的工作DEMO,你可以翻到前面看示例教程。

13.1.1 媒体元件和媒体管道

对于应用程序开发人员来说,Kurento提供了两个概念来作为构建模块:
>>> 媒体元件 
    媒体元件是对媒体流执行指定动作的功能单元。
    对于应用程序开发人员来说,媒体元件是每个能力的一种实现方式,它表示为自包含的"黑箱",
    开发人员在使用时,不需要理解底层的实现细节。
    媒体元件具有从其它元件(通过媒体源)接收媒体以及发送媒体到其它元素(通过媒体sink)的能力。
    依赖于它们的能力,媒体元件可划分成不同的类型:
    – 输入端点: 
       指具有接收媒体并注入到管道能力的媒体元件。
       有多种类型的输入端点。
       文件输入端点用来从文件获取媒体;
       网络输入端点用来从网络获取媒体;
       捕捉输入端点有直接从摄像头或其它类型的硬件源上捕捉媒体流的能力。


    – 滤镜: 
       指负责媒体转码或分析的媒体元件。
       因此,滤镜的功能包括混合流,混间,分析,填充等。


    – 集线器: 
       指负责管理一个管道中多个媒体流的媒体对象。
       一个集线器可以有多个集线端口,以连接多个媒体元件。
       依据集线类型,可以有多种方式来控制媒体。
       例如,Composite集线器可以将多个输入视频流合并到一个唯一的输出视频流。


    – 输出端点:
       指具有将媒体流从管道中输出的能力的媒体元件。
       因此,也有多种类型的输出端点,如文件,网络,屏幕等。


>>> 媒体管道: 
    媒体管道是一个媒体元件的链,
    在这个链中,输出流是由一个源元件输入到一个或多个其它媒体元件处理后再输出的。
    因此,管道表示能执行一系列流操作的机器。


Figure 13-1: 媒体管道示例,
实现了从一个WebRtcEndpoint接收媒体流,
叠加一个图像到侦测到的人脸上并返回结果流的交互式多媒体应用


Kurento API是面向对象的API.
因此,有一些类需要实例化。这些类定义的操作可以被这个类的对象所引用 。
这些类和其它相关类是继承关系,继承操作是从父类到子类的。
下面的类图显示了Kurento API中主类的关系。




Figure 13.2: Class diagram of main classes in Kurento API
从图中可以看出,
Endpoint, Filter,HubPort的父类是MediaElement,
而媒体元件、媒体管道,集线器的父类都是MediaObject.
另外,媒体管道可拥有多个媒体元件,
Hub可以拥有多个HubPort,
而MediaObject可以拥有一个媒体管道。


13.1.2 端点

先来讨论Kurento提供的不同种类的端点。
>>> WebRtcEndpoint
    是一种有输出和输入的端点,它通过Web为RTC(Real Time Communictions)提供媒体流。
    它为浏览器间的通信实现了WebRTC技术。
图示:


>>> RtpEndpoint 
    是一种有输出和输入的端点。
    它为两个远程的网络节点,通过RTP协议,提供双向的内容传输能力。
    正如你所想的,为了通过网络发送和接收媒体,它使用了RTP协议,并使用SDP做媒体协商;
图示:


>>> HttpPostEndpoint
    是一种只有输入的端点,
    它使用http POST请求,就像HTTP文件上传功能那样,接收媒体流。
图示:


>>> PlayerEndpoint
    是一种只有输入的端点,
    它从文件系统,Http URL或RTSP URL接收内容并将其注入到媒体管道中。
图示:


>>> RecorderEndpoint
    是一种只有输出的端点。
    它提供了以可靠模式存储内容的功能,它为音频和视频提供了媒体sink衬垫(pad)。
图示:


下面的类图显示了主要的端点类的关系:


Fig 13-3


13.1.3 滤镜

滤镜是执行媒体处理,机器视觉,虚拟现实等的媒体元件。
我们来看看Kurento提供的滤镜:


>>> The ZBarFilter filter
    检查视频流的QR和条形码。
    当发现有条形码时,滤镜会触发CodeFoundEvent事件,客户端可以添加一个对这个事件的监听器并执行相应的动作。


>>> The FaceOverlayFilter filter
    检查视频流中的人脸,并在人脸上叠加一个可设置的图片。


>>> GStreamerFilter
    它是一个通用的滤镜接口,它能使Kurento媒体管道使用GStreamer滤镜。


下面的类图显示了主要的滤镜类的关系:




Figure 13.4: Class diagram of Filters in Kurento API


13.1.4 集线器
集线器是负责管理管道中多媒体流的媒体对象。
一个集线器可以有多个连接其它媒体元件的集线端口,
我们来看下Kurento提供的集线器:
>>> Composite
    是一个混合多个输入的音频流,并与视频流组成的下网格的集线器。
图示:   
 
>>> DispatcherOneToMany
    是发送指定输入流到多个连接的输出集线端口的集线器。 
图示:


>>> Dispatcher
    是一个允许在任意输入-输出集线端口对做路由的集线器。
图示:




下面是集线器的类关系图:


Figure 13.5: Class diagram of Hubs in Kurento API


Kurento Client的细节可以看文档 JavaDoc/JsDoc:
 .  kurento-client-java : JavaDoc of Kurento Java Client.
    链接见:https://www.kurento.org/docs/6.0.0/langdoc/javadoc/index.html
 .  kurento-client-js : JsDoc of Kurento JavaScript Client.
 .  kurento-utils-js : JsDoc of an utility JavaScript library aimed to simplify the development of WebRTC applications.

这篇关于Kurento应用开发指南(以Kurento 6.0为模板) 之七:Kurento API 参考的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1093877

相关文章

Knife4j+Axios+Redis前后端分离架构下的 API 管理与会话方案(最新推荐)

《Knife4j+Axios+Redis前后端分离架构下的API管理与会话方案(最新推荐)》本文主要介绍了Swagger与Knife4j的配置要点、前后端对接方法以及分布式Session实现原理,... 目录一、Swagger 与 Knife4j 的深度理解及配置要点Knife4j 配置关键要点1.Spri

PostgreSQL的扩展dict_int应用案例解析

《PostgreSQL的扩展dict_int应用案例解析》dict_int扩展为PostgreSQL提供了专业的整数文本处理能力,特别适合需要精确处理数字内容的搜索场景,本文给大家介绍PostgreS... 目录PostgreSQL的扩展dict_int一、扩展概述二、核心功能三、安装与启用四、字典配置方法

Python设置Cookie永不超时的详细指南

《Python设置Cookie永不超时的详细指南》Cookie是一种存储在用户浏览器中的小型数据片段,用于记录用户的登录状态、偏好设置等信息,下面小编就来和大家详细讲讲Python如何设置Cookie... 目录一、Cookie的作用与重要性二、Cookie过期的原因三、实现Cookie永不超时的方法(一)

Linux中压缩、网络传输与系统监控工具的使用完整指南

《Linux中压缩、网络传输与系统监控工具的使用完整指南》在Linux系统管理中,压缩与传输工具是数据备份和远程协作的桥梁,而系统监控工具则是保障服务器稳定运行的眼睛,下面小编就来和大家详细介绍一下它... 目录引言一、压缩与解压:数据存储与传输的优化核心1. zip/unzip:通用压缩格式的便捷操作2.

Python中re模块结合正则表达式的实际应用案例

《Python中re模块结合正则表达式的实际应用案例》Python中的re模块是用于处理正则表达式的强大工具,正则表达式是一种用来匹配字符串的模式,它可以在文本中搜索和匹配特定的字符串模式,这篇文章主... 目录前言re模块常用函数一、查看文本中是否包含 A 或 B 字符串二、替换多个关键词为统一格式三、提

Java MQTT实战应用

《JavaMQTT实战应用》本文详解MQTT协议,涵盖其发布/订阅机制、低功耗高效特性、三种服务质量等级(QoS0/1/2),以及客户端、代理、主题的核心概念,最后提供Linux部署教程、Sprin... 目录一、MQTT协议二、MQTT优点三、三种服务质量等级四、客户端、代理、主题1. 客户端(Clien

Linux中SSH服务配置的全面指南

《Linux中SSH服务配置的全面指南》作为网络安全工程师,SSH(SecureShell)服务的安全配置是我们日常工作中不可忽视的重要环节,本文将从基础配置到高级安全加固,全面解析SSH服务的各项参... 目录概述基础配置详解端口与监听设置主机密钥配置认证机制强化禁用密码认证禁止root直接登录实现双因素

深度解析Spring Boot拦截器Interceptor与过滤器Filter的区别与实战指南

《深度解析SpringBoot拦截器Interceptor与过滤器Filter的区别与实战指南》本文深度解析SpringBoot中拦截器与过滤器的区别,涵盖执行顺序、依赖关系、异常处理等核心差异,并... 目录Spring Boot拦截器(Interceptor)与过滤器(Filter)深度解析:区别、实现

MySQL追踪数据库表更新操作来源的全面指南

《MySQL追踪数据库表更新操作来源的全面指南》本文将以一个具体问题为例,如何监测哪个IP来源对数据库表statistics_test进行了UPDATE操作,文内探讨了多种方法,并提供了详细的代码... 目录引言1. 为什么需要监控数据库更新操作2. 方法1:启用数据库审计日志(1)mysql/mariad

SpringBoot开发中十大常见陷阱深度解析与避坑指南

《SpringBoot开发中十大常见陷阱深度解析与避坑指南》在SpringBoot的开发过程中,即使是经验丰富的开发者也难免会遇到各种棘手的问题,本文将针对SpringBoot开发中十大常见的“坑... 目录引言一、配置总出错?是不是同时用了.properties和.yml?二、换个位置配置就失效?搞清楚加