文档中心>实时互动-教育版>自定义界面功能>自定义功能>自定义移动端音量类型(Web 内核)

自定义移动端音量类型(Web 内核)

最近更新时间:2025-10-15 17:52:12

我的收藏
说明:
阅读本章节前,请确保您已经了解 快速开始 的内容。

功能描述

现代智能手机中通常都具备两套系统音量类型,即“通话音量”和“媒体音量”。通过自定义本功能,您可以选择当前 App 使用哪种音频通道。
通话音量:手机专为接打电话设计的音量类型,具备回声抵消(AEC)功能,支持通过蓝牙耳机上的麦克风进行拾音,但音质相对普通。
当用户通过手机侧面的音量按键调低音量时,如果无法将其调至零(也就是无法彻底静音),表明您的手机当前处于通话音量类型。
媒体音量:手机专为音乐场景设计的音量类型,无法使用系统的 AEC 功能,并且不支持通过蓝牙耳机的麦克风进行拾音,但具备更好的音乐播放效果。
当用户通过手机侧面的音量按键调低音量时,如果能够将手机音量调至彻底静音,表明您的手机当前处于媒体音量类型。
SDK 目前提供了三种系统音量类型的控制模式:
自动切换模式
全程通话音量模式
全程媒体音量模式
默认情况下,iOS 端使用自动切换模式,而 Android 端则采用全程媒体音量模式。

自定义方法

说明:
移动端 SDK 版本要求:
iOS 端:1.8.5.14及以上,可参见 集成文档
Android 端:1.8.19及以上,可参见 集成文档
在 JS 文件中 promiseState TCIC.TMainState.Joined_TRTC 设置为 true,即音视频初始化并进入完成后,再调用 TCIC.SDK.instance.setSystemVolumeType 方法配置系统音量类型。具体参数说明:
取值
描述
0
自动切换模式
1
全程媒体音量模式
2
全程通话音量模式
参考代码:
TCIC.SDK.instance.promiseState(TCIC.TMainState.Joined_TRTC, true)
.then(() => {
TCIC.SDK.instance.setSystemVolumeType(0);
});