本文为您介绍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());