Guia de chamadas autogerenciadas do gerenciador de áudio

Este guia aborda aplicativos de comunicação, como o Voice over Internet Protocol (VoIP), que querem gerenciar por conta própria o áudio e o estado do dispositivo audível.

Registrar callback de áudio

Primeiro, crie uma AudioDeviceCallback, que notifica o app quando dispositivos de áudio são conectados ou desconectados do dispositivo.

val audioDeviceCallback: AudioDeviceCallback = object : AudioDeviceCallback() {
  override fun onAudioDevicesAdded(addedDevices: Array) {}
  override fun onAudioDevicesRemoved(removedDevices: Array) {}
}

audioManager.registerAudioDeviceCallback(audioDeviceCallback)

final AudioDeviceCallback audioDeviceCallback = new AudioDeviceCallback() {
  @Override
  public void onAudioDevicesAdded(AudioDeviceInfo[] addedDevices) {
  }

  @Override
  public void onAudioDevicesRemoved(AudioDeviceInfo[] removedDevices) {
    // Handle device removal
  }
};

audioManager.registerAudioDeviceCallback(audioDeviceCallback);

Verificar se há um dispositivo de comunicação ativo

O gerenciador de áudio informa qual dispositivo de comunicação está ativo no momento.

val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice

AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();

Quando você detecta quando um dispositivo de comunicação mudou, o app sabe quando o roteamento está ativado e o dispositivo selecionado está ativo.

val listener =
  OnCommunicationDeviceChangedListener { device -> // Handle changes
    currentCommunicationDevice = device
  }
audioManager.addOnCommunicationDeviceChangedListener(executor, listener)

AudioManager.OnCommunicationDeviceChangedListener listener = 
      new AudioManager.OnCommunicationDeviceChangedListener() {
  @Override
  void onCommunicationDeviceChanged(AudioDeviceInfo device) {
      // Handle changes
      currentCommunicationDevice = device;
  }
};
AudioManager.addOnCommunicationDeviceChangedListener(executor, listener);

Encontrar dispositivo de áudio BLE

Use getAvailableCommuncationDevices() para saber quais dispositivos estão disponíveis para chamadas VoIP. Use AudioDeviceInfo para ver se o dispositivo é um fone de ouvido BLE. Este exemplo procura o primeiro dispositivo compatível com o áudio BLE, mas você também pode considerar encontrar todos os dispositivos compatíveis e permitir que os usuários escolham.

// Get list of currently available devices
val devices = audioManager.availableCommunicationDevices

// User choose one of the devices, let's say, TYPE_BLE_HEADSET
val userSelectedDeviceType = AudioDeviceInfo.TYPE_BLE_HEADSET

//for the device from the list
var selectedDevice: AudioDeviceInfo? = null
for (device in devices) {
  if (device.type == userSelectedDeviceType) {
    selectedDevice = device
    break
  }
}

// Get list of currently available devices
List devices = audioManager.getAvailableCommunicationDevices();

// User choose one of the devices, for example, TYPE_BLE_HEADSET
int userSelectedDeviceType = AudioDeviceInfo.TYPE_BLE_HEADSET;

// Filter for the device from the list
AudioDeviceInfo selectedDevice = null;
for (AudioDeviceInfo device : devices) {
    if (device.getType() == userSelectedDeviceType) {
        selectedDevice = device;
        break;
    }
}

Definir dispositivo de comunicação

Depois de encontrar um dispositivo compatível, use setCommunicationDevice para definir o dispositivo que vai receber a rota. Verificar o resultado informa ao seu app se o gerenciador de áudio está tentando configurar o dispositivo ou se encontrou um erro.

val result = audioManager.setCommunicationDevice(selectedDevice)
if (!result) {
  // Handle error.
}
// Wait for currentCommunicationDevice to become selectedDevice with a timeout (e.g. 30s)

boolean result = audioManager.setCommunicationDevice(selectedDevice);
if (!result) {
  // Handle error.
}
// Wait for currentCommunicationDevice to become selectedDevice with a timeout (e.g. 30s)

Agora que o dispositivo de áudio BLE foi configurado, o stream de áudio terá o roteamento correto ao fazer uma chamada.

Encerrar a sessão

Depois que o app terminar uma chamada ou sessão, limpe o dispositivo de comunicação ativo. Isso ajuda a garantir que o usuário tenha uma ótima experiência ao alternar entre diferentes aplicativos.

// Clear the selection, ready for next call
audioManager.clearCommunicationDevice()

// Clear the selection, ready for next call
audioManager.clearCommunicationDevice();