本文为您介绍extras参数配置的说明、使用场景和实现方式。
功能说明
extras字符配置的功能列表如下表所示。
| 参数 | 功能描述 | 取值 | 适用平台 |
|---|---|---|---|
| user_specified_aec | 音频3A：回声消除。 | TRUE：开启，FALSE：关闭 | Android、iOS、Mac、Windows |
| user_specified_ans | 音频3A：自动降噪。 | TRUE：开启，FALSE：关闭 | Android、iOS、Mac、Windows |
| user_specified_agc | 音频3A：自动增益。 | TRUE：开启，FALSE：关闭 | Android、iOS、Mac、Windows |
| user_specified_engine_mode | 音质模式。 | 音质模式取值 | Android、iOS、Mac、Windows |
| user_specified_scene_mode | 场景模式。 | 场景模式取值 | Android、iOS、Mac、Windows |
| user_specified_video_preprocess | 使用三方美颜处理视频。 | TRUE：开启，FALSE：关闭 | Android、iOS |
| user_specified_groupid | 1对1模式。 | 1v1 | Android、iOS、Mac、Windows |
音频3A
使用场景
- 当移动端（Android和iOS）硬件效果不满足要求时，可以将这三个开关均设置为TRUE，表示启用阿里云RTC提供的软件音频处理算法。能达到效果与音乐模式或媒体模式一样。
- 当PC端或移动端有外接声卡设备，而且声卡设备自带音频信号处理功能时，为保真音质，建议手动将相关功能设置为FALSE。
- 如果不设置任何3A参数，即表示不激活3A开关的功能，系统会按照当前选择的模式（默认模式，音乐模式等）运行。
实现方式
JsonObject jsonObject = new JsonObject();
jsonObject.put("user_specified_aec","TRUE");
jsonObject.put("user_specified_ans","TRUE");
jsonObject.put("user_specified_agc","TRUE");
AliRtcEngine engine= AliRtcEngine.getInstance(context, jsonObject.toString());音质模式与场景模式
功能说明
- 在一些比较专业的场景里，用户对声音的效果需求很高。阿里云RTC提供多种组合方案。
- 开发者根据对音质、场景等的不同需求，自由定制不同的音频属性，获得最佳实时互动效果。
模式说明
- 音质模式
音质模式值列举 模式名称 声道数 采样率 编码码率 ENGINE_LOW_QUALITY_MODE 低音质模式 1 8 kHz 12 Kbps ENGINE_BASIC_QUALITY_MODE 标准音质模式 1 16 kHz 24 Kbps ENGINE_HIGH_QUALITY_MODE 高音质模式 1 48 kHz 48 Kbps - 场景模式
场景模式值列举 场景名称 特性 SCENE_DEFAULT_MODE 默认场景 一般的音视频通信场景推荐使用。 SCENE_EDUCATION_MODE 教育场景 优先保证音频连续性与稳定性。 SCENE_MEDIA_MODE 媒体场景 保真人声与音乐音质，连麦直播间推荐使用。 SCENE_MUSIC_MODE 音乐场景 高保真音乐音质，乐器教学等对音乐音质有要求的场景推荐使用。
场景搭配示例
| 场景 | 音质模式 | 场景模式 | 特性 |
|---|---|---|---|
| 普通语音聊天室 | ENGINE_BASIC_QUALITY_MODE | SCENE_DEFAULT_MODE | 音质较好，优先保证通话质量，传输流畅。适用于对音质没有极致追求的场景。 |
| 语音教学小班课 | ENGINE_HIGH_QUALITY_MODE | SCENE_DEFAULT_MODE | 音质高清，优先保证通话质量，传输流畅。适用于对语音音质有极致追求的场景。 |
| 乐器教学小班课 | ENGINE_HIGH_QUALITY_MODE | SCENE_MUSIC_MODE | 音质高清，优先音乐质量，传输流畅。适用于对音乐音质有极致追求的场景。 |
| 直播连麦（语聊） | ENGINE_HIGH_QUALITY_MODE | SCENE_MEDIA_MODE | 传输流畅、音质高清，保证语音质量的同时，兼顾音乐音质。适用于既有语音又有音乐的聊天场景。 |
| 直播连麦（唱歌） | ENGINE_HIGH_QUALITY_MODE | SCENE_MUSIC_MODE | 传输流畅、音质高清，优先音乐质量，配合提供的各种音效。适用于唱歌乐器弹奏为主的场景。 |
| 小型穿戴设备（如电话手表） | ENGINE_LOW_QUALITY_MODE | SCENE_DEFAULT_MODE | 传输流畅、音质较好，优先保证语音可听可懂，功耗低。 |
实现方式
JsonObject jsonObject = new JsonObject();
//开启音乐场景下高音质模式
jsonObject.put("user_specified_engine_mode","ENGINE_HIGH_QUALITY_MODE");
jsonObject.put("user_specified_scene_mode","SCENE_MUSIC_MODE");
AliRtcEngine engine= AliRtcEngine.getInstance(context, jsonObject.toString());使用三方美颜处理视频
功能说明
- 在接⼊前，我们需要在SDK的实例extra字段中添加开关：user_specified_video_preprocess：TRUE。
- 通常客户集成以后反馈⾃⼰能看到美颜，对⽅看不到，就是因为这个没有设置。
实现方式
JsonObject jsonObject = new JsonObject();
jsonObject.put("user_specified_video_preprocess","TRUE");
AliRtcEngine engine= AliRtcEngine.getInstance(context, jsonObject.toString());1对1模式
1对1模式自动推流，只推相机大流，不推次要相机流。
场景描述
随着近些年音视频的应用越来越广泛，衍生了多样的在线教育、实时通信等场景。在教育场景下1对1指导更是广泛使用。下面是一些典型的1对1场景。 例如：1对1线上课外辅导、1对1线上语言教学、1对1线上音乐陪练和1对1线上面试等。
实现方式
JsonObject jsonObject = new JsonObject();
jsonObject.put("user_specified_groupid","1v1");
AliRtcEngine engine= AliRtcEngine.getInstance(context, jsonObject.toString());