Custom Audio Track - Flutter

We have introduced the ability to pass a custom Audio track for the Audio of the participants. This feature can be used to add custom layers like background noise removal, echo cancellation, etc. on audio and send it to other participants.

Creating a Custom Audio Track

• You can create a Audio Track using createMicrophoneAudioTrack() method of VideoSDK class.
• This method can be used to create audio track using different encoding parameters and noise cancellation configuration.

Parameters

• microphoneId:

  • type: String
  • required: false
  • It will be the id of the mic from which the audio should be captured.

• encoderConfig:

  • type: CustomTrackAudioConfig
  • required: false
  • default: speech_standard
  • Allowed values : speech_low_quality | speech_standard | music_standard | standard_stereo | high_quality | high_quality_stereo
  • It will be the encoder configuration you want to use for Audio Track.

• noiseConfig

  • echoCancellation

    • type: boolean
    • required: false
    • If true echo cancellation will turned on else it would be turned off.

  • autoGainControl

    • type: boolean
    • required: false
    • If true auto gain will turned on else it would be turned off.

  • noiseSuppression

    • type: boolean
    • required: false
    • If true noise suppression will turned on else it would be turned off.

Returns

• Future<CustomTrack>

Example

CustomTrack audioTrack = await VideoSDK.createMicrophoneAudioTrack(
        encoderConfig: CustomAudioTrackConfig.high_quality);

Using Custom Audio Track

Custom Track while initializing the meeting

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

CustomTrack audioTrack = await VideoSDK.createMicrophoneAudioTrack(
        encoderConfig: CustomAudioTrackConfig.high_quality);

Room room = VideoSDK.createRoom(
      roomId: widget.meetingId,
      token: widget.token,
      displayName: widget.displayName,
      micEnabled: widget.micEnabled,
      camEnabled: widget.camEnabled,
      maxResolution: 'hd',
      defaultCameraIndex: 1,
      multiStream: false,

      // Pass the custom track here
      customMicrophoneAudioTrack: audioTrack, // custom audio track :: optional
      notification: const NotificationInfo(
        title: "Video SDK",
        message: "Video SDK is sharing screen in the meeting",
        icon: "notification_share", // drawable icon name
      ),
    );

Custom Track with unmuteMic()

In order to switch tracks during the meeting, you have to pass the CustomTrack in the room.unmuteMic() method.

note

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

CustomTrack audioTrack = await VideoSDK.createMicrophoneAudioTrack(
        encoderConfig: CustomAudioTrackConfig.high_quality);

room.unmuteMic(customTrack);