Ten przewodnik dotyczy aplikacji do komunikacji, takich jak VoIP, które chcą samodzielnie zarządzać stanem dźwięku i urządzenia słuchowego.
Rejestrowanie wywołania zwrotnego dźwięku
Najpierw utwórz AudioDeviceCallback, który powiadomi aplikację, gdy urządzenia audio połączą się z urządzeniem lub się od niego odłączą.
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);
Sprawdzanie aktywnego urządzenia do komunikacji
Menedżer dźwięku informuje, które urządzenie do komunikacji jest obecnie aktywne.
Kotlin
val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice
Java
AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();
Nasłuchiwanie zmiany urządzenia do komunikacji pozwala aplikacji dowiedzieć się, kiedy stosowane jest przekierowanie i kiedy wybrane urządzenie jest aktywne.
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);
Znajdź urządzenie audio BLE
Użyj getAvailableCommunicationDevices, aby sprawdzić, które urządzenia są dostępne do połączenia VoIP. Użyj AudioDeviceInfo, aby sprawdzić, czy urządzenie jest zestawem słuchawkowym BLE.
W tym przykładzie szukamy pierwszego urządzenia, które obsługuje BLE Audio, ale możesz też znaleźć wszystkie obsługiwane urządzenia i pozwolić użytkownikom wybrać jedno z nich.
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;
}
}
Ustaw urządzenie do komunikacji
Gdy znajdziesz zgodne urządzenie, użyj setCommunicationDevice, aby ustawić urządzenie, na które chcesz przekierować połączenie. Sprawdzenie wyniku informuje aplikację, czy menedżer dźwięku próbuje ustawić urządzenie, czy wystąpił błąd.
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)
Po skonfigurowaniu urządzenia audio BLE strumień audio będzie używać prawidłowego routingu audio podczas nawiązywania połączenia.
Zakończ sesję
Gdy aplikacja zakończy połączenie lub sesję, wyczyść aktywne urządzenie komunikacyjne. Dzięki temu użytkownik może wygodnie przechodzić między różnymi aplikacjami.
Kotlin
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()
Java
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();