多轨音量联动需通过继承访问器复用 RemoteAudioTrack/MicrophoneAudioTrack 的 setVolume(),构建非侵入式控制器批量调用并平滑过渡,同步系统音量,规避音频焦点打断。
通过继承的访问器属性实现多轨音量联动,核心在于利用父类已定义的
或
/
等访问器,让子类轨道对象共享或响应同一音量控制逻辑,而非各自独立维护音量状态。
复用 RemoteAudioTrack / MicrophoneAudioTrack 的 volume 访问器
RemoteAudioTrack 和 MicrophoneAudioTrack 均继承自基类(如 RemoteTrack / LocalAudioTrack),并公开了
、
或类似访问器(部分 SDK 也支持直接读写
属性)。这些方法底层通常操作的是音频节点增益(gain node)或混音权重,具备可覆盖与统一调度的基础。
确认 SDK 版本 ≥ 3.0.0 —— 此版本起
和
在两类轨道中均已稳定支持
避免直接修改
或
来模拟音量变化,它们控制通断,不参与幅度缩放
若需统一调节远端人声 + 本地麦克风 + 背景音乐三轨,可将它们的
封装进一个控制器方法中
构建音量联动控制器(非侵入式)
不修改原始轨道类,而是创建一个轻量级控制器,持有多条轨道引用,并在设置主音量时批量调用其访问器:
JQ仿视频播放器图片浏览幻灯片代码
JQ仿视频播放器图片浏览幻灯片代码是一款jQuery实现的类似播放器播放的图片切换代码,包括重播,暂停,调速度,跳到多少页。
下载
初始化时收集所有需联动的轨道实例,例如:
提供
方法,遍历列表并执行
为避免突变失真,可加入平滑过渡:对每个 track 调用
前先读取当前值,再线性插值更新
注意:RemoteAudioTrack 的
影响播放端输出;MicrophoneAudioTrack 的同名方法影响采集后推流前的增益,二者作用域不同但可协同
处理系统音量与应用音量的层级关系
联动仅作用于应用内轨道,还需与系统级音量对齐,否则用户调系统音量键时 UI 不同步:
在 Android 上监听
音量变化,触发控制器的
在 HarmonyOS 上通过 Audio Kit 的
获取当前媒体流音量,并映射到 0–1 区间供控制器使用
建议将系统音量作为“基准”,应用内联动音量作为“偏移倍率”,最终播放增益 = 系统音量 × 应用音量,实现自然叠加
规避打断策略导致的音量失效
在 HarmonyOS 或 Android 多音频并发场景下,某轨可能因失去音频焦点被系统静音或降音,此时调用
仍成功但无实际效果:
监听
(HarmonyOS)或
(Android),在收到
类型事件时,主动重置该轨音量或提示用户
对于 SHARE_MODE 模式下的多轨,确保它们共用同一 AVSession 或 AudioRenderer 实例,使系统将其视为逻辑整体,减少被单独打断概率
调试时可通过
辅助判断:若返回值正常但听不到声音,大概率是焦点或路由问题,而非音量设置失败
volumegetVolume()setVolume()getVolume()setVolume()volumegetVolume()setVolume()isPlayingmutedsetVolume()[user1.audioTrack, localMicTrack, bgmPlayer.getAudioTrack()]setMasterVolume(value: number)track.setVolume(value)setVolume()setVolume()AudioManager.STREAM_MUSICsyncToSystemVolume()getVolume()setVolume()InterruptEventOnAudioFocusChangeListenerINTERRUPT_FORCEgetVolumeLevel()