Telecom API を使用して通話を管理する

このガイドでは、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();

通話音声をルーティングする

requestBluetoothAudio(BluetoothDevice) を使用して、通話音声を、利用可能な Bluetooth デバイスにルーティングします。

requestBluetoothAudio(availableBluetoothDevices[0]);

API レベル 23 以降を使用する

setAudioRoute(int) を使用してデバイスを指定せずに ROUTE_BLUETOOTH を有効にします。Android 9 以降では、デフォルトで、現在アクティブな Bluetooth デバイスにルーティングされます。

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);