In diesem Leitfaden wird beschrieben, wie Sie Audio für Bluetooth-Geräte mit der Telecom API weiterleiten und die Verbindung für VoIP-Anrufe einrichten. Lies den Leitfaden Anruf-App erstellen, bevor du fortfährst.
Mit den Klassen ConnectionService und Connection kannst du auf den Audiostatus und eine Liste der verfügbaren Bluetooth-Geräte zugreifen und Audio an ein ausgewähltes Bluetooth-Gerät weiterleiten.
VoIP-Verbindung und ConnectionService
Erstellen Sie eine VoIPConnection-Klasse, die von Connection abgeleitet ist. Diese Klasse steuert den Status des aktuellen Anrufs. Wie im Leitfaden Anruf-App erstellen beschrieben, solltest du diese Anwendung als selbstverwaltete Anwendung einrichten und den Audiomodus für eine VoIP-Anwendung festlegen.
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);
}
}
Gib als Nächstes eine Instanz dieser Klasse in ConnectionService zurück, wenn ein eingehender oder ausgehender Anruf erfolgt.
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();
}
}
Achten Sie darauf, dass das Manifest korrekt auf die Klasse VoIPConnectionService verweist.
<service android:name=".voip.TelegramConnectionService" android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
<intent-filter>
<action android:name="android.telecom.ConnectionService"/>
</intent-filter>
</service>
Mit diesen benutzerdefinierten Connection- und ConnectionService-Klassen kannst du festlegen, welches Gerät und welche Art von Audio-Routing während eines Anrufs verwendet werden soll.
Aktuellen Audiostatus abrufen
Rufen Sie getCallAudioState auf, um den aktuellen Audiostatus abzurufen.
getCallAudioState gibt zurück, ob das Gerät über Bluetooth, einen Kopfhörer, ein kabelgebundenes Headset oder einen Lautsprecher streamt.
mAudioState = connection.getCallAudioState()
Bei Statusänderung
Abonnieren Sie Änderungen in CallAudioState, indem Sie onCallAudioStateChanged() überschreiben. So werden Sie über alle Änderungen am Status informiert.
Kotlin
fun onCallAudioStateChanged(audioState: CallAudioState) {
mAudioState = audioState
}
Java
@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
mAudioState = audioState;
}
Aktuelles Gerät abrufen
Rufe das aktuell aktive Gerät mit CallAudioState.getActiveBluetoothDevice() ab. Diese Funktion gibt das aktive Bluetooth-Gerät zurück.
Kotlin
val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()
Java
BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();
Bluetooth-Geräte abrufen
Mit CallAudioState.getSupportedBluetoothDevices() kannst du eine Liste der Bluetooth-Geräte abrufen, die für die Weiterleitung von Anrufaudio verfügbar sind.
Kotlin
val availableBluetoothDevices: Collection<BluetoothDevice> =
mAudioState.getSupportedBluetoothDevices()
Java
Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();
Anruf-Audio weiterleiten
API-Level 28 und höher (empfohlen)
Leite das Audiosignal des Anrufs mit requestBluetoothAudio(BluetoothDevice) an ein verfügbares Bluetooth-Gerät weiter:
requestBluetoothAudio(availableBluetoothDevices[0]);
API-Level 23 und höher verwenden
Aktivieren Sie ROUTE_BLUETOOTH, ohne das Gerät mit setAudioRoute(int) anzugeben. Dadurch wird das Routing auf Geräten mit Android 9 und höher standardmäßig auf aktuelle, aktive Bluetooth-Geräte festgelegt.
setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);