Ses Yöneticisi'nin kendi yönettiği arama rehberi

Bu kılavuzda, ses ve işitilebilir cihaz durumunu kendi kendine yönetmek isteyen İnternet Protokolü Üzerinden Ses İletimi (VoIP) gibi iletişim uygulamaları ele alınmaktadır.

Ses geri çağırma işlevini kaydetme

Öncelikle, ses cihazları cihaza bağlandığında veya cihazdan ayrıldığında uygulamanızı bilgilendiren bir AudioDeviceCallback oluşturun.

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

Etkin iletişim cihazı olup olmadığını kontrol etme

Ses yöneticisi, o anda hangi iletişim cihazının etkin olduğunu gösterir.

Kotlin

val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice

Java

AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();

İletişim cihazının ne zaman değiştiğini dinlemek, uygulamanızın yönlendirmenin ne zaman uygulandığını ve seçtiğiniz cihazın ne zaman etkin olduğunu bilmesini sağlar.

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

BLE ses sistemini bulma

VoIP araması için hangi cihazların kullanılabildiğini görmek üzere getAvailableCommunicationDevices simgesini kullanın. Cihazın BLE kulaklık olup olmadığını görmek için AudioDeviceInfo kullanın. Bu örnekte, BLE Audio'yu destekleyen ilk cihaz aranır ancak desteklenen tüm cihazları bulup kullanıcıların seçim yapmasına da izin verebilirsiniz.

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

İletişim cihazını ayarlama

Uyumlu bir cihaz bulduktan sonra, yönlendirmek istediğiniz cihazı ayarlamak için setCommunicationDevice komutunu kullanın. Sonucu kontrol etmek, ses yöneticisinin cihazı ayarlamaya çalışıp çalışmadığını veya bir hatayla karşılaşıp karşılaşmadığını uygulamanıza bildirir.

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)

BLE ses sistemini ayarladıktan sonra, arama yaptığınızda ses akışı doğru ses yönlendirmesini kullanır.

Oturumu sonlandırma

Uygulamanız bir aramayı veya oturumu tamamladıktan sonra etkin iletişim cihazını temizleyin. Bu sayede kullanıcılar farklı uygulamalar arasında geçiş yaparken mükemmel bir deneyim yaşar.

Kotlin

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

Java

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