ऑडियो मैनेजर की मदद से मैनेज की जाने वाली कॉल गाइड

इस गाइड में, वॉइस ओवर इंटरनेट प्रोटोकॉल (वीओआईपी) जैसे कम्यूनिकेशन ऐप्लिकेशन के बारे में बताया गया है. ये ऐप्लिकेशन, अपने ऑडियो और सुनने वाले डिवाइस की स्थिति को खुद मैनेज करना चाहते हैं.

ऑडियो कॉलबैक रजिस्टर करना

सबसे पहले, एक AudioDeviceCallback बनाएं. इससे आपके ऐप्लिकेशन को सूचना मिलती है कि डिवाइस से ऑडियो डिवाइस कनेक्ट या डिसकनेक्ट हो गए हैं.

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

देखें कि कम्यूनिकेशन के लिए इस्तेमाल किया जा रहा डिवाइस चालू है या नहीं

ऑडियो मैनेजर से आपको पता चलता है कि फ़िलहाल कौनसा कम्यूनिकेशन डिवाइस चालू है.

Kotlin

val currentCommunicationDevice: AudioDeviceInfo? = audioManager.communicationDevice

Java

AudioDeviceInfo currentCommunicationDevice = audioManager.getCommunicationDevice();

कम्यूनिकेशन डिवाइस में बदलाव होने पर, आपके ऐप्लिकेशन को पता चलता है कि रूटिंग कब लागू की गई है और आपका चुना गया डिवाइस कब चालू है.

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

बीएलई ऑडियो डिवाइस ढूंढना

getAvailableCommunicationDevices का इस्तेमाल करके देखें कि वीओआईपी कॉल के लिए कौनसे डिवाइस उपलब्ध हैं. AudioDeviceInfo का इस्तेमाल करके देखें कि डिवाइस, बीएलई हेडसेट है या नहीं. इस उदाहरण में, बीएलई ऑडियो की सुविधा वाले पहले डिवाइस को खोजा गया है. हालांकि, आपके पास इस सुविधा वाले सभी डिवाइसों को खोजने और उपयोगकर्ताओं को चुनने का विकल्प भी है.

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

कम्यूनिकेशन डिवाइस सेट करें

इसके साथ काम करने वाला डिवाइस ढूंढने के बाद, setCommunicationDevice का इस्तेमाल करके वह डिवाइस सेट करें जिस पर आपको ऑडियो रूट करना है. नतीजे की जांच करने से आपके ऐप्लिकेशन को पता चलता है कि ऑडियो मैनेजर, डिवाइस को सेट करने की कोशिश कर रहा है या उसे कोई गड़बड़ी मिली है.

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)

बीएलई ऑडियो डिवाइस सेट करने के बाद, कॉल करने पर ऑडियो स्ट्रीम सही ऑडियो रूटिंग का इस्तेमाल करती है.

सेशन खत्म करना

जब आपके ऐप्लिकेशन पर कोई कॉल या सेशन खत्म हो जाए, तो ऐक्टिव कम्यूनिकेशन डिवाइस को हटा दें. इससे यह पक्का करने में मदद मिलती है कि उपयोगकर्ता को एक से दूसरे ऐप्लिकेशन पर स्विच करते समय अच्छा अनुभव मिले.

Kotlin

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

Java

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