Guía sobre llamadas autoadministradas del Administrador de audio

En esta guía, se abordan las aplicaciones de comunicación, como la voz por protocolo de Internet (VoIP), que quieren autoadministrar su estado de audio y de dispositivo de audio.

Registra la devolución de llamada de audio

Primero, crea un AudioDeviceCallback, que notifica a tu app cuando los dispositivos de audio se conectan o desconectan del dispositivo.

Kotlin

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

audioManager.registerAudioDeviceCallback(audioDeviceCallback)

Java

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

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

audioManager.registerAudioDeviceCallback(audioDeviceCallback);

Cómo verificar si hay un dispositivo de comunicación activo

El administrador de audio te permite saber qué dispositivo de comunicación está activo en ese momento.

Kotlin

val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice

Java

AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();

Escuchar cuando cambia un dispositivo de comunicación permite que tu app sepa cuándo se aplica el enrutamiento y que el dispositivo que seleccionaste está activo.

Kotlin

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

Java

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

Cómo buscar un dispositivo de audio BLE

Usa getAvailableCommunicationDevices para ver qué dispositivos están disponibles para una llamada de VoIP. Usa AudioDeviceInfo para ver si el dispositivo es un auricular BLE. En este ejemplo, se busca el primer dispositivo que admita audio BLE, pero también puedes considerar buscar todos los dispositivos compatibles y permitir que los usuarios elijan.

Kotlin

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

// User choose one of the devices, for example, 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
  }
}

Java

// Get list of currently available devices
List<AudioDeviceInfo> 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;
    }
}

Establecer dispositivo de comunicación

Después de encontrar un dispositivo compatible, usa setCommunicationDevice para establecer el dispositivo al que deseas enrutar. Verificar el resultado informa a tu app si el administrador de audio está intentando configurar el dispositivo o si encontró un error.

Kotlin

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

Java

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

Después de configurar el dispositivo de audio BLE, la transmisión de audio usa el enrutamiento de audio correcto cuando realizas una llamada.

Finaliza la sesión.

Una vez que tu app finalice una llamada o sesión, borra el dispositivo de comunicación activo. Esto ayuda a garantizar que el usuario tenga una excelente experiencia cuando se mueva entre diferentes aplicaciones.

Kotlin

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

Java

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