Cómo administrar llamadas con la API de Telecom

En esta guía, se explica cómo enrutar el audio para dispositivos Bluetooth con la API de Telecom y establecer la conexión para las llamadas de VoIP. Antes de continuar, lee la guía Cómo compilar una app de llamadas.

Con las clases ConnectionService y Connection, puedes acceder al estado del audio y a una lista de dispositivos Bluetooth disponibles, y puedes enrutar el audio a un dispositivo Bluetooth seleccionado.

Conexión de VoIP y ConnectionService

Crea una clase VoIPConnection que extienda de Connection. Esta clase controla el estado de la llamada actual. Como se indica en la guía Cómo crear una app de llamadas, haz que esta sea una aplicación autoadministrada y establece el modo de audio para una aplicación de 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);
  }
}

Luego, devuelve una instancia de esta clase en ConnectionService cuando se produzca una llamada entrante o saliente.

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();
  }
}

Asegúrate de que el manifiesto apunte correctamente a la clase 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>

Con estas clases personalizadas Connection y ConnectionService, puedes controlar qué dispositivo y qué tipo de enrutamiento de audio quieres usar durante una llamada.

Obtén el estado de audio actual

Para obtener el estado de audio actual, llama a getCallAudioState. getCallAudioState devuelve si el dispositivo está transmitiendo con Bluetooth, un auricular, auriculares con cable o una bocina.

mAudioState = connection.getCallAudioState()

On state changed

Anula onCallAudioStateChanged() para suscribirte a los cambios en CallAudioState. Esto te alerta sobre cualquier cambio en el estado.

Kotlin

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

Java

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

Obtén el dispositivo actual

Obtén el dispositivo activo actual con CallAudioState.getActiveBluetoothDevice(). Esta función devuelve el dispositivo Bluetooth activo.

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

Cómo obtener dispositivos Bluetooth

Obtén una lista de los dispositivos Bluetooth que están disponibles para el enrutamiento de audio de llamadas con CallAudioState.getSupportedBluetoothDevices().

Kotlin

val availableBluetoothDevices: Collection<BluetoothDevice> =
  mAudioState.getSupportedBluetoothDevices()

Java

Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();

Cómo enrutar el audio de la llamada

Enruta el audio de la llamada a un dispositivo Bluetooth disponible con requestBluetoothAudio(BluetoothDevice):

requestBluetoothAudio(availableBluetoothDevices[0]);

Uso del nivel de API 23 y versiones posteriores

Habilita ROUTE_BLUETOOTH sin especificar el dispositivo con setAudioRoute(int). Esto establece de forma predeterminada el enrutamiento a los dispositivos Bluetooth activos actuales en Android 9 y versiones posteriores.

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);