extras parameter configuration

Scenarios

• If the hardware audio processing on mobile devices (Android and iOS) does not meet your requirements, set all three parameters to TRUE. This enables the software audio processing algorithms provided by Alibaba Cloud RTC. The audio effect is the same as that in music mode or media mode.

• If a PC or mobile device is connected to an external sound card that has built-in audio signal processing, set the relevant parameters to FALSE to preserve the original audio quality.

• If you do not set any 3A parameters, the 3A features are not enabled. The SDK operates in the currently selected mode, such as default mode or music mode.

Implementation

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

Features

• For professional scenarios that require high-quality sound effects, Alibaba Cloud RTC provides multiple configuration combinations.

• Developers can customize audio properties for different audio quality requirements and scenarios to achieve an optimal real-time interactive experience.

Mode descriptions

• Audio quality mode

  Audio quality mode value	Mode name	Number of sound channels	Sample rate	Encoding bitrate
  ENGINE_LOW_QUALITY_MODE	Low quality mode	1	8 kHz	12 Kbps
  ENGINE_BASIC_QUALITY_MODE	Standard quality mode	1	16 kHz	24 Kbps
  ENGINE_HIGH_QUALITY_MODE	High quality mode	1	48 kHz	48 Kbps

• Scenario mode

  Scenario mode value	Scenario name	Attribute
  SCENE_DEFAULT_MODE	Default scenario	Recommended for general real-time communication scenarios.
  SCENE_EDUCATION_MODE	Education scenario	Prioritizes audio continuity and stability.
  SCENE_MEDIA_MODE	Media scenario	Preserves the quality of human voices and music. Recommended for co-streaming in live channels.
  SCENE_MUSIC_MODE	Music scenario	Provides high-fidelity music quality. Recommended for scenarios with high requirements for music quality, such as musical instrument instruction.

Example scenario combinations

Implementation

JsonObject jsonObject = new JsonObject();
// Enable high quality mode in a music scenario.
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());

Feature description

• Before integration, add the `user_specified_video_preprocess: TRUE` parameter to the `extras` field of the software development kit (SDK) instance.

• A common issue after integration is that the local user can see the retouching effect, but the remote user cannot. This issue occurs because this parameter is not set.

Implementation

JsonObject jsonObject = new JsonObject();
jsonObject.put("user_specified_video_preprocess","TRUE");

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

Implementation

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

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