Selbstverwaltete Anrufe im Audio-Manager

In diesem Leitfaden geht es um Kommunikationsanwendungen wie Voice over Internet Protocol (VoIP), die ihren Audio- und Kopfhörerstatus selbst verwalten möchten.

Audio-Callback registrieren

Erstelle zuerst einen AudioDeviceCallback, der deine App benachrichtigt, wenn Audiogeräte mit dem Gerät verbunden oder davon getrennt werden.

Kotlin

val audioDeviceCallback: AudioDeviceCallback = object : AudioDeviceCallback() {
  override fun onAudioDevicesAdded(addedDevices: Array<AudioDeviceInfo>) {}
  override fun onAudioDevicesRemoved(removedDevices: Array<AudioDeviceInfo>) {}
}

audioManager.registerAudioDeviceCallback(audioDeviceCallback)

Java

final AudioDeviceCallback audioDeviceCallback = new AudioDeviceCallback() {
  @Override
  public void onAudioDevicesAdded(AudioDeviceInfo[] addedDevices) {
  }

  @Override
  public void onAudioDevicesRemoved(AudioDeviceInfo[] removedDevices) {
    // Handle device removal
  }
};

audioManager.registerAudioDeviceCallback(audioDeviceCallback);

Nach aktivem Kommunikationsgerät suchen

Im Audiomanager siehst du, welches Kommunikationsgerät gerade aktiv ist.

Kotlin

val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice

Java

AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();

Wenn deine App auf Änderungen am Kommunikationsgerät wartet, kann sie erkennen, wann das Routing angewendet wird und das ausgewählte Gerät aktiv ist.

Kotlin

val listener =
  OnCommunicationDeviceChangedListener { device -> // Handle changes
    currentCommunicationDevice = device
  }
audioManager.addOnCommunicationDeviceChangedListener(executor, listener)

Java

AudioManager.OnCommunicationDeviceChangedListener listener =
      new AudioManager.OnCommunicationDeviceChangedListener() {
  @Override
  void onCommunicationDeviceChanged(AudioDeviceInfo device) {
      // Handle changes
      currentCommunicationDevice = device;
  }
};
AudioManager.addOnCommunicationDeviceChangedListener(executor, listener);

BLE-Audiogerät finden

Mit getAvailableCommunicationDevices können Sie sehen, welche Geräte für einen VoIP-Anruf verfügbar sind. Mit AudioDeviceInfo kannst du prüfen, ob es sich bei dem Gerät um ein BLE-Headset handelt. In diesem Beispiel wird nach dem ersten Gerät gesucht, das BLE Audio unterstützt. Sie können aber auch alle unterstützten Geräte suchen und Nutzer auswählen lassen.

Kotlin

// Get list of currently available devices
val devices = audioManager.availableCommunicationDevices

// User choose one of the devices, for example, TYPE_BLE_HEADSET
val userSelectedDeviceType = AudioDeviceInfo.TYPE_BLE_HEADSET

//for the device from the list
var selectedDevice: AudioDeviceInfo? = null
for (device in devices) {
  if (device.type == userSelectedDeviceType) {
    selectedDevice = device
    break
  }
}

Java

// Get list of currently available devices
List<AudioDeviceInfo> devices = audioManager.getAvailableCommunicationDevices();

// User choose one of the devices, for example, TYPE_BLE_HEADSET
int userSelectedDeviceType = AudioDeviceInfo.TYPE_BLE_HEADSET;

// Filter for the device from the list
AudioDeviceInfo selectedDevice = null;
for (AudioDeviceInfo device : devices) {
    if (device.getType() == userSelectedDeviceType) {
        selectedDevice = device;
        break;
    }
}

Kommunikationsgerät festlegen

Wenn Sie ein kompatibles Gerät gefunden haben, legen Sie mit setCommunicationDevice das Gerät fest, an das Sie weiterleiten möchten. Durch die Prüfung des Ergebnisses wird deine App darüber informiert, ob der Audiomanager versucht, das Gerät einzustellen, oder ob ein Fehler aufgetreten ist.

Kotlin

val result = audioManager.setCommunicationDevice(selectedDevice)
if (!result) {
  // Handle error.
}
// Wait for currentCommunicationDevice to become selectedDevice with a timeout (e.g. 30s)

Java

boolean result = audioManager.setCommunicationDevice(selectedDevice);
if (!result) {
  // Handle error.
}
// Wait for currentCommunicationDevice to become selectedDevice with a timeout (e.g. 30s)

Nachdem du das BLE-Audiogerät festgelegt hast, wird der Audiostream beim Tätigen eines Anrufs über das richtige Audio-Routing geleitet.

Sitzung beenden

Nachdem die App einen Anruf oder eine Sitzung beendet hat, lösche das aktive Kommunikationsgerät. So wird die Nutzerfreundlichkeit beim Wechsel zwischen verschiedenen Anwendungen verbessert.

Kotlin

// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()

Java

// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();