简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮点击获取二维码文章目录1.前言2.应用场景和用法2.1单独控制静音状态2.2函数原型与返回语义3.调用流程剖析3.1把布尔值写入mute属性3.2元素在音频处理路径应用静音4.实战案例4.1创建音量元素并设置原始增益4.2静音后读取两个属性4.3完整代码5.总结1.前言本篇目的理解gst_stream_volume_set_mute()如何通过GstStreamVolume对象的mute属性设置静音状态并区分静音与音量增益。音量增益和静音是两个独立控制项。音量增益描述样本缩放比例静音描述是否关闭当前音频输出。gst_stream_volume_set_mute()只设置对象的mute属性不修改volume属性。对象对应的音频元素负责在实际处理样本时应用静音状态。应用提供静音状态gst_stream_volume_set_mute设置对象mute属性GstStreamVolume实现对象音频处理路径应用静音2.应用场景和用法2.1单独控制静音状态播放界面的静音按钮可以调用gst_stream_volume_set_mute()切换静音状态。取消静音时元素仍可使用原有音量增益不需要应用重新恢复音量值。这一点可以避免把“静音”实现成将音量设置为0.0。如果只把音量设为零应用还需要另行记住静音前的音量并在取消静音时恢复。2.2函数原型与返回语义voidgst_stream_volume_set_mute(GstStreamVolume*volume,gboolean mute);参数含义volume实现GstStreamVolume的对象muteTRUE表示静音FALSE表示取消静音该函数没有返回值。它检查对象接口后使用g_object_set()写入mute属性。调用本身不修改音频Buffer也不保证任何对象正在播放。相邻接口的职责如下接口职责gst_stream_volume_set_mute()设置静音属性gst_stream_volume_get_mute()读取静音属性gst_stream_volume_set_volume()设置音量增益属性音频元素处理函数根据属性对样本应用增益或静音3.调用流程剖析3.1把布尔值写入mute属性实现逻辑很直接g_return_if_fail(GST_IS_STREAM_VOLUME(volume));g_object_set(volume,mute,mute,NULL);接口不维护单独的静音状态也没有独立的硬件静音调用。它把控制值交给实现对象的GObject属性。因此使用前应确认目标对象实现了GstStreamVolume。如果需要让静音影响真实PCM输出目标对象还必须在自身的数据处理路径中使用该属性。3.2元素在音频处理路径应用静音以volume元素为例它分别保存mute和volume属性。更新内部处理状态时如果mute为真元素会把当前处理增益设置为零原有volume属性仍然保留。取消静音后处理状态可以回到该属性表示的增益。是否应用调用静音接口写入mute属性volume属性保留原值音频元素更新处理状态mute是否开启当前样本输出静音按volume增益处理4.实战案例4.1创建音量元素并设置原始增益创建volume元素后先把线性增益设为0.4。这个值代表当前音量属性后续静音操作不会用零覆盖它。4.2静音后读取两个属性调用gst_stream_volume_set_mute()开启静音再分别读取mute和volume。预期静音状态为真线性增益仍为0.4。4.3完整代码#includegst/gst.h#includegst/audio/audio.h#includemath.hintmain(intargc,char*argv[]){GstElement*element;gdouble linear_volume;gboolean mute;gst_init(argc,argv);elementgst_element_factory_make(volume,NULL);if(elementNULL||!GST_IS_STREAM_VOLUME(element)){if(element)gst_object_unref(element);return1;}/* 设置一份非零音量便于验证静音不会改写volume属性 */gst_stream_volume_set_volume(GST_STREAM_VOLUME(element),GST_STREAM_VOLUME_FORMAT_LINEAR,0.4);/* 静音只改变mute属性 */gst_stream_volume_set_mute(GST_STREAM_VOLUME(element),TRUE);mutegst_stream_volume_get_mute(GST_STREAM_VOLUME(element));linear_volumegst_stream_volume_get_volume(GST_STREAM_VOLUME(element),GST_STREAM_VOLUME_FORMAT_LINEAR);g_assert(mute);g_assert(fabs(linear_volume-0.4)0.000001);/* 取消静音时保留的volume属性仍可供元素使用 */gst_stream_volume_set_mute(GST_STREAM_VOLUME(element),FALSE);gst_object_unref(element);return0;}5.总结gst_stream_volume_set_mute()通过设置对象的mute属性控制静音状态并把样本处理留给实现该接口的音频元素。