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
Korzystanie z interfejsu API na poziomie 28 lub wyższym (zalecane)
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);