Este guia aborda como rotear áudio para dispositivos Bluetooth usando a API Telecom e definir a conexão para chamadas VoIP. Leia o guia Criar um app de chamada de vídeo e/ou ligação antes de continuar.
Usando as classes ConnectionService e Connection, é possível
acessar o estado do áudio e uma lista de dispositivos Bluetooth disponíveis, além de rotear
o áudio para um dispositivo Bluetooth selecionado.
Conexão VoIP e ConnectionService
Crie uma classe VoIPConnection que estenda Connection. Essa classe
controla o estado da chamada atual. Conforme o guia Criar um app de chamada de vídeo e ligação,
defina o aplicativo como autogerenciado e configure o modo de áudio para um aplicativo
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);
}
}
Em seguida, retorne uma instância dessa classe em ConnectionService quando uma
ligação recebida ou efetuada ocorrer.
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();
}
}
Verifique se o manifesto aponta corretamente para a 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>
Com essas classes personalizadas Connection e ConnectionService, é
possível controlar qual dispositivo e que tipo de roteamento de áudio você quer usar durante
uma chamada.
Acessar o estado de áudio atual
Para conferir o estado de áudio atual, chame getCallAudioState.
getCallAudioState retorna se o dispositivo está transmitindo usando
Bluetooth, um minifone de ouvido, um fone de ouvido com fio ou um alto-falante.
mAudioState = connection.getCallAudioState()
Quando o estado mudar
Para receber notificações sobre mudanças em CallAudioState, substitua
onCallAudioStateChanged(). Isso alerta você sobre qualquer mudança no estado.
Kotlin
fun onCallAudioStateChanged(audioState: CallAudioState) {
mAudioState = audioState
}
Java
@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
mAudioState = audioState;
}
Acessar o dispositivo atual
Receba o dispositivo ativo atual usando
CallAudioState.getActiveBluetoothDevice(). Essa função retorna o
dispositivo Bluetooth ativo.
Kotlin
val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()
Java
BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();
Encontrar dispositivos Bluetooth
Receba uma lista de dispositivos Bluetooth disponíveis para roteamento de áudio de chamadas usando
CallAudioState.getSupportedBluetoothDevices().
Kotlin
val availableBluetoothDevices: Collection<BluetoothDevice> =
mAudioState.getSupportedBluetoothDevices()
Java
Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();
Encaminhar o áudio da chamada
Usar o nível da API 28 e versões mais recentes (recomendado)
Encaminhe o áudio da chamada para um dispositivo Bluetooth disponível usando
requestBluetoothAudio(BluetoothDevice):
requestBluetoothAudio(availableBluetoothDevices[0]);
Como usar o nível 23 da API e versões mais recentes
Ative o ROUTE_BLUETOOTH sem especificar o dispositivo usando
setAudioRoute(int). Isso define o roteamento padrão para dispositivos Bluetooth
ativos no Android 9 e versões mais recentes.
setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);