设置音频编码属性

  • Unity

更新时间

了解实时互动 RTC 在不同平台上的设置音频编码属性方式,包括接入流程、关键配置和平台差异。

不同的 App 需要设置不同的音频编码属性或应用场景。本文介绍如何使用声网 RTC SDK 在你的 App 中设置合适的音频编码属性和应用场景。

技术原理

SDK 默认使用 AUDIO_PROFILE_DEFAULT 编码属性和 AUDIO_SCENARIO_DEFAULT 应用场景。如果默认设置无法满足你的需求,调用如下 API 设置音频编码属性和应用场景。

API描述
Initialize(RtcEngineContext context)在创建 IRtcEngine 实例时,设置音频应用场景。默认值为 AUDIO_SCENARIO_DEFAULT。
SetAudioProfile(profile)在加入频道前后均可设置音频编码属性。
SetAudioScenario(scenario)在加入频道前后均可设置音频应用场景。
表格内容超出当前宽度,可横向滚动查看更多列。

前提条件

在实现设置音频编码属性和应用场景前,请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

本节介绍如何为常见应用设置音频编码属性和应用场景。你可以将如下示例代码添加至你的项目中。

一对一互动教学

一对一互动教学主要要求保证通话质量、传输流畅。在你的项目中添加如下代码:

C#
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context = new RtcEngineContext();
context.audioScenario = AUDIO_SCENARIO_TYPE.AUDIO_SCENARIO_DEFAULT
RtcEngine.Initialize(context);
 
// 设置音频编码属性
RtcEngine.SetAudioProfile(AUDIO_PROFILE_TYPE.AUDIO_PROFILE_DEFAULT);

KTV

KTV 主要要求高音质、对音乐和歌声的表现力好。在你的项目中添加如下代码:

C#
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context = new RtcEngineContext();
context.audioScenario = AUDIO_SCENARIO_TYPE.AUDIO_SCENARIO_GAME_STREAMING
RtcEngine.Initialize(context);
 
// 设置音频编码属性
RtcEngine.SetAudioProfile(AUDIO_PROFILE_TYPE.AUDIO_PROFILE_MUSIC_HIGH_QUALITY);

语音电台

语音电台一般会使用专业的音频设备,主要要求高音质和立体声。在你的项目中添加如下代码:

C#
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context = new RtcEngineContext();
context.audioScenario = AUDIO_SCENARIO_TYPE.AUDIO_SCENARIO_GAME_STREAMING
RtcEngine.Initialize(context);
 
// 设置音频编码属性
RtcEngine.SetAudioProfile(AUDIO_PROFILE_TYPE.AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO);

音乐教学

该场景主要要求高音质,支持将扬声器播放的音效传输到远端。声网推荐如下设置:

C#
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context = new RtcEngineContext();
context.audioScenario = AUDIO_SCENARIO_TYPE.AUDIO_SCENARIO_GAME_STREAMING
RtcEngine.Initialize(context);
 
// 设置音频编码属性
RtcEngine.SetAudioProfile(AUDIO_PROFILE_TYPE.AUDIO_PROFILE_MUSIC_STANDARD_STEREO);

参考信息

注意事项

由于 iOS 系统限制,部分音频路由在通话音量模式下无法识别。因此,如需使用外接声卡,建议将音频应用场景设置为高音质场景 AUDIO_SCENARIO_GAME_STREAMING(3)。在这种场景下,SDK 会切换到媒体音量规避该问题。

相关文档

API 参考