Panduan ini membahas aplikasi komunikasi, seperti Voice over Internet Protocol (VoIP), yang ingin mengelola sendiri status perangkat audio dan perangkat pendengaran.
Mendaftarkan callback audio
Pertama, buat AudioDeviceCallback, yang memberi tahu aplikasi Anda saat perangkat audio
terhubung atau terputus dari perangkat.
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);
Memeriksa perangkat komunikasi yang aktif
Pengelola audio memberi tahu Anda perangkat komunikasi mana yang saat ini aktif.
Kotlin
val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice
Java
AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();
Memproses saat perangkat komunikasi berubah akan memberi tahu aplikasi Anda saat perutean diterapkan dan perangkat yang Anda pilih aktif.
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);
Menemukan perangkat audio BLE
Gunakan getAvailableCommunicationDevices untuk melihat perangkat yang tersedia
untuk panggilan VoIP. Gunakan AudioDeviceInfo untuk melihat apakah perangkat tersebut adalah headset BLE.
Contoh ini mencari perangkat pertama yang mendukung BLE Audio, tetapi Anda juga dapat
mempertimbangkan untuk menemukan semua perangkat yang didukung dan mengizinkan pengguna memilih.
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;
}
}
Menyetel perangkat komunikasi
Setelah menemukan perangkat yang kompatibel, gunakan setCommunicationDevice untuk menetapkan
perangkat yang ingin Anda gunakan untuk merutekan audio. Memeriksa hasilnya akan memberi tahu aplikasi Anda apakah pengelola audio mencoba menyetel perangkat atau mengalami 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)
Setelah Anda menyetel perangkat audio BLE, streaming audio akan menggunakan pemilihan rute audio yang benar saat Anda melakukan panggilan.
Mengakhiri sesi
Setelah aplikasi Anda menyelesaikan panggilan atau sesi, hapus perangkat komunikasi yang aktif. Hal ini membantu memastikan pengguna mendapatkan pengalaman yang baik saat berpindah di antara berbagai aplikasi.
Kotlin
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()
Java
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();