Gstreamer应用程序指南学习笔记

Gstreamer说明

Gstreamer简介

是一个框架,灵活轻便。

第一部分基本没有难度,只要能看懂英文。从我目前接触的感觉上看,Gstreamer确实简化了动态库的加载,模块与模块间的合作。

但是Gstreamer用得还是有点不太习惯,可能是 GLIB这种风格没有适应。

gstreamer整个分为:

l         core:核心库

l         基础插件:一些很基础的插件

l         好插件:编写质量较好的遵循LGPL协议的插件

l         坏插件:有待改进的插件

l         其他库

1.1    核心库

核心库是不了解任何媒体信息的,它只是一个框架,将所有单元联系起来。

单元是gstreamer里的核心概念。

基础知识

2.1 单元

Element是构成管道的组件,每个element实际就是一个插件,在gst中得到组装成一个pipe,数据从源单元流向目的单元,完成整个流程。单元间是可以链接起来的(必须得链接起来以组成pipe)。

2.2 Pad

pad是一个单元的输入输出端口,通过pad,才能将两个单元链接到一起。对输入来说,pad就是一个插口,对输出来说pad就是一个塞子。pad有自己的规格,所以不同规格的pad就限制了数据的规格。只有规格相符的pad才能链接到一起。

l         规格协商的过程叫caps negotiation

l         数据类型叫GstCaps

2.3 盒子和管道

盒子Bin是一组单元的集合,而管道Pipeline是一种特殊的盒子,在管道中,所有单元可以一体执行某些。

在实现的时候,Bin也是一种单元,操纵Bin就可以改变内部所有单元的属性,而且Bin还能传递内部单元的信号事件。这样就简化了外界使用的难度。

管道是一个顶层的bin,可以设置状态为PAUSED或者PLAYING。内部会启动一个独立线程来干活。

GST构建

3.1 初始化

GST库必须先初始化,调用gst_init

3.2 单元elements

GstElement是最重要的对象。一些高级对象也是从它派生出来的。有好几种类型的elements,必须分清楚了。

1.       源单元

source单元是数据的产生方,对应一个源pad。一般画在右边。

l         源单元只能生产数据,不能接收数据

2.       中间单元

中间单元包括过滤器,转换器,复用器,解复用器,编解码器等。

它有多个源pad,对应多个目标pad

3.       目标单元

只能接受数据。

4.       创建和使用单元

通过factory_makegst_object_unref来创建及释放单元。make需要两个参数,一个是工厂名,一个是单元名。工厂名实际就是插件名,所以需要先加载插件上来,才能创建对应的单元。

单元继承所有Gobject的属性,所以可以当做Gobject来处理。

单元有属性,单元还能触发信号,所以必须关注这些。

作为工厂,其功能还不仅限于创建单元,一个工厂有属性,它知道自己能创建怎样的单元。

其实就是这个插件知道自己能创建怎样的单元。可能需要看了插件编写才真正知道。

5.       链接单元

单元必须链接起来,才能协同工作。

源单元-à中间单元--à目标单元

l         必须先加到管道后才能link起来。

l         不在同一bin中的不能link

6.       单元状态

单元链接好后,啥事也不会发生,除非设置单元状态。单元一共有四种状态:

l         GST_STATE_NULL:默认状态,内部会释放单元的所有资源,其实就是初始状态。

l         XXX_READY:就绪状态,分配资源,打开设备。但是流不会打开,所以此时流信息都是零。如果之前打开了流,在这状态中将会被关闭,流信息都会被重设。

l         XXX_PAUSED:已经打开了流,但是暂时不处理它。这个时候可以去修改例如seek位置等流信息。时间轴停止

l         XXX_PLAYING:时间轴运行。设置为这个状态后,整个流程就开始启动了。内部会将消息发送从管道所在的线程转移到应用程序线程。(?)

通过set_state函数设置状态,GST会平滑设置,例如从PLAY设置为NULL,将平滑设置READYPAUSED

3.4 Bins

Bin不仅是一个单元的集合,更是集成了对内部单元的管理。管道是一种特殊的bin,实际要播放一个视音频就得用到管道。管道能独立在后台运行。

1.       创建Bin

Binelement派生而来,所以创建单元的函数均可创建Bin,但一般用两个更方便的函数:

l         gst_bin_new

l         gst_pipeline_new

Bin是一个集合,需要将单元加入进去,也可以删除。

l         gst_bin_add,gst_bin_remove

注意,一旦加入到Bin,单元的所有者就变为Bin了,所以删除Bin的话,内部的单元也会相应减少引用。

2.       定制化Bin

还是得看插件编程指南才能真正理解。

3.5 Bus

1. 总论

Bus的好处是可以把pipeline所在的线程的消息路由到应用程序指定的那个Context中去。

是全局那个线程吗?待会查看下源码。定期检查bus?设计还是比较巧妙的。

bus上要加入监控回调函数。通过

l         gst_bus_add_watch/gst_bus_add_signal_watch

l         要从bus中取消息,得调用gst_bus_pop/peek/pop

注意,Bus发出的消息是GstMessage结构,值得解释。

Bus含一个队列,每次post一个消息就加到队列里,然后出发maincontextwakeup。这样就完成了将消息路由到maincontext去了。因为maincontext等待的有这个bus队列。

这里边绕啊绕的..想法还是很直观。

有没有办法不用默认context呢?有一个函数将message转换为signalemit

l         gst_bus_async_signal_func

这里要区分下messagesignalsignalGobject系统提供的,messageGST提供的。message的处理是异步的,而signal的处理是同步的。

如果你不想写很多switch来区别message的话,那么另外一种办法就是注册对应的signal到系统。另外,如果不使用mainloop的话,异步消息-信号不会发出去。

bus的消息分为异步和同步两类。

l         异步信号是通过加入到mainloop中的Gsource来触发的,所以必须有mainloop再运行才可

l         同步信号必须先注册一个同步信号处理函数才可。

 

需要自己设置一个同步信号处理函数,在那里触发另外一个context,并且调用上面这个函数发送signal

 

2.  message类型

描述一个message有以下:

l         Message的来源:记录是从哪个单元发出来的

l         类型:

l         时间戳

比较重要的是类型信息:有以下几类类型

l         error,warning,info等信息:需要调用对应API进行解析

l         EOS:文件结尾,需要重设管道状态等

l         Tag:标签信息(其实就是媒体信息,比如长度,采样率等)

l         State变化:

l         缓存信息:调用gst_bus_get_structure来解析缓存信息

l         单元信息:某些单元会发送特殊的信息

l         应用程序自己的信息

 

3.6 Pads和属性

Pads很关键,代表了单元的出入口。标示Pads特性的有两个:

l         方向,从单元内角度看,sink收数据,source发数据

l         可用性(availability

方向好说,只有sinksource两种,可用性是一个新概念。主要代表这个pad是存活期的。

分三种:

l         pad一直存在

l         动态存在:有时候有,有时候没有,动态创建和删除

l         响应存在:根据外界要求来创建

这个可用性是针对媒体文件类型的一种简化表示。下面针对这个具体讲述,pad的可用性非常重要。

1. 动态pad

为何会有动态之说?原因很简单。例如播放音频的时候,要动态检测有几路音频,然后再创建对应的pad

程序里边应该绑定一个消息处理函数到动态pad的创建通知上。

2. 响应pad

响应用户要求而创建的pad。必须从一个支持创建这种类型的单元中去创建,调用

l         gst_element_get_request_pad

这个element必须支持Request这种,这个熟悉由插件注册的时候指定的。

还有一种就是查找相容的pad

l         get_element_get_compatible_pad,根据源padcaps来从单元中找一个相容的。

 

3. Pad的属性

刚才提到过,查找相容的pad,那么相容是怎么判断和体现的呢?pad有自己的能力熟悉(Capabilities

pad的能力熟悉是和pad模板以及pad绑定一起的。pad模板估计就是一个pad工厂。

一个pad有很多不同的能力,这个是最原始的信息。但是具体工作后,一个pad要和别的pad协商,大家按照规定的能力办事。这样,pad的能力就是协商后的能力了。

能力在GST中用GstCaps来表示。

GstCaps含一到多个Gstructure,一个Gstructure代表一种pad能处理的媒体类型。

4. GST中属性和值的表示

GST除了使用GLIB中的数据类型外,还单独定义了一些数据类型,用来表示属性值。

值得注意的有:

l         GST_TYPE_INT_RANGE:范围值

l         GST_TYPE_LIST:包含任何基本类型都可以

l         GST_TYPE_ARRAY:只能包含相同的类型

5. Caps的用处

Caps实际的用处很多,其实就是一个寻找匹配padelement之用。

Caps中有一项描述媒体信息的,叫metadata。如何从caps中获取条目呢?

caps中存的是structure条目,一个structure代表一种能力

gst_caps_get_structure/size

根据条目多少和属性,caps可分为:

l         简单caps:只含一条structure

l         固定caps:含一条structure,并且属性值没有range之类可变化的

l         任意caps和空caps是两种特殊cap

 

6. 创建过滤器使用的caps

刚才讲的全是从单元中获取caps,都是已经弄好了的。那么如果想动态创建caps该如何做呢?

l         gst_caps_new_simple:创建simple

l         xx_full:创建nstructurecaps

这还只是创建pad,要把srcdst通过过滤单元链接起来,用

gst_element_link_filtered,内部会根据过滤pad自动创建一个capsfilter

所以关闭链接的时候,需要把srcdst分别从capsfilter中关闭链接。而非简单的关闭源和目标

 

7. 幽灵pad

有啥用?其实就是创建一个代理pad吧。

为啥要有个这个东西?因为bin本身是没有pad的。所以你就没办法把两个bin链接起来。

这个时候,可以用bin中的一个单元的pad构造一个代理pad,这样bin就有一个代理pad了。这个pad实际指向被代理的那个单元的pad

 

3.7 缓冲与事件

数据流动是以缓冲传递来实际工作的,所以buffer比较在重要。

eventsmessage不太一样,这个events实际就是命令,而且在管道中流动。这么说的话,buffer对应的就是数据。

从命名习惯上来说,buffer更应该看成是一种容器,里边含dataevents

1. Buffer

GstBuffer有以下成员:

l         数据内存指针

l         缓冲大小

l         时间戳

l         用者计数(与引用计数对应)

l         标识

2. Events

事件是一种控制数据,能够在管道中上下流动。

一般来说,上游的控制命令可能是真的在控制什么,来自下游的events可能大多数是些状态通知之类的。?原文是这么说的。

应用程序自己能发送控制?例如seek命令。

恩,确实应该有地方可以发送控制命令。典型的就是seek。用户也需要一个地方能做这个工作。

看来都是通过events方式来做到控制的。

l         gst_events_new_xxx

l         gst_element_send_event

先创建一个命令,然后发出去….

 

基本例子

这部分对应第10章,不打算介绍了。做到能看懂代码为准。

或者自己可以想想该怎么写一个这样的例子,能解释清楚里边的API调用次序和关系等。

看明白了,看来要使用一个gst还是相对比较容易的。但是要开发一个插件,可能难度就大很多了。尤其是里边的Buffer,事件之类的东西。争取2周搞定。

高级部分

5.1 查询与Seek

查询主要是获得进度信息(播放电影的时候那个进度条位置)。

seek与查询类似,seek的完成通过event方式来发送控制命令。

1. GST中的查询

GST为查询提供了丰富的接口,例如当前时间戳,当前读取帧数等信息,都可以查询到。

questions:在哪儿查?查哪个单元,怎么查?

Answer:估计是查pipe。调用gst_element_query

内部处理是先将该query发到sink单元,然后向上找看哪个单元能够处理,处理完了再把结果返回给调用程序。一般demuxer能够处理。

 

2. Seek

处理逻辑与查询类似。针对seek请求,单独可以构造一个gst_event_new_seek出来。

一个seek请求包含很多参数,这里不详述了。

有几个可以猜想到:seek的位置,seek多少等。

有一个标识关于是否刷新内部buffer的似乎很重要。

当处于PAUSEDPLAYING状态的时候,需要这个FLUSH标示。因为seek完了后,会回到以前的状态。

你可以等待seek真正完成,用:

l         gst_element_get_state

l         或者等到ASYNC_DONE消息

另外,只能在PLAYING状态下设置无FLUSH标示。seek命令的完成可能是在另外一个线程来做的。内部处理逻辑如下:

l         pause,如果开始是playing状态的话,位置信息将被重置

l         中间单元将重新位置处开始处理,直到sink单元收到数据,如果之前是play状态,则seek完成后也是play状态

 

5.2 元数据信息

MetaData应该是描述媒体文件信息之用的。gstMD分为两类:

l         标签信息(除媒体视音频格式之外的其他信息,例如属于哪个专辑,什么流派之类的),这类信息由GstTag系统完成

l         视音频格式信息,这个由pad完成

1. Tag信息读取

这个是通过管道的bus来读取的。可以监听GST_MESSAGE_TAG来完成。

2. Tag写入

使用GstTagSetter来完成,而且该单元必须支持tag设置。

奇怪,怎么设置?源一般按普通文件打开的,没法设置啊。

所以必须先从管道中找到那些能设置的。通过:

l         gst_bin_iterate_all_by_interface(GST_TYPE_TAG_SETTER)

l         然后调用gst_tag_setter_add等函数。

看了下manualTagsetter是一个接口,必须有类实现这个接口就可以了。

5.3 接口组合

接口类定义了一个实现单元应该支持的功能。

1. URI接口

其实就是定义一个支持通用路径的接口。

例如本地文件用file:,网页文件用http://

怎么获得一个支持特定URI地址的单元呢?

l         gst_element_make_from_uri,可以指定SRCDST

创建一个支持特定URI地址的单元。

2. MIXER接口

支持对硬件或软件音量的统一管理。一般那些直接和声卡硬件打交道的单元用实现这个接口。

有哪些功能呢?比如静音,调整左右声道等功能。

一般不要在播放中使用这种接口来控制音量,相反,应该使用sink单元的音量属性来控制。

也是啊,一般控制本地程序即可,不用去调节全局声卡的音量呀。

3. Tuner接口

用于调整多输入输出设备的,可能还是和硬件关系比较紧密。

4. 色彩平衡接口

用来调节亮度,对比度等内容的。

5. 属性探测接口

主要用途是来自动探测硬件设备的。

6. X重叠接口

X意味X-Window,主要是绘图用。

 

5.4 时钟

GST中使用时间的原因是:

l         有些单元提供了时钟,要是管道中没有时钟的话,就会用默认的系统时钟

l         有些单元根据时钟干活(clock slaves

GST中时间有好几种:

l         时钟时间,就是普通时间,一直增加的

l         基础时间:其实就是开始时间

l         运行时间:播放的时间,包括重播,回播种种之和

l         流时间:这个可能真的是一个单次播放的时间,例如一次重播,一次完整播放等

1. 时钟提供者

为何存在这个?因为有些视音频文件必须按照媒体自己的时间来走,而不是系统的时间频率。

2. 时钟使用者

管道会有一个时钟,然后给其他时钟使用者使用,时钟使用者应该确保回放的东西跟得上时钟。一般是要等待一个时间,用gst_clock_id_wait函数,或者丢几帧数据。

参考插件编写指南吧。

5.5 动态修改参数

这个东西不知道是干嘛的。manual上说是在流时间里调整gobject的属性。

必须单独包含gstcontroller库和头文件。

而且还得初始化。

那怎么使用呢?

l         1 先选择需要操作的参数,gst_object_control_properties,得到一个controller对象

l         2 通过该对象,设置插值模式,用来计算中间态的值。

l         3 最后设置控制点,这是一个时间戳值,当时间到了,这个值就其激活。

还是不明白有啥用。

5.6 线程

使用队列单元?恩,内部应该就是一个线程安全的队列。

GST通过不同的队列单元,将管道分为不同的组。

线程调度如何做?有pushpull模式两种。如果单元支持随机seek

寥寥数语,怎么能说清楚呢?

5.7 自动plugging(自动加载插件)

就是想自动完成一些加载插件(生成合适单元)的工作,通过比较匹配视音频格式信息来完成。

如何匹配?用什么来描述匹配项呢?

1. MIME类型

这个是用来描述媒体信息的。

2. 如何工作

一般来说,一个管道刚开始的时候并不知道一个文件的MIME类型。 所以GST使用类型查找来探测MIME,这个typefinding是管道的一个组成部分,它从文件中读足够的数据直到它能探测为止。

怎么说呢?读一点数据给所有的插件(注册了支持typefind的插件),如果有哪个插件支持,则加载到管道中。

注意:这里谈的都是自动加载的,如果手动加载的话,应该事先就知道了。

插件如何实现?见manual吧。其实就是调用插件的一个特殊函数,判断是不是自己能支持的。

5.8 管道的高级管理

就是一些对其中传递的buffer进行中途监控的作用,难度相对比较大,等看完插件编写再说。

插件编写更实际点应该,现在看的都是云里雾里。

GST高级接口

6.1 高级播放接口

介绍两个高级点的播放接口,playbindecodebin

支持自动加载,列表播放,淡入淡出音轨等功能。这里不再详述。

6.2 XML

将管道的信息保存到XML,并可以从XML文件中获取管道信息,然后创建管道。

 

附录

7.1 好习惯

l         加入GstBus信息来获取错误等报告

l         检查GST函数返回值

l         解引用任何返回不是GLIB基本类型的对象(就是减少对象的引用计数)

l         用管道对象来管理管道的状态,外部不要自己维护一个状态变量。

7.2 调试

main可以设置-gst-debug=选项,然后传入gst_init中。

7.3 工具

几个工具还是比较有用的。

1 gst-launch

用来测试管道的。

2. gst-insepect

探查单元的各种信息用。

 

 

 

 

 

你可能感兴趣的:(Gstreamer应用程序指南学习笔记)