En esta guía, se abordan las aplicaciones de comunicación, como la voz por protocolo de Internet (VoIP), que quieren autoadministrar su estado de audio y de dispositivo de audio.
Registra la devolución de llamada de audio
Primero, crea un AudioDeviceCallback, que notifica a tu app cuando los dispositivos de audio se conectan o desconectan del dispositivo.
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);
Cómo verificar si hay un dispositivo de comunicación activo
El administrador de audio te permite saber qué dispositivo de comunicación está activo en ese momento.
Kotlin
val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice
Java
AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();
Escuchar cuando cambia un dispositivo de comunicación permite que tu app sepa cuándo se aplica el enrutamiento y que el dispositivo que seleccionaste está activo.
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);
Cómo buscar un dispositivo de audio BLE
Usa getAvailableCommunicationDevices para ver qué dispositivos están disponibles para una llamada de VoIP. Usa AudioDeviceInfo para ver si el dispositivo es un auricular BLE.
En este ejemplo, se busca el primer dispositivo que admita audio BLE, pero también puedes considerar buscar todos los dispositivos compatibles y permitir que los usuarios elijan.
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;
}
}
Establecer dispositivo de comunicación
Después de encontrar un dispositivo compatible, usa setCommunicationDevice para establecer el dispositivo al que deseas enrutar. Verificar el resultado informa a tu app si el administrador de audio está intentando configurar el dispositivo o si encontró un error.
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)
Después de configurar el dispositivo de audio BLE, la transmisión de audio usa el enrutamiento de audio correcto cuando realizas una llamada.
Finaliza la sesión.
Una vez que tu app finalice una llamada o sesión, borra el dispositivo de comunicación activo. Esto ayuda a garantizar que el usuario tenga una excelente experiencia cuando se mueva entre diferentes aplicaciones.
Kotlin
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()
Java
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();