使用Telecom API管理通话

本指南介绍如何使用Telecom API路由蓝牙设备的音频，并设置VoIP通话的连接。在继续之前，请阅读构建呼叫应用程序指南。

通过使用ConnectionService和Connection类，您可以访问音频状态和可用蓝牙设备列表，并可以将音频路由到选定的蓝牙设备。

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()返回设备是否正在使用蓝牙、听筒、有线或扬声器进行流式传输。

mAudioState = connection.getCallAudioState()

状态更改时

通过覆盖onCallAudioStateChanged()来订阅CallAudioState的更改。这会提醒您状态的任何更改。

Kotlin

fun onCallAudioStateChanged(audioState: CallAudioState) {
  mAudioState = audioState
}

Java

@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
  mAudioState = audioState;
}

获取当前设备

使用CallAudioState.getActiveBluetoothDevice()获取当前活动设备。此函数返回活动蓝牙设备。

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

获取蓝牙设备

使用CallAudioState.getSupportedBluetoothDevices()获取可用于呼叫音频路由的蓝牙设备列表。

Kotlin

val availableBluetoothDevices: Collection =
  mAudioState.getSupportedBluetoothDevices()

Java

Collection availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();

路由呼叫音频

使用requestBluetoothAudio(BluetoothDevice)将呼叫音频路由到可用的蓝牙设备。

requestBluetoothAudio(availableBluetoothDevices[0]);

使用 API 级别 23 及更高版本

使用setAudioRoute(int)启用ROUTE_BLUETOOTH，无需指定设备。在 Android 9 及更高版本中，这会将路由默认设置为当前活动的蓝牙设备。

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);