このガイドでは、音声デバイスとヒアラブル デバイスの状態を自己管理する、Voice over Internet Protocol(VoIP)などの通信アプリについて説明します。
オーディオ コールバックを登録する
まず、AudioDeviceCallback を作成します。これは、オーディオ機器がデバイスに接続または切断されたときにアプリに通知します。
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);
アクティブな通信デバイスを確認する
オーディオ マネージャーでは、現在アクティブな通信デバイスを確認できます。
Kotlin
val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice
Java
AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();
通信デバイスが変更されたときにリッスンすることで、ルーティングが適用されたときと、選択したデバイスがアクティブになったときをアプリが認識できます。
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 オーディオ機器を探す
getAvailableCommunicationDevices を使用して、VoIP 通話に使用できるデバイスを確認します。AudioDeviceInfo を使用して、デバイスが BLE ヘッドセットかどうかを確認します。この例では、BLE Audio をサポートする最初のデバイスを探していますが、サポートされているすべてのデバイスを検出して、ユーザーが選択できるようにすることもできます。
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;
}
}
通信デバイスを設定する
互換性のあるデバイスが見つかったら、setCommunicationDevice を使用して、ルーティング先のデバイスを設定します。結果を確認すると、オーディオ マネージャーがデバイスを設定しようとしているのか、エラーが発生したのかをアプリに通知できます。
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)
BLE オーディオ機器を設定すると、通話時に音声ストリームが正しいオーディオ ルーティングを使用します。
セッションを終了します
アプリが通話またはセッションを終了したら、アクティブな通信デバイスをクリアします。これにより、ユーザーが異なるアプリケーション間を移動する際に、優れたエクスペリエンスを提供できます。
Kotlin
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()
Java
// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();