Zarządzanie wywołaniami przy użyciu interfejsu Telecom API

Z tego przewodnika dowiesz się, jak przekierowywać dźwięk na urządzenia Bluetooth za pomocą interfejsu Telecom API i konfigurować połączenie na potrzeby połączeń VoIP. Zanim przejdziesz dalej, przeczytaj przewodnik Tworzenie aplikacji do dzwonienia.

Za pomocą klas ConnectionService i Connection możesz uzyskać dostęp do stanu dźwięku i listy dostępnych urządzeń Bluetooth oraz przekierować dźwięk do wybranego urządzenia Bluetooth.

Połączenie VoIP i ConnectionService

Utwórz klasę VoIPConnection, która rozszerza klasę Connection. Ta klasa kontroluje stan bieżącego połączenia. Zgodnie z przewodnikiem Tworzenie aplikacji do dzwonienia ustaw tę aplikację jako samodzielnie zarządzaną i ustaw tryb „Tylko dźwięk” dla aplikacji 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);
  }
}

Następnie zwróć instancję tej klasy w ConnectionService, gdy nastąpi połączenie przychodzące lub wychodzące.

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

Upewnij się, że plik manifestu prawidłowo wskazuje klasę 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>

Dzięki tym niestandardowym klasom Connection i ConnectionService możesz kontrolować, którego urządzenia i jakiego typu routingu dźwięku chcesz używać podczas połączenia.

Pobieranie bieżącego stanu dźwięku

Aby uzyskać bieżący stan dźwięku, wywołaj funkcję getCallAudioState. getCallAudioState zwraca informację, czy urządzenie przesyła strumieniowo przez Bluetooth, słuchawkę, przewodowy zestaw słuchawkowy czy głośnik.

mAudioState = connection.getCallAudioState()

Zmiana stanu

Zasubskrybuj zmiany w CallAudioState, zastępując onCallAudioStateChanged(). Dzięki temu będziesz otrzymywać powiadomienia o wszelkich zmianach stanu.

Kotlin

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

Java

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

Pobieranie bieżącego urządzenia

Pobierz aktualnie aktywne urządzenie za pomocą CallAudioState.getActiveBluetoothDevice(). Ta funkcja zwraca aktywne urządzenie Bluetooth.

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

Pobieranie urządzeń Bluetooth

Pobierz listę urządzeń Bluetooth, które są dostępne do przekierowywania dźwięku połączeń, za pomocą CallAudioState.getSupportedBluetoothDevices().

Kotlin

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

Java

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

Kierowanie dźwięku rozmowy

Przekieruj dźwięk rozmowy na dostępne urządzenie Bluetooth za pomocą requestBluetoothAudio(BluetoothDevice):

requestBluetoothAudio(availableBluetoothDevices[0]);

Korzystanie z interfejsu API na poziomie 23 lub wyższym

Włącz ROUTE_BLUETOOTH bez określania urządzenia za pomocą setAudioRoute(int). Domyślnie kieruje to połączenia do aktualnie aktywnych urządzeń Bluetooth na Androidzie 9 lub nowszym.

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);