Gerenciar ligações usando a API Telecom

Este guia aborda como rotear áudio para dispositivos Bluetooth usando a API Telecom e definir a conexão para chamadas VoIP. Leia o guia Criar um app de chamada de vídeo e/ou ligação antes de continuar.

Usando as classes ConnectionService e Connection, é possível acessar o estado do áudio e uma lista de dispositivos Bluetooth disponíveis, além de rotear o áudio para um dispositivo Bluetooth selecionado.

Conexão VoIP e ConnectionService

Crie uma classe VoIPConnection que estenda Connection. Essa classe controla o estado da chamada atual. Conforme o guia Criar um app de chamada de vídeo e ligação, defina o aplicativo como autogerenciado e configure o modo de áudio para um aplicativo 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);
  }
}

Em seguida, retorne uma instância dessa classe em ConnectionService quando uma ligação recebida ou efetuada ocorrer.

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

Verifique se o manifesto aponta corretamente para a classe 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>

Com essas classes personalizadas Connection e ConnectionService, é possível controlar qual dispositivo e que tipo de roteamento de áudio você quer usar durante uma chamada.

Acessar o estado de áudio atual

Para conferir o estado de áudio atual, chame getCallAudioState. getCallAudioState retorna se o dispositivo está transmitindo usando Bluetooth, um minifone de ouvido, um fone de ouvido com fio ou um alto-falante.

mAudioState = connection.getCallAudioState()

Quando o estado mudar

Para receber notificações sobre mudanças em CallAudioState, substitua onCallAudioStateChanged(). Isso alerta você sobre qualquer mudança no estado.

Kotlin

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

Java

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

Acessar o dispositivo atual

Receba o dispositivo ativo atual usando CallAudioState.getActiveBluetoothDevice(). Essa função retorna o dispositivo Bluetooth ativo.

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

Encontrar dispositivos Bluetooth

Receba uma lista de dispositivos Bluetooth disponíveis para roteamento de áudio de chamadas usando CallAudioState.getSupportedBluetoothDevices().

Kotlin

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

Java

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

Encaminhar o áudio da chamada

Encaminhe o áudio da chamada para um dispositivo Bluetooth disponível usando requestBluetoothAudio(BluetoothDevice):

requestBluetoothAudio(availableBluetoothDevices[0]);

Como usar o nível 23 da API e versões mais recentes

Ative o ROUTE_BLUETOOTH sem especificar o dispositivo usando setAudioRoute(int). Isso define o roteamento padrão para dispositivos Bluetooth ativos no Android 9 e versões mais recentes.

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);