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