extras参数配置说明

使用场景

• 当移动端（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	音乐场景	高保真音乐音质，乐器教学等对音乐音质有要求的场景推荐使用。

场景搭配示例

实现方式

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());

实现方式

JsonObject jsonObject = new JsonObject();
jsonObject.put("user_specified_groupid","1v1");

AliRtcEngine engine= AliRtcEngine.getInstance(context, jsonObject.toString());