不同的 app 需要设置不同的音频编码属性或应用场景。本文介绍如何使用声网 RTC SDK 在你的 app 中设置合适的音频编码属性和应用场景。
SDK 默认使用 AUDIO_PROFILE_DEFAULT
编码属性和 AUDIO_SCENARIO_DEFAULT
应用场景。如果默认设置无法满足你的需求,调用如下 API 设置音频编码属性和应用场景。
API | 描述 |
---|---|
create(config.mAudioScenario) |
在创建 RtcEngine 实例时,设置音频应用场景。默认值为 AUDIO_SCENARIO_DEFAULT 。 |
setAudioProfile(profile) |
在加入频道前后均可设置音频编码属性。 |
setAudioScenario |
在加入频道前后均可设置音频应用场景。 |
在实现设置音频编码属性和应用场景前,请确保已在你的项目中实现基本的实时音视频功能。详见开始视频通话或开始互动直播。
本节介绍如何为常见应用设置音频编码属性和应用场景。你可以将如下示例代码添加至你项目的 /app/java/com.example.<projectname>/MainActivity
文件中。
1 对 1 互动教学主要要求保证通话质量、传输流畅。在你的项目中添加如下代码:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.DEFAULT);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_DEFAULT);
该场景主要要求传输人声、无杂音、节省码率。声网推荐如下设置:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.CHATROOM);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_SPEECH_STANDARD);
该场景主要要求声音表现力好,上下麦时无音量、音质变化。声网推荐如下设置:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.CHATROOM);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_STANDARD);
KTV 主要要求高音质、对音乐和歌声的表现力好。在你的项目中添加如下代码:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.GAME_STREAMING);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_HIGH_QUALITY);
语音电台一般会使用专业的音频设备,主要要求高音质和立体声。在你的项目中添加如下代码:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.GAME_STREAMING);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO);
该场景主要要求高音质,支持将扬声器播放的音效传输到远端。声网推荐如下设置:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.GAME_STREAMING);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_STANDARD_STEREO);
该场景主要要求高音质,呈现丰富的声音效果,上下麦时无音量、音质变化。声网推荐如下设置:
// 在创建 RtcEngine 实例时,设置音频应用场景
config.mAudioScenario = Constants.AudioScenario.getValue(Constants.AudioScenario.CHATROOM);
engine = RtcEngine.create(config);
// 设置音频编码属性
RtcEngine.setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_STANDARD_STEREO);
本节提供在实现设置音频编码属性和应用场景时可能需要的文档。
声网在 GitHub 上提供已实现设置音频编码属性和应用场景功能的开源示例项目 SetAudioProfile。你可以下载体验并参考源代码。
create
[2/2]setAudioProfile
[2/2]setAudioScenario
音频应用场景会影响音量类型。不同音量类型直接的区别如下:
下表展示不同音频应用场景、用户角色、音频路由下 SDK 使用的音量类型。
在 AUDIO_SCENARIO_DEFAULT
音频应用场景下:
有线耳机 | 扬声器 | 听筒 | 蓝牙耳机 | |
---|---|---|---|---|
多主播(直播场景)或用户(通信场景) | 媒体音量 | 通话音量 | 通话音量 | 通话音量 |
单主播(直播场景) | 媒体音量 | 媒体音量 | 通话音量 | 通话音量 |
观众(直播场景) | 媒体音量 | 媒体音量 | 通话音量 | 媒体音量 |
在 AUDIO_SCENARIO_GAME_STREAMING
或 AUDIO_SCENARIO_CHORUS
音频应用场景下:
有线耳机 | 扬声器 | 听筒 | 蓝牙耳机 | |
---|---|---|---|---|
多主播(直播场景)或用户(通信场景) | 媒体音量 | 媒体音量 | 通话音量 | 通话音量 |
单主播(直播场景) | 媒体音量 | 媒体音量 | 通话音量 | 通话音量 |
观众(直播场景) | 媒体音量 | 媒体音量 | 通话音量 | 媒体音量 |
在 AUDIO_SCENARIO_CHATROOM
音频应用场景下:
有线耳机 | 扬声器 | 听筒 | 蓝牙耳机 | |
---|---|---|---|---|
多主播(直播场景)或用户(通信场景) | 媒体音量 | 通话音量 | 通话音量 | 通话音量 |
单主播(直播场景) | 媒体音量 | 通话音量 | 通话音量 | 通话音量 |
观众(直播场景) | 媒体音量 | 通话音量 | 通话音量 | 通话音量 |