Gestire le chiamate tramite l'API Telecom

Questa guida spiega come eseguire il routing dell'audio per i dispositivi Bluetooth utilizzando l'API Telecom e impostare la connessione per le chiamate VoIP. Leggi la guida Crea un'app di chiamate prima di continuare.

Utilizzando le classi ConnectionService e Connection, puoi accedere allo stato dell'audio e a un elenco di dispositivi Bluetooth disponibili, nonché indirizzare l'audio a un dispositivo Bluetooth selezionato.

Connessione VoIP e ConnectionService

Crea una classe VoIPConnection che estende Connection. Questa classe controlla lo stato della chiamata corrente. Come indicato nella guida Crea un'app di chiamate, rendi questa applicazione autogestita e imposta la modalità audio per un'applicazione 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);
  }
}

Poi, restituisci un'istanza di questa classe in ConnectionService quando si verifica una chiamata in entrata o in uscita.

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

Assicurati che il manifest rimandi correttamente alla 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>

Con queste classi Connection e ConnectionService personalizzate, puoi controllare quale dispositivo e quale tipo di routing audio vuoi utilizzare durante una chiamata.

Ottenere lo stato audio attuale

Per ottenere lo stato audio corrente, chiama getCallAudioState. getCallAudioState indica se il dispositivo sta trasmettendo in streaming tramite Bluetooth, un auricolare, cuffie con cavo o uno speaker.

mAudioState = connection.getCallAudioState()

On state changed

Iscriviti alle modifiche in CallAudioState eseguendo l'override di onCallAudioStateChanged(). In questo modo riceverai un avviso in caso di modifiche allo stato.

Kotlin

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

Java

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

Recupera il dispositivo corrente

Recupera il dispositivo attualmente attivo utilizzando CallAudioState.getActiveBluetoothDevice(). Questa funzione restituisce il dispositivo Bluetooth attivo.

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

Recupera i dispositivi Bluetooth

Recupera un elenco di dispositivi Bluetooth disponibili per il routing dell'audio delle chiamate utilizzando CallAudioState.getSupportedBluetoothDevices().

Kotlin

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

Java

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

Instrada l'audio della chiamata

Instrada l'audio della chiamata a un dispositivo Bluetooth disponibile utilizzando requestBluetoothAudio(BluetoothDevice):

requestBluetoothAudio(availableBluetoothDevices[0]);

Utilizzo del livello API 23 e versioni successive

Attiva ROUTE_BLUETOOTH senza specificare il dispositivo utilizzando setAudioRoute(int). In questo modo, il routing viene impostato per impostazione predefinita sui dispositivi Bluetooth attivi correnti su Android 9 e versioni successive.

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);