手机的音量分为通话音量和媒体音量,互相独立,可分开控制。使用不同音量的通道分别被称为通话通道和媒体通道,具有不同的特点,你需要确保选择的通道能满足业务场景的要求。其差异点可参考下表。
| 音量类型 | 作用 | 特点 | 操作系统的音频模式 |
|---|---|---|---|
| 通话音量 | 通常用于控制通话时的音量大小。 |
| |
| 媒体音量 | 通常用于控制游戏、音乐、影片或系统输出的声音。 |
|
|
RTC SDK 在移动端上提供了不同的预设音频场景类型,包括音乐场景、纯通话音量场景、游戏媒体场景等。以 Android 端为例,可调用 setAudioScenario 选择符合业务要求的音频场景。自 3.60 版本起,不同的音频场景和通话音量/媒体音量的对应关系如下:
| 音频场景 | 音频路由 | 房间中多个音频发布者中的一个 | 房间内唯一的音频发布者 | 房间内仅收听不发布的用户 | ||
|---|---|---|---|---|---|---|
| 关采集 | 开采集 | 关采集 | 开采集 | 关采集 | ||
【默认】DEFAULT(0) | 扬声器 | 媒体 | 通话 | 媒体 | 媒体 | 媒体 |
| 听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | |
CHATROOM(1) | 扬声器 | 通话 | 通话 | 通话 | 通话 | 通话 |
| 听筒 | 通话 | 通话 | 通话 | 通话 | 通话 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | |
GAMESTREAMING(2) | 扬声器 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | |
CHORUS(3) | 扬声器 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | |
| 音频场景 | 音频路由 | 房间中多个音频发布者中的一个 | 房间内唯一的音频发布者 | 房间内仅收听不发布的用户 | ||
|---|---|---|---|---|---|---|
| 关采集 | 开采集 | 关采集 | 开采集 | 关采集 | ||
【默认】ByteRTCAudioScenarioTypeDefault = 0 | 扬声器 | 媒体 | 通话 | 媒体 | 媒体 | 媒体 |
| 听筒 | 媒体 | 通话 | 媒体 | 媒体 | 媒体 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | |
ByteRTCAudioScenarioTypeChatRoom = 1 | 扬声器 | 通话 | 通话 | 通话 | 通话 | 通话 |
| 听筒 | 通话 | 通话 | 通话 | 通话 | 通话 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 通话 | 通话 | 通话 | 通话 | 通话 | |
ByteRTCAudioScenarioTypeGameStreaming = 2 | 扬声器 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 听筒 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
ByteRTCAudioScenarioTypeChorus = 3 | 扬声器 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 听筒 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
| 蓝牙耳机 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | |
由于两者的音量独立控制,在切换时,如果音量档位差距较大时,对收听者来说,音频突然变得大声。即,音量突变现象。不同音频场景下,用户使用不同音频设备进行开麦、闭麦时,可能会应用不同的音量模式,参看 AudioScenarioType。如果业务场景中,用户需要频繁开麦、闭麦,应优先选择闭麦和开麦时使用相同模式的场景,例如高质量畅聊场景。
同一时刻,音频输入和输出必须同一模式。例如,不会出现输入是通话模式,输出是媒体模式的情况。
我们在 Native SDK V3.60 版本中,对各音频场景进行了升级。在此前版本中,音量模式由音频场景、音频路由和用户是否开启音频采集来决定。升级后,用户角色也将影响实际音量模式。用户角色包括:
如果你需要升级到 V3.60 版本,参考下表,以确认升级后各种场景下的音量模式符合预期。升级到 V3.60 后的差异,已通过加粗字体标识。
未使用 setAudioScenario 设置音频场景时,参见默认场景下的音量模式。
| 3.58 及之前版本 | 音频路由 | 3.60 及之后版本 | |||||||
|---|---|---|---|---|---|---|---|---|---|
| 音频场景 | 关采集 | 开采集 | 音频场景 | 房间中多个音频发布者中的一个 | 房间内唯一的音频发布者 | 房间内仅收听不发布的用户 | |||
| 关采集 | 开采集 | 关采集 | 开采集 | 关采集 | |||||
【默认】AUDIO_SCENARIO_MUSIC(0) | 媒体 | 通话 | 内置扬声器 | 【默认】DEFAULT(0) | 媒体 | 通话 | 媒体 | 媒体 | 媒体 |
| 通话 | 通话 | 内置听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
AUDIO_SCENARIO_HIGHQUALITY_COMMUNICATION(1) | 媒体 | 通话 | 内置扬声器 | DEFAULT(0) | 媒体 | 通话 | 媒体 | 媒体 | 媒体 |
| 通话 | 通话 | 内置听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
AUDIO_SCENARIO_COMMUNICATION(2) | 通话 | 通话 | 内置扬声器 | CHATROOM(1) | 通话 | 通话 | 通话 | 通话 | 通话 |
| 通话 | 通话 | 内置听筒 | 通话 | 通话 | 通话 | 通话 | 通话 | ||
| 通话 | 通话 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
AUDIO_SCENARIO_MEDIA(3) | 媒体 | 媒体 | 内置扬声器 | GAMESTREAMING(2) | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 通话 | 通话 | 内置听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
AUDIO_SCENARIO_GAME_STREAMING(4) | 媒体 | 媒体 | 内置扬声器 | GAMESTREAMING(2) | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 通话 | 通话 | 听筒 | 通话 | 通话 | 媒体 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
AUDIO_SCENARIO_HIGHQUALITY_CHAT(5) | 通话 | 通话 | 内置扬声器 | CHATROOM(1) | 通话 | 通话 | 通话 | 通话 | 通话 |
| 通话 | 通话 | 听筒 | 通话 | 通话 | 通话 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
| 3.58 及之前版本 | 音频路由 | 3.60 及之后版本 | |||||||
|---|---|---|---|---|---|---|---|---|---|
| 音频场景 | 关采集 | 开采集 | 音频场景 | 房间中多个音频发布者中的一个 | 房间内唯一的音频发布者 | 房间内仅收听不发布的用户 | |||
| 关采集 | 开采集 | 关采集 | 开采集 | 关采集 | |||||
【默认】ByteRTCAudioScenarioMusic = 0 | 媒体 | 通话 | 内置扬声器 | 【默认】ByteRTCAudioScenarioTypeDefault = 0 | 媒体 | 通话 | 媒体 | 媒体 | 媒体 |
| 媒体 | 通话 | 内置听筒 | 媒体 | 通话 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
ByteRTCAudioScenarioHighqualityCommunication = 1 | 媒体 | 通话 | 内置扬声器 | ByteRTCAudioScenarioTypeDefault = 0 | 媒体 | 通话 | 媒体 | 媒体 | 媒体 |
| 媒体 | 通话 | 内置听筒 | 通话 | 通话 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 媒体 | 通话 | 媒体 | 通话 | 媒体 | ||
ByteRTCAudioScenarioCommunication = 2 | 通话 | 通话 | 内置扬声器 | ByteRTCAudioScenarioTypeChatRoom = 1 | 通话 | 通话 | 通话 | 通话 | 通话 |
| 通话 | 通话 | 内置听筒 | 通话 | 通话 | 通话 | 通话 | 通话 | ||
| 通话 | 通话 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 通话 | 通话 | 通话 | 通话 | 通话 | ||
ByteRTCAudioScenarioMedia = 3 | 媒体 | 媒体 | 内置扬声器 | ByteRTCAudioScenarioTypeGameStreaming = 2 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 媒体 | 媒体 | 内置听筒 | 媒体 | 媒体 | 媒体 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 蓝牙耳机 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
ByteRTCAudioScenarioGameStreaming = 4 | 媒体 | 媒体 | 内置扬声器 | ByteRTCAudioScenarioTypeGameStreaming = 2 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 |
| 媒体 | 媒体 | 听筒 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
ByteRTCAudioScenarioHighqualityChat = 5 | 通话 | 通话 | 内置扬声器 | ByteRTCAudioScenarioTypeChatRoom = 1 | 通话 | 通话 | 通话 | 通话 | 通话 |
| 通话 | 通话 | 听筒 | 通话 | 通话 | 通话 | 通话 | 通话 | ||
| 媒体 | 媒体 | 有线耳机/ USB 耳机/ 外置声卡 | 媒体 | 媒体 | 媒体 | 媒体 | 媒体 | ||
| 通话 | 通话 | 蓝牙耳机 | 通话 | 通话 | 通话 | 通话 | 通话 | ||