Optimize Audio Track - Android

While optimizing for the best listening experience, it is necessary to fine-tune the audio track that is being used during the calls.

For the best fine-tuning experience, we have introduced the ability to pass a custom audio track for the participant's media before and during the meeting.

Custom Audio Track

This feature can be used to create a custom Audio track for the Audio of the participants with different encoder configuration and send it to other participants.

How to Create Custom Audio Track ?

• You can create a Audio Track using createAudioTrack() method of VideoSDK.

• This method can be used to create audio track using different encoding parameters.

Example

Kotlin

val audioCustomTrack: CustomStreamTrack = VideoSDK.createAudioTrack("speech_standard",this)
// `high_quality` | `music_standard`,  Default : `speech_standard`

Java

CustomStreamTrack audioCustomTrack=VideoSDK.createAudioTrack("speech_standard", this);
// `high_quality` | `music_standard`,  Default : `speech_standard`

• speech_standard : This config is optimised for normal voice communication.

• high_quality : This config is used for getting RAW audio, where you can apply your noiseConfig.

• music_standard : This config is optimised for communication, where sharing of musical notes such as songs or instrumental sounds, is important.

How to Setup Custom Audio Track ?

The custom track can be set up both before and after the initialization of the meeting.

1. Setting up a Custom Track during the initialization of a meeting
2. Setting up a Custom Track with methods

1. Setting up a Custom Track during the initialization of a meeting

If you are passing micEnabled: true in the initMeeting of VideoSDK and want to use custom tracks from start of the meeting, you can pass custom track in the initMeeting as shown below.

caution

Custom Track will not apply on micEnabled: false configuration.

Example

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  //..

  val customTracks: MutableMap<String, CustomStreamTrack> = HashMap()

  val audioCustomTrack: CustomStreamTrack = VideoSDK.createAudioTrack("high_quality", this)
  customTracks["mic"] = audioCustomTrack  //Key must be "mic"

  // create a new meeting instance
  val meeting = VideoSDK.initMeeting(
    this@MainActivity,meetingId,participantName,
    //MicEnabled , If true, it will use the passed custom track to turn mic on
    true,
    //WebcamEnabled
    true,
    //ParticipantId
    null,
    //Mode
    null,
    //MultiStream
    false,
    //Pass the custom tracks here
    customTracks,
    //MetaData
    null
  )
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  //..

  Map<String, CustomStreamTrack> customTracks = new HashMap<>();

  CustomStreamTrack audioCustomTrack = VideoSDK.createAudioTrack("high_quality", this);
  customTracks.put("mic", audioCustomTrack);  //Key must be "mic"

  // create a new meeting instance
  Meeting meeting = VideoSDK.initMeeting(
      MainActivity.this, meetingId, participantName,
      //MicEnabled , If true, it will use the passed custom track to turn mic on
      true,
      //WebcamEnabled
      true,
      //ParticipantId
      null,
      //Mode
      null,
      //MultiStream
      false,
      //Pass the custom tracks here
      customTracks,
      //MetaData
      null
  );
}

2. Setting up a Custom Track with methods

In order to switch tracks during the meeting, you have to pass the CustomStreamTrack in the unmuteMic() method of Meeting.

You can also pass custom track in changeMic() method of Meeting.

tip

Make sure to call muteMic() before you create a new track as it may lead to unexpected behavior.

Example

Kotlin

try {
  val audioCustomTrack: CustomStreamTrack = VideoSDK.createAudioTrack("high_quality", this)
  meeting!!.unmuteMic(audioCustomTrack)

  //or
  meeting!!.changeMic(AppRTCAudioManager.AudioDevice.BLUETOOTH, audioCustomTrack)
} catch (e: JSONException) {
  e.printStackTrace()
}

Java

try {
  CustomStreamTrack audioCustomTrack = VideoSDK.createAudioTrack("high_quality", this);
  meeting.unmuteMic(audioCustomTrack);

  //or
  meeting.changeMic(AppRTCAudioManager.AudioDevice.BLUETOOTH,audioCustomTrack);
}catch (JSONException e) {
  e.printStackTrace();
}

API Reference

The API references for all the methods and events utilised in this guide are provided below.

• Custom Audio Track