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

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

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

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

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

सही फ़ॉर्मैट में ट्रैक बनाना

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

इस्तेमाल किए जा सकने वाले एन्कोडिंग के बारे में जानकारी पाना

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

इस्तेमाल किए जा सकने वाले ऑडियो फ़ॉर्मैट और प्रोफ़ाइलें देखना

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

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

ऑडियो रूट का अनुमान लगाना

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

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
}

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 फ़्रेमवर्क ट्रांसकोड करेगा. उदाहरण के लिए:

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()
}

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 ऑब्जेक्ट की सूची मिलती है. पसंदीदा AudioFormat आइटम की सूची में तब तक दोहराव होता है, जब तक कि कोई मेल खाने वाला AudioProfile नहीं मिल जाता. इस AudioProfile को bestAudioProfile के तौर पर सेव किया जाता है. सबसे सही सैंपल रेट और चैनल मास्क, bestAudioProfile से तय किए जाते हैं. आखिर में, AudioFormat का सही इंस्टेंस बनाया जाता है.

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

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

ऑडियो डिवाइस में किए गए बदलावों को इंटरसेप्ट करना

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

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

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

नमूना कोड

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

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