设置音频编码属性

  • Flutter

更新时间

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

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

技术原理

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

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

前提条件

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

实现方法

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

一对一互动教学

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

Dart
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context;
context.audioScenario = AudioScenarioType.audioScenarioDefault;
await rtcEngine.initialize(context);

// 设置音频编码属性
await rtcEngine.setAudioProfile(AudioProfileType.audioProfileDefault);

KTV

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

Dart
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context;
context.audioScenario = AudioScenarioType.audioScenarioGameStreaming;
await rtcEngine.initialize(context);

// 设置音频编码属性
await rtcEngine.setAudioProfile(AudioProfileType.audioScenarioGameStreaming);

语音电台

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

Dart
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context;
context.audioScenario = AudioProfileType.audioScenarioChorus;
await rtcEngine.initialize(context);

// 设置音频编码属性
await rtcEngine.setAudioProfile(AudioProfileType.audioScenarioChorus);

音乐教学

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

Dart
// 在初始化 IRtcEngine 实例时,设置音频应用场景
RtcEngineContext context;
context.audioScenario = AudioProfileType.audioScenarioMeeting;
await rtcEngine.initialize(context);

// 设置音频编码属性
await rtcEngine.setAudioProfile(AudioProfileType.audioScenarioMeeting);

参考信息

注意事项

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

相关文档

API 参考