Manage Audio and Video Devices - Android

This feature allows hosts to switch their microphone, speaker, or camera devices during a live stream. Only hosts (in SEND_AND_RECV mode) can change input/output devices, ensuring they maintain control over their audio and video quality, while audience members (in RECV_ONLY mode) continue to receive the broadcast seamlessly.

Changing Input/Output Audio Device

getMics()

• This method of the Meeting class provides a list of all available microphones, which can be shown in a dropdown for selection.

• It returns an array of objects, each containing a deviceId and a label representing an audio input device.

changeMic()

• Participant can change the audio device using changeMic(AppRTCAudioManager.AudioDevice device) method of Meeting class.

• Parameters that can be passed to changeMic are

  Audio Devices	Usage
  AppRTCAudioManager.AudioDevice.BLUETOOTH	For Bluetooth Device.
  AppRTCAudioManager.AudioDevice.WIRED_HEADSET	For Wired Handset Device.
  AppRTCAudioManager.AudioDevice.SPEAKER_PHONE	For Inbuilt - Speaker Device
  AppRTCAudioManager.AudioDevice.EARPIECE	For Earpiece Device

• When participant changes the Mic, AppRTCAudioManager.AudioManagerEvents() is triggered which can be set to Meeting class by using setAudioDeviceChangeListener().

Example

Kotlin

private fun getMics(): MutableSet<AppRTCAudioManager.AudioDevice>? {
  val mics = liveStream!!.mics
  return mics  // returns all connected mics
}

btnChangeMic!!.setOnClickListener { _: View? ->
  // Change Mic during Meeting
  liveStream!!.changeMic(AppRTCAudioManager.AudioDevice.BLUETOOTH)
}

private fun setAudioDeviceListeners() {
  liveStream!!.setAudioDeviceChangeListener(object : AudioManagerEvents {
    override fun onAudioDeviceChanged(
      selectedAudioDevice: AppRTCAudioManager.AudioDevice,
      availableAudioDevices: Set<AppRTCAudioManager.AudioDevice>
    ) {
      when (selectedAudioDevice) {
        AppRTCAudioManager.AudioDevice.BLUETOOTH ->
          Toast.makeText(this@MainActivity, "Selected AudioDevice: BLUETOOTH", Toast.LENGTH_SHORT).show()

        AppRTCAudioManager.AudioDevice.WIRED_HEADSET ->
          Toast.makeText(this@MainActivity, "Selected AudioDevice: WIRED_HEADSET", Toast.LENGTH_SHORT).show()

        AppRTCAudioManager.AudioDevice.SPEAKER_PHONE ->
          Toast.makeText(this@MainActivity, "Selected AudioDevice: SPEAKER_PHONE", Toast.LENGTH_SHORT).show()

        AppRTCAudioManager.AudioDevice.EARPIECE ->
          Toast.makeText(this@MainActivity, "Selected AudioDevice: EARPIECE", Toast.LENGTH_SHORT).show()
      }
    }
  })
}

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

Java

private Set<AppRTCAudioManager.AudioDevice> getMics() {
  Set<AppRTCAudioManager.AudioDevice> mics = liveStream.getMics();
  return mics; // returns all connected mics
}

btnChangeMic.setOnClickListener(new View.OnClickListener() {
  @Override
  public void onClick(View v) {
    // Change Mic during liveStream
    liveStream.changeMic(AppRTCAudioManager.AudioDevice.BLUETOOTH);
  }
});

private void setAudioDeviceListeners() {
  liveStream.setAudioDeviceChangeListener(new AppRTCAudioManager.AudioManagerEvents() {
    @Override
    public void onAudioDeviceChanged(AppRTCAudioManager.AudioDevice selectedAudioDevice, Set<AppRTCAudioManager.AudioDevice> availableAudioDevices) {
      switch (selectedAudioDevice) {
        case BLUETOOTH:
          Toast.makeText(MainActivity.this, "Selected AudioDevice: BLUETOOTH", Toast.LENGTH_SHORT).show();
          break;
        case WIRED_HEADSET:
          Toast.makeText(MainActivity.this, "Selected AudioDevice: WIRED_HEADSET", Toast.LENGTH_SHORT).show();
          break;
        case SPEAKER_PHONE:
          Toast.makeText(MainActivity.this, "Selected AudioDevice: SPEAKER_PHONE", Toast.LENGTH_SHORT).show();
          break;
        case EARPIECE:
          Toast.makeText(MainActivity.this, "Selected AudioDevice: EARPIECE", Toast.LENGTH_SHORT).show();
          break;
      }
    }
  });
}

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

• To use Bluetooth device, you must declare BLUETOOTH permission in AndroidManifest.xml file.

<manifest ... >
//...
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
</manifest>

Changing Camera Input Device

changeWebcam()

• To change the camera device of the host, you need to call changeWebcam() method.

Example

Kotlin

  btnWebcam!!.setOnClickListener {
    // Change Webcam during liveStream
    liveStream!!.changeWebcam()
  }

Java

  btnWebcam.setOnClickListener(new View.OnClickListener() {
      @Override
      public void onClick(View v) {
        // Change Webcam during liveStream
        liveStream.changeWebcam();
      }
  });

API Reference

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

• getMics()
• changeMic()
• changeWebcam()