このガイドでは、Telecom API を使用して Bluetooth デバイスの音声をルーティングし、VoIP 通話の接続を設定する方法について説明します。先に進む前に、通話アプリを作成するガイドをお読みください。
ConnectionService クラスと Connection クラスを使用すると、オーディオの状態と利用可能な Bluetooth デバイスのリストにアクセスし、選択した Bluetooth デバイスにオーディオをルーティングできます。
VoIP 接続と ConnectionService
Connection を拡張する VoIPConnection クラスを作成します。このクラスは、現在の通話の状態を制御します。通話アプリを作成するガイドに記載されているように、これを自己管理型アプリにして、VoIP アプリの音声モードを設定します。
Kotlin
class VoIPConnection : Connection() {
init {
setConnectionProperties(PROPERTY_SELF_MANAGED)
setAudioModeIsVoip(true)
}
}
Java
public class VoIPConnection extends Connection {
public VoIPConnection() {
setConnectionProperties(PROPERTY_SELF_MANAGED);
setAudioModeIsVoip(true);
}
}
次に、着信または発信が発生したときに、ConnectionService でこのクラスのインスタンスを返します。
Kotlin
class VoIPConnectionService : ConnectionService() {
override fun onCreateOutgoingConnection(
connectionManagerPhoneAccount: PhoneAccountHandle,
request: ConnectionRequest,
): Connection {
return VoIPConnection()
}
}
Java
public class VoIPConnectionService extends ConnectionService {
@Override
public Connection onCreateOutgoingConnection(PhoneAccountHandle connectionManagerPhoneAccount, ConnectionRequest request) {
return new VoIPConnection();
}
}
マニフェストが VoIPConnectionService クラスを正しく参照していることを確認します。
<service android:name=".voip.TelegramConnectionService" android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
<intent-filter>
<action android:name="android.telecom.ConnectionService"/>
</intent-filter>
</service>
これらのカスタム Connection クラスと ConnectionService クラスを使用すると、通話中に使用するデバイスと音声ルーティングの種類を制御できます。
現在のオーディオの状態を取得する
現在のオーディオ状態を取得するには、getCallAudioState を呼び出します。getCallAudioState は、デバイスが Bluetooth、受話口、有線ヘッドセット、スピーカーのいずれを使用してストリーミングしているかを返します。
mAudioState = connection.getCallAudioState()
状態が変更されたとき
onCallAudioStateChanged() をオーバーライドして、CallAudioState の変更をサブスクライブします。これにより、状態の変化が通知されます。
Kotlin
fun onCallAudioStateChanged(audioState: CallAudioState) {
mAudioState = audioState
}
Java
@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
mAudioState = audioState;
}
現在のデバイスを取得する
CallAudioState.getActiveBluetoothDevice() を使用して、現在アクティブなデバイスを取得します。この関数は、アクティブな Bluetooth デバイスを返します。
Kotlin
val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()
Java
BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();
Bluetooth デバイスを取得する
CallAudioState.getSupportedBluetoothDevices() を使用して、通話音声のルーティングに使用できる Bluetooth デバイスのリストを取得します。
Kotlin
val availableBluetoothDevices: Collection<BluetoothDevice> =
mAudioState.getSupportedBluetoothDevices()
Java
Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();
通話音声をルーティングする
API レベル 28 以降を使用する(推奨)
requestBluetoothAudio(BluetoothDevice) を使用して、通話音声を、利用可能な Bluetooth デバイスにルーティングします。
requestBluetoothAudio(availableBluetoothDevices[0]);
API レベル 23 以降を使用する
setAudioRoute(int) を使用してデバイスを指定せずに ROUTE_BLUETOOTH を有効にします。Android 9 以降では、デフォルトで、現在アクティブな Bluetooth デバイスにルーティングされます。
setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);