Przewodnik po samodzielnym zarządzaniu rozmowami w Menedżerze dźwięku

Ten przewodnik dotyczy aplikacji do komunikacji, takich jak VoIP, które chcą samodzielnie zarządzać stanem dźwięku i urządzenia słuchowego.

Rejestrowanie wywołania zwrotnego dźwięku

Najpierw utwórz AudioDeviceCallback, który powiadomi aplikację, gdy urządzenia audio połączą się z urządzeniem lub się od niego odłączą.

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);

Sprawdzanie aktywnego urządzenia do komunikacji

Menedżer dźwięku informuje, które urządzenie do komunikacji jest obecnie aktywne.

Kotlin

val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice

Java

AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();

Nasłuchiwanie zmiany urządzenia do komunikacji pozwala aplikacji dowiedzieć się, kiedy stosowane jest przekierowanie i kiedy wybrane urządzenie jest aktywne.

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);

Znajdź urządzenie audio BLE

Użyj getAvailableCommunicationDevices, aby sprawdzić, które urządzenia są dostępne do połączenia VoIP. Użyj AudioDeviceInfo, aby sprawdzić, czy urządzenie jest zestawem słuchawkowym BLE. W tym przykładzie szukamy pierwszego urządzenia, które obsługuje BLE Audio, ale możesz też znaleźć wszystkie obsługiwane urządzenia i pozwolić użytkownikom wybrać jedno z nich.

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;
    }
}

Ustaw urządzenie do komunikacji

Gdy znajdziesz zgodne urządzenie, użyj setCommunicationDevice, aby ustawić urządzenie, na które chcesz przekierować połączenie. Sprawdzenie wyniku informuje aplikację, czy menedżer dźwięku próbuje ustawić urządzenie, czy wystąpił błąd.

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)

Po skonfigurowaniu urządzenia audio BLE strumień audio będzie używać prawidłowego routingu audio podczas nawiązywania połączenia.

Zakończ sesję

Gdy aplikacja zakończy połączenie lub sesję, wyczyść aktywne urządzenie komunikacyjne. Dzięki temu użytkownik może wygodnie przechodzić między różnymi aplikacjami.

Kotlin

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

Java

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