ऑडियो की सुविधाएं

Android TV डिवाइसों से एक साथ कई ऑडियो आउटपुट कनेक्ट किए जा सकते हैं. जैसे, टीवी के स्पीकर, एचडीएमआई से कनेक्ट किया गया होम सिनेमा, ब्लूटूथ हेडफ़ोन वगैरह. इन ऑडियो डिवाइसों में, ऑडियो से जुड़ी अलग-अलग सुविधाएं हो सकती हैं. जैसे, एन्कोडिंग (Dolby Digital+, DTS, और PCM), सैंपल रेट, और चैनल. उदाहरण के लिए, एचडीएमआई से कनेक्ट किए गए टीवी में कई तरह की एन्कोडिंग की सुविधा होती है. वहीं, ब्लूटूथ हेडफ़ोन में आम तौर पर सिर्फ़ पीसीएम एन्कोडिंग की सुविधा होती है.

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

ऐप्लिकेशन, एक ही कॉन्टेंट को कई एन्कोडिंग में आउटपुट कर सकते हैं. इससे, ऑडियो डिवाइस की सुविधाओं के हिसाब से, उपयोगकर्ता को बेहतर ऑडियो अनुभव मिलता है. उदाहरण के लिए, अगर टीवी में Dolby Digital एन्कोडिंग की सुविधा है, तो Dolby Digital एन्कोड की गई ऑडियो स्ट्रीम चलाई जाती है. वहीं, अगर Dolby Digital एन्कोडिंग की सुविधा नहीं है, तो पीसीएम ऑडियो स्ट्रीम चलाई जाती है, क्योंकि यह ज़्यादातर डिवाइसों पर काम करती है. ऑडियो स्ट्रीम को पीसीएम में बदलने के लिए, Android के बिल्ट-इन डिकोडर की सूची, काम करने वाले मीडिया फ़ॉर्मैट में देखी जा सकती है.

मीडिया चलाने के दौरान, स्ट्रीमिंग ऐप्लिकेशन को AudioTrack बनाना चाहिए. इसमें, आउटपुट ऑडियो डिवाइस के साथ काम करने वाला सबसे अच्छा AudioFormat होना चाहिए.

सही फ़ॉर्मैट वाला ट्रैक बनाना

ऐप्लिकेशन को AudioTrack बनाना चाहिए और उसे चलाना शुरू करना चाहिए. साथ ही, आवाज़ चलाने के लिए डिफ़ॉल्ट ऑडियो डिवाइस का पता लगाने के लिए, getRoutedDevice() को कॉल करना चाहिए. उदाहरण के लिए, यह सुरक्षित और कम समय के लिए साइलेंस पीसीएम एन्कोड किया गया ट्रैक हो सकता है. इसका इस्तेमाल सिर्फ़ रूट किए गए डिवाइस और उसकी ऑडियो सुविधाओं का पता लगाने के लिए किया जाता है.

काम करने वाली एन्कोडिंग पाना

डिफ़ॉल्ट ऑडियो डिवाइस पर उपलब्ध ऑडियो फ़ॉर्मैट का पता लगाने के लिए, getAudioProfiles() (एपीआई लेवल 31 और इसके बाद के लेवल) या getEncodings() (एपीआई लेवल 23 और इसके बाद के लेवल) का इस्तेमाल करें.

काम करने वाले ऑडियो प्रोफ़ाइल और फ़ॉर्मैट की जांच करना

फ़ॉर्मैट, चैनल की संख्या, और सैंपल रेट के काम करने वाले कॉम्बिनेशन की जांच करने के लिए, AudioProfile (एपीआई लेवल 31 और इसके बाद के लेवल) या isDirectPlaybackSupported() (एपीआई लेवल 29 और इसके बाद के लेवल) का इस्तेमाल करें.

कुछ Android डिवाइसों में, आउटपुट ऑडियो डिवाइस के साथ काम करने वाली एन्कोडिंग के अलावा, अन्य एन्कोडिंग की सुविधा भी होती है. isDirectPlaybackSupported() की मदद से, इन अतिरिक्त फ़ॉर्मैट का पता लगाया जाना चाहिए. इन मामलों में, ऑडियो डेटा को ऐसे फ़ॉर्मैट में फिर से एन्कोड किया जाता है जो आउटपुट ऑडियो डिवाइस के साथ काम करता है. isDirectPlaybackSupported() का इस्तेमाल करके, मनचाहे फ़ॉर्मैट के लिए काम करने की सुविधा की सही तरीके से जांच करें. भले ही, यह getEncodings() से मिली सूची में मौजूद न हो.

ध्यान दें: एपीआई लेवल 33 से पहले, isDirectPlaybackSupported() सभी उपलब्ध ऑडियो आउटपुट पाथ को ध्यान में रखता है. भले ही, वे फ़िलहाल रूट न किए गए हों. उदाहरण के लिए, मान लें कि आपने एचडीएमआई और ब्लूटूथ हेडफ़ोन, दोनों को कनेक्ट किया है. एचडीएमआई में डायरेक्ट प्लेबैक की सुविधा है, लेकिन ब्लूटूथ हेडफ़ोन में नहीं. इस मामले में, फ़ंक्शन 'सही' दिखाता है. भले ही, ऑडियो सिर्फ़ ब्लूटूथ हेडफ़ोन पर चल रहा हो और डायरेक्ट AudioTrack न बन पाया हो. FLAG_HW_AV_SYNC सेट करके, डायरेक्ट AudioTrack बनाया जा सकता है. एपीआई लेवल 33 और इसके बाद के लेवल के लिए, यह सिर्फ़ फ़िलहाल चालू ऑडियो रूटिंग को ध्यान में रखता है.

ऑडियो रूटिंग की सुविधा

Android 13 (एपीआई लेवल 33) में, ऑडियो रूटिंग की सुविधा जोड़ी गई है. डिवाइस के ऑडियो एट्रिब्यूट के साथ काम करने की सुविधा का अनुमान लगाया जा सकता है. साथ ही, चालू ऑडियो डिवाइस के लिए ट्रैक तैयार किए जा सकते हैं. यह देखने के लिए कि दिए गए फ़ॉर्मैट और एट्रिब्यूट के लिए, फ़िलहाल रूट किए गए ऑडियो डिवाइस पर डायरेक्ट प्लेबैक की सुविधा है या नहीं, getDirectPlaybackSupport() का इस्तेमाल किया जा सकता है:

Kotlin

val format = AudioFormat.Builder()
    .setEncoding(AudioFormat.ENCODING_E_AC3)
    .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
    .setSampleRate(48000)
    .build()
val attributes = AudioAttributes.Builder()
    .setUsage(AudioAttributes.USAGE_MEDIA)
    .build()

if (AudioManager.getDirectPlaybackSupport(format, attributes) !=
    AudioManager.DIRECT_PLAYBACK_NOT_SUPPORTED
) {
    // The format and attributes are supported for direct playback
    // on the currently active routed audio path
} else {
    // The format and attributes are NOT supported for direct playback
    // on the currently active routed audio path
}
AudioCapabilities.kt

Java

AudioFormat format = new AudioFormat.Builder()
        .setEncoding(AudioFormat.ENCODING_E_AC3)
        .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
        .setSampleRate(48000)
        .build();
AudioAttributes attributes = new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .build();

if (AudioManager.getDirectPlaybackSupport(format, attributes) !=
        AudioManager.DIRECT_PLAYBACK_NOT_SUPPORTED) {
    // The format and attributes are supported for direct playback
    // on the currently active routed audio path
} else {
    // The format and attributes are NOT supported for direct playback
    // on the currently active routed audio path
}

इसके अलावा, यह क्वेरी की जा सकती है कि फ़िलहाल रूट किए गए ऑडियो डिवाइस से, डायरेक्ट मीडिया प्लेबैक के लिए कौनसी प्रोफ़ाइल काम करती हैं. इसमें ऐसी कोई भी प्रोफ़ाइल शामिल नहीं होती जो काम नहीं करती हैं या जिन्हें Android फ़्रेमवर्क से ट्रांसकोड किया जाएगा. उदाहरण के लिए:

Kotlin

private fun findBestAudioFormat(audioAttributes: AudioAttributes): AudioFormat {
    val preferredFormats = listOf(
        AudioFormat.ENCODING_E_AC3,
        AudioFormat.ENCODING_AC3,
        AudioFormat.ENCODING_PCM_16BIT,
        AudioFormat.ENCODING_DEFAULT
    )
    val audioProfiles = audioManager.getDirectProfilesForAttributes(audioAttributes)
    val bestAudioProfile = preferredFormats.firstNotNullOf { format ->
        audioProfiles.firstOrNull { it.format == format }
    }
    val sampleRate = findBestSampleRate(bestAudioProfile)
    val channelMask = findBestChannelMask(bestAudioProfile)
    return AudioFormat.Builder()
        .setEncoding(bestAudioProfile.format)
        .setSampleRate(sampleRate)
        .setChannelMask(channelMask)
        .build()
}
AudioCapabilities.kt

Java

private AudioFormat findBestAudioFormat(AudioAttributes audioAttributes) {
    Stream<Integer> preferredFormats = Stream.<Integer>builder()
            .add(AudioFormat.ENCODING_E_AC3)
            .add(AudioFormat.ENCODING_AC3)
            .add(AudioFormat.ENCODING_PCM_16BIT)
            .add(AudioFormat.ENCODING_DEFAULT)
            .build();
    Stream<AudioProfile> audioProfiles =
            audioManager.getDirectProfilesForAttributes(audioAttributes).stream();
    AudioProfile bestAudioProfile = (AudioProfile) preferredFormats.map(format ->
            audioProfiles.filter(profile -> profile.getFormat() == format)
                    .findFirst()
                    .orElseThrow(NoSuchElementException::new)
    );
    Integer sampleRate = findBestSampleRate(bestAudioProfile);
    Integer channelMask = findBestChannelMask(bestAudioProfile);
    return new AudioFormat.Builder()
            .setEncoding(bestAudioProfile.getFormat())
            .setSampleRate(sampleRate)
            .setChannelMask(channelMask)
            .build();
}

इस उदाहरण में, preferredFormats इंस्टेंस की सूची है AudioFormat. इसे सूची में सबसे ज़्यादा प्राथमिकता वाले फ़ॉर्मैट से लेकर सबसे कम प्राथमिकता वाले फ़ॉर्मैट के क्रम में रखा जाता है. getDirectProfilesForAttributes() दिए गए AudioAttributes के साथ, फ़िलहाल रूट किए गए ऑडियो डिवाइस के लिए, काम करने वाले AudioProfile ऑब्जेक्ट की सूची दिखाता है. मिलते-जुलते AudioProfile के मिलने तक, प्राथमिकता वाले AudioFormat आइटम की सूची को दोहराया जाता है. इस AudioProfile को bestAudioProfile के तौर पर सेव किया जाता है. bestAudioProfile से, सबसे अच्छे सैंपल रेट और चैनल मास्क तय किए जाते हैं. आखिर में, सही AudioFormat इंस्टेंस बनाया जाता है.

ऑडियो ट्रैक बनाना

ऐप्लिकेशन को इस जानकारी का इस्तेमाल करके, डिफ़ॉल्ट ऑडियो डिवाइस के साथ काम करने वाले सबसे अच्छी क्वालिटी के AudioFormat के लिए AudioTrack बनाना चाहिए. साथ ही, यह फ़ॉर्मैट चुने गए कॉन्टेंट के लिए उपलब्ध होना चाहिए.

ऑडियो डिवाइस में होने वाले बदलावों को रोकना

ऑडियो डिवाइस में होने वाले बदलावों को रोकने और उन पर कार्रवाई करने के लिए, ऐप्लिकेशन को ये काम करने चाहिए:

• एपीआई लेवल 24 या इसके बाद के लेवल के लिए, ऑडियो डिवाइस में होने वाले बदलावों (एचडीएमआई, ब्लूटूथ वगैरह) पर नज़र रखने के लिए, OnRoutingChangedListener जोड़ें.
• एपीआई लेवल 23 के लिए, उपलब्ध ऑडियो डिवाइस की सूची में होने वाले बदलावों की जानकारी पाने के लिए, AudioDeviceCallback रजिस्टर करें.
• एपीआई लेवल 21 और 22 के लिए, एचडीएमआई प्लग इवेंट पर नज़र रखें और ब्रॉडकास्ट से मिले अतिरिक्त डेटा का इस्तेमाल करें.
• एपीआई लेवल 23 से पहले के डिवाइसों के लिए, BroadcastReceiver की स्थिति में होने वाले बदलावों पर नज़र रखने के लिए, BluetoothDevice भी रजिस्टर करें. ऐसा इसलिए, क्योंकि AudioDeviceCallback की सुविधा अभी उपलब्ध नहीं है.

AudioTrack के लिए, ऑडियो डिवाइस में होने वाले बदलाव का पता चलने पर, ऐप्लिकेशन को ऑडियो की अपडेट की गई सुविधाओं की जांच करनी चाहिए. साथ ही, ज़रूरत पड़ने पर, AudioTrack को किसी दूसरे AudioFormat के साथ फिर से बनाना चाहिए. ऐसा तब करें, जब अब बेहतर क्वालिटी की एन्कोडिंग की सुविधा उपलब्ध हो या पहले इस्तेमाल की गई एन्कोडिंग की सुविधा अब उपलब्ध न हो.

ध्यान दें: अब काम न करने वाले फ़ॉर्मैट में AudioTrack में डेटा लिखने पर, फ़्रेमवर्क से गड़बड़ियां ट्रिगर हो सकती हैं. (जैसे, “AudioTrack के नेटिव रीड के दौरान गड़बड़ी -32“). ये गड़बड़ियां, ऑडियो रूटिंग में बदलाव के लिए कॉलबैक को कॉल किए जाने से पहले भी हो सकती हैं. इन गड़बड़ियों को रोकें और नए रूट किए गए डिवाइस की सुविधाओं के हिसाब से, AudioTrack को फिर से बनाएं.

सैंपल कोड

Kotlin

// audioPlayer is a wrapper around an AudioTrack
// which calls a callback for an AudioTrack write error
audioPlayer.addAudioTrackWriteErrorListener {
    // error code can be checked here,
    // in case of write error try to recreate the audio track
    restartAudioTrack(findDefaultAudioDeviceInfo())
}

audioPlayer.audioTrack.addOnRoutingChangedListener({ audioRouting ->
    audioRouting?.routedDevice?.let { audioDeviceInfo ->
        // use the updated audio routed device to determine
        // what audio format should be used
        if (needsAudioFormatChange(audioDeviceInfo)) {
            restartAudioTrack(audioDeviceInfo)
        }
    }
}, handler)
AudioCapabilities.kt

Java

// audioPlayer is a wrapper around an AudioTrack
// which calls a callback for an AudioTrack write error
audioPlayer.addAudioTrackWriteErrorListener(new AudioTrackPlayer.AudioTrackWriteError() {
    @Override
    public void audioTrackWriteError(int errorCode) {
        // error code can be checked here,
        // in case of write error try to recreate the audio track
        restartAudioTrack(findDefaultAudioDeviceInfo());
    }
});

audioPlayer.getAudioTrack().addOnRoutingChangedListener(new AudioRouting.OnRoutingChangedListener() {
    @Override
    public void onRoutingChanged(AudioRouting audioRouting) {
        if (audioRouting != null && audioRouting.getRoutedDevice() != null) {
            AudioDeviceInfo audioDeviceInfo = audioRouting.getRoutedDevice();
            // use the updated audio routed device to determine
            // what audio format should be used
            if (needsAudioFormatChange(audioDeviceInfo)) {
                restartAudioTrack(audioDeviceInfo);
            }
        }
    }
}, handler);