Questa guida riguarda le applicazioni di comunicazione, come Voice over Internet Protocol (VoIP), che vogliono gestire autonomamente lo stato dei propri dispositivi audio e hearable.
Registra il callback audio
Innanzitutto, crea un AudioDeviceCallback, che avvisa la tua app quando i dispositivi audio si connettono o si disconnettono dal 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);
Controlla se è presente un dispositivo di comunicazione attivo
Il gestore audio ti consente di sapere quale dispositivo di comunicazione è attualmente attivo.
Kotlin
val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice
Java
AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();
Il monitoraggio della modifica di un dispositivo di comunicazione consente alla tua app di sapere quando viene applicato il routing e quando il dispositivo selezionato è attivo.
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);
Trova dispositivo audio BLE
Utilizza getAvailableCommunicationDevices per vedere quali dispositivi sono disponibili per una chiamata VoIP. Utilizza AudioDeviceInfo per verificare se il dispositivo è un paio di cuffie BLE.
Questo esempio cerca il primo dispositivo che supporta BLE Audio, ma potresti anche prendere in considerazione la possibilità di trovare tutti i dispositivi supportati e consentire agli utenti di scegliere.
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;
}
}
Imposta dispositivo di comunicazione
Dopo aver trovato un dispositivo compatibile, utilizza setCommunicationDevice per impostare il dispositivo a cui vuoi indirizzare l'audio. Il controllo del risultato indica alla tua app se il gestore audio sta tentando di impostare il dispositivo o se ha riscontrato un errore.
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)
Dopo aver impostato il dispositivo audio BLE, lo stream audio utilizza il routing audio corretto quando effettui una chiamata.
Fine della sessione.
Al termine di una chiamata o di una sessione, l'app deve cancellare il dispositivo di comunicazione attivo. In questo modo, l'utente può usufruire di un'esperienza ottimale quando passa da un'applicazione all'altra.
Kotlin
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()
Java
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();