En esta guía, se explica cómo enrutar el audio para dispositivos Bluetooth con la API de Telecom y establecer la conexión para las llamadas de VoIP. Antes de continuar, lee la guía Cómo compilar una app de llamadas.
Con las clases ConnectionService y Connection, puedes acceder al estado del audio y a una lista de dispositivos Bluetooth disponibles, y puedes enrutar el audio a un dispositivo Bluetooth seleccionado.
Conexión de VoIP y ConnectionService
Crea una clase VoIPConnection que extienda de Connection. Esta clase controla el estado de la llamada actual. Como se indica en la guía Cómo crear una app de llamadas, haz que esta sea una aplicación autoadministrada y establece el modo de audio para una aplicación de 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);
}
}
Luego, devuelve una instancia de esta clase en ConnectionService cuando se produzca una llamada entrante o saliente.
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();
}
}
Asegúrate de que el manifiesto apunte correctamente a la clase 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 estas clases personalizadas Connection y ConnectionService, puedes controlar qué dispositivo y qué tipo de enrutamiento de audio quieres usar durante una llamada.
Obtén el estado de audio actual
Para obtener el estado de audio actual, llama a getCallAudioState.
getCallAudioState devuelve si el dispositivo está transmitiendo con Bluetooth, un auricular, auriculares con cable o una bocina.
mAudioState = connection.getCallAudioState()
On state changed
Anula onCallAudioStateChanged() para suscribirte a los cambios en CallAudioState. Esto te alerta sobre cualquier cambio en el estado.
Kotlin
fun onCallAudioStateChanged(audioState: CallAudioState) {
mAudioState = audioState
}
Java
@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
mAudioState = audioState;
}
Obtén el dispositivo actual
Obtén el dispositivo activo actual con CallAudioState.getActiveBluetoothDevice(). Esta función devuelve el dispositivo Bluetooth activo.
Kotlin
val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()
Java
BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();
Cómo obtener dispositivos Bluetooth
Obtén una lista de los dispositivos Bluetooth que están disponibles para el enrutamiento de audio de llamadas con CallAudioState.getSupportedBluetoothDevices().
Kotlin
val availableBluetoothDevices: Collection<BluetoothDevice> =
mAudioState.getSupportedBluetoothDevices()
Java
Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();
Cómo enrutar el audio de la llamada
Usa el nivel de API 28 y versiones posteriores (recomendado)
Enruta el audio de la llamada a un dispositivo Bluetooth disponible con requestBluetoothAudio(BluetoothDevice):
requestBluetoothAudio(availableBluetoothDevices[0]);
Uso del nivel de API 23 y versiones posteriores
Habilita ROUTE_BLUETOOTH sin especificar el dispositivo con setAudioRoute(int). Esto establece de forma predeterminada el enrutamiento a los dispositivos Bluetooth activos actuales en Android 9 y versiones posteriores.
setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);