Android NDK开发详解连接性之使用 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()

On 状态已更改

通过替换 onCallAudioStateChanged() 来订阅 CallAudioState 中的更改。这会提醒您状态的任何变化。
Kotlin

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

Java

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

获取当前设备

使用 CallAudioState.getActiveBluetoothDevice() 获取当前的活跃设备。此函数会返回活跃的蓝牙设备。
注意 ：此功能仅适用于 API 级别 28 及更高级别。
Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

获取蓝牙设备

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

val availableBluetoothDevices: Collection =
  mAudioState.getSupportedBluetoothDevices()

Java

Collection availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();

转接通话音频

使用 API 级别 28 及更高级别（推荐）

使用 requestBluetoothAudio(BluetoothDevice) 将通话音频路由到可用的蓝牙设备：

requestBluetoothAudio(availableBluetoothDevices[0]);

使用 API 级别 23 及更高级别

启用 ROUTE_BLUETOOTH，而不使用 setAudioRoute(int) 指定设备。此设置默认路由到 Android 9 及更高版本上当前活跃的蓝牙设备。

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);

注意： 如果应用已经知道要将音频路由到哪个蓝牙设备，则无需执行此步骤。

本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2023-11-11。