)
★ FEATURED ARTICLE 简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮文章目录1.前言2.应用场景和用法2.1保存每个输入Pad的音频格式2.2函数原型与状态变化3.调用流程剖析3.1从输入Caps处理函数进入Pad信息更新3.2在Pad锁内更新GstAudioInfo4.实战案例4.1准备interleave和请求Pad4.2调用接口并检查Pad信息4.3完整代码5.总结1.前言本篇目的理解gst_audio_aggregator_set_sink_caps()如何把输入Caps解析成GstAudioAggregatorPad的音频信息并梳理它在interleave接收端Caps处理中的位置。聚合类音频元素需要知道每个Sink Pad收到的音频格式后续才能按Pad的格式处理输入数据。gst_audio_aggregator_set_sink_caps()负责把Caps解析并写入指定Pad的info字段。它不负责Caps协商也不负责检查不同输入Pad的格式是否兼容。Sink Pad收到Caps元素检查Caps有效性gst_audio_aggregator_set_sink_caps解析Caps并更新Pad音频信息聚合流程读取Pad信息2.应用场景和用法2.1保存每个输入Pad的音频格式GstAudioAggregatorPad包含一个GstAudioInfo成员用于记录这个输入Pad当前对应的音频格式。gst_audio_aggregator_set_sink_caps()把Caps转换成该成员供聚合器后续读取。场景调用前的处理调用后的作用interleave收到输入Caps检查音频格式是否有效保存Pad的采样率、声道数和格式聚合器准备处理输入Buffer已有Pad级音频信息按Pad格式解释输入数据输入格式变化元素确认新Caps可以接受更新Pad的音频信息自定义GstAudioAggregator子类确认Caps与自身策略兼容将输入Caps写入聚合Pad状态不能把这个接口当作Caps协商入口。它不会向上游查询Caps也不会决定Src Pad输出Caps。调用者应先检查Caps再调用此函数。2.2函数原型与状态变化函数原型如下voidgst_audio_aggregator_set_sink_caps(GstAudioAggregator*aagg,GstAudioAggregatorPad*pad,GstCaps*caps);参数含义aagg所属的GstAudioAggregator对象pad需要更新音频信息的聚合器Sink Padcaps描述该Pad输入音频格式的Caps函数返回类型为void。它会锁定Pad对象调用gst_audio_info_from_caps()解析Caps并写入pad-info随后解锁。在启用断言的构建中解析结果会通过g_assert()检查。禁用断言时函数仍然尝试解析但不处理失败结果。因此调用者需要在调用前确保Caps有效。函数本身不返回成功或失败状态。相邻接口的职责不同接口或操作职责gst_audio_info_from_caps()将Caps解析成GstAudioInfogst_audio_aggregator_set_sink_caps()将解析结果写入聚合器Pad的info字段聚合器的Caps处理函数检查输入Caps是否符合元素策略聚合器输出Caps协商确定Src Pad对下游提供的格式3.调用流程剖析3.1从输入Caps处理函数进入Pad信息更新gst_audio_aggregator_set_sink_caps()在gstaudioaggregator.c中实现。一个实际调用者是GstAudioInterleave的Sink Pad Caps处理路径。interleave先用gst_audio_info_from_caps()解析输入Caps并检查输入格式以及它与已有Sink Pad格式的关系。通过这些检查后才调用gst_audio_aggregator_set_sink_caps()更新对应Pad的信息。否是interleave收到Sink Caps解析并检查音频格式Caps符合元素策略拒绝本次Caps处理更新interleave内部状态调用聚合器Pad信息接口Pad保存GstAudioInfo调用者的预检查很重要interleave可能需要确保多个Sink Pad的输入格式能用于同一个输出格式。这个策略由元素自身完成不是gst_audio_aggregator_set_sink_caps()完成。3.2在Pad锁内更新GstAudioInfo函数的主体只做一件事在Pad对象锁保护下解析Caps并更新pad-info。核心逻辑如下GST_OBJECT_LOCK(pad);validgst_audio_info_from_caps(pad-info,caps);g_assert(valid);GST_OBJECT_UNLOCK(pad);在禁用断言的编译分支中源码仍会执行gst_audio_info_from_caps()但会忽略布尔返回值。由于函数返回void调用者无法从函数返回值判断Caps解析结果。pad-info表示单个Sink Pad的输入格式。它不是聚合器的输出格式也不代表Caps已经成功发送给下游。输出格式仍由聚合器自己的Caps协商流程确定。4.实战案例4.1准备interleave和请求Pad本例创建interleave元素请求一个Sink Pad再准备一组合法的单声道S16LE音频Caps。这里直接调用gst_audio_aggregator_set_sink_caps()观察它对Pad音频信息的更新。这个最小例子只检查Pad字段不运行完整的音频聚合管线。4.2调用接口并检查Pad信息调用前先确认interleave元素和请求到的Sink Pad都创建成功。调用接口后在Pad对象锁内检查采样率、声道数和音频格式是否与Caps一致。Caps由调用者持有因此检查完成后由调用者释放。请求Pad也应通过元素释放再解除调用者持有的Pad引用。4.3完整代码#includegst/gst.h#includegst/audio/audio.hintmain(intargc,char*argv[]){GstElement*interleave;GstPad*sink_pad;GstCaps*caps;GstAudioAggregatorPad*audio_pad;gboolean valid;gst_init(argc,argv);/* 创建实际使用GstAudioAggregatorPad的interleave元素 */interleavegst_element_factory_make(interleave,NULL);if(interleaveNULL)return1;/* 请求一个聚合器Sink Pad */sink_padgst_element_request_pad_simple(interleave,sink_%u);if(sink_padNULL){gst_object_unref(interleave);return1;}/* 准备有效的单声道S16LE输入Caps */capsgst_caps_new_simple(audio/x-raw,format,G_TYPE_STRING,S16LE,rate,G_TYPE_INT,48000,channels,G_TYPE_INT,1,layout,G_TYPE_STRING,interleaved,NULL);audio_padGST_AUDIO_AGGREGATOR_PAD(sink_pad);/* 将Caps解析结果写入该Sink Pad的音频信息 */gst_audio_aggregator_set_sink_caps(GST_AUDIO_AGGREGATOR(interleave),audio_pad,caps);/* 按Pad对象锁要求读取公开的只读info字段 */GST_OBJECT_LOCK(audio_pad);validGST_AUDIO_INFO_FORMAT(audio_pad-info)GST_AUDIO_FORMAT_S16GST_AUDIO_INFO_RATE(audio_pad-info)48000GST_AUDIO_INFO_CHANNELS(audio_pad-info)1;GST_OBJECT_UNLOCK(audio_pad);/* 释放Caps、请求Pad和元素 */gst_caps_unref(caps);gst_element_release_request_pad(interleave,sink_pad);gst_object_unref(sink_pad);gst_object_unref(interleave);returnvalid?0:1;}5.总结gst_audio_aggregator_set_sink_caps()在Pad对象锁保护下把有效Caps解析为GstAudioInfo并保存到指定的GstAudioAggregatorPad中。
阅读完成 · 觉得有帮助？
