🕳️ 👨‍💻 🧝🏿 ऑडियोफोकस - ऑडियो सबसिस्टम तक पहुंच नियंत्रण 🎯 🛃 👩🏻‍💻

यह क्रिस्टन उक्लो, Google डेवलपर संबंधों द्वारा ऑडियो फोकस लेख का सम्मान करने का अनुवाद है

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

ऑडियो फोकस अनुरोध

लालची होने की आवश्यकता नहीं है और आवेदन की शुरुआत में ऑडियो फोकस का अनुरोध करें; जब तक एप्लिकेशन ऑडियो स्ट्रीम के साथ कुछ करना शुरू नहीं करता है तब तक इंतजार करना बेहतर है। AudioManager सेवा के माध्यम से ऑडियो फोकस प्राप्त करते समय, आप वांछित फ़ोकस मोड को इंगित करने के लिए AUDIOFOCUS_GAIN * स्थिरांक का उपयोग कर सकते हैं।

फ़ोकस अनुरोध उदाहरण

AudioManager am = (AudioManager) mContext.getSystemService(Context.AUDIO_SERVICE); int result = am.requestAudioFocus(mOnAudioFocusChangeListener, // Hint: the music stream. AudioManager.STREAM_MUSIC, // Request permanent focus. AudioManager.AUDIOFOCUS_GAIN); if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {  mState.audioFocusGranted = true; } else if (result == AudioManager.AUDIOFOCUS_REQUEST_FAILED) {  mState.audioFocusGranted = false; }

उदाहरण में, हम एक निरंतर ऑडियो फ़ोकस का अनुरोध करते हैं। इसके बजाय, हम एक अस्थायी ( AUDIOFOCUS_GAIN_TRANSIENT ) फ़ोकस का अनुरोध कर सकते हैं, जो 45 सेकंड तक चलने वाली ध्वनियों को चलाने के लिए उपयुक्त है।
एक अन्य एप्लिकेशन उन स्थितियों के लिए " क्वैकिंग " मोड ( AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK ) का उपयोग कर सकता है, जहां ऑडियो सबसिस्टम को अन्य एप्लिकेशन के साथ साझा किया जा सकता है (उदाहरण के लिए, वाक्यांश "फिटनेस एप्लिकेशन में" और अधिक जलने के लिए, उम्मीद है कि पृष्ठभूमि संगीत बाधित नहीं होगा)। "क्वैक" मोड में फ़ोकस करने का अनुरोध करने वाले एप्लिकेशन को लगातार 15 सेकंड से अधिक समय तक ऑडियो सबसिस्टम का उपयोग नहीं करना चाहिए।

हम ऑडियो फ़ोकस की स्थिति में परिवर्तन की प्रक्रिया करते हैं

ऑडियो फोकस स्थिति परिवर्तन घटनाओं को संभालने के लिए, एक एप्लिकेशन को एक OnAudioFocusChangeListener उदाहरण बनाना होगा। इस हैंडलर में, आपको AUDIOFOCUS_GAIN * और AUDIOFOCUS_LOSS * घटनाओं को संभालने की आवश्यकता है। यह ध्यान देने योग्य है कि AUDIOFOCUS_GAIN घटना में दूसरे उदाहरण में वर्णित कई विशेषताएं हैं।

इवेंट हैंडलिंग उदाहरण

 mOnAudioFocusChangeListener = new AudioManager.OnAudioFocusChangeListener() { @Override public void onAudioFocusChange(int focusChange) { switch (focusChange) { case AudioManager.AUDIOFOCUS_GAIN:  mState.audioFocusGranted = true;     if(mState.released) {   initializeMediaPlayer();  }  switch(mState.lastKnownAudioFocusState) {  case UNKNOWN:   if(mState.state == PlayState.PLAY && !mPlayer.isPlaying()) {    mPlayer.start();   }   break;  case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:   if(mState.wasPlayingWhenTransientLoss) {    mPlayer.start();   }   break;  case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:   restoreVolume();   break;  }     break; case AudioManager.AUDIOFOCUS_LOSS:  mState.userInitiatedState = false;  mState.audioFocusGranted = false;  teardown();  break; case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:  mState.userInitiatedState = false;  mState.audioFocusGranted = false;  mState.wasPlayingWhenTransientLoss = mPlayer.isPlaying();  mPlayer.pause();  break; case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:  mState.userInitiatedState = false;  mState.audioFocusGranted = false;  lowerVolume();  break; } mState.lastKnownAudioFocusState = focusChange; } };

AUDIOFOCUS_GAIN निरंतर का उपयोग कोड में दो अलग-अलग भूमिकाओं में किया जाता है। सबसे पहले, उदाहरण के रूप में ऑडियो फ़ोकस प्राप्त करने के लिए। 1. इसी समय, ऑनएडियोफोकसचेंज लाइस्टेनर इवेंट ऑडियो फोकस के सफल अनुरोध (और रसीद) पर नहीं होता है, हैंडलर को संबंधित AUDIOFUSUS_GAIN इवेंट प्राप्त नहीं होगा।
AUDIOFOCUS_GAIN का उपयोग इवेंट संस्करण के रूप में OnAudioFocusChangeListener कार्यान्वयन में भी किया जाता है। जैसा कि पहले संकेत दिया गया है, ऑडियो फोकस अनुरोध किए जाने पर AUDIOFOCUS_GAIN इवेंट नहीं उठाया गया है। इसके विपरीत, यह संबंधित घटना के बाद ही हो सकता है, AUDIOFOCUS_LOSS *, होता है । AUDIOFOCUS_GAIN एकमात्र स्थिरांक है जिसका उपयोग दोनों स्थितियों में किया जाता है।
ऑडियो फोकस राज्य परिवर्तन घटना के इवेंट हैंडलर में चार स्थितियों पर विचार करने की आवश्यकता है। जब कोई अनुप्रयोग AUDIOFOCUS_LOSS ईवेंट प्राप्त करता है, तो इसका आमतौर पर मतलब होता है कि यह ऑडियो फ़ोकस वापस प्राप्त नहीं करेगा। इस मामले में, एप्लिकेशन को ऑडियो सबसिस्टम से जुड़े संसाधनों को खाली करना चाहिए और प्लेबैक को रोकना चाहिए। एक उदाहरण के रूप में, कल्पना करें कि उपयोगकर्ता आपके एप्लिकेशन के माध्यम से संगीत सुनता है, और फिर एक गेम लॉन्च करता है जो ऑडियो प्लेयर से ऑडियो फोकस को दूर ले जाता है। यह अनुमान लगाना असंभव है कि उपयोगकर्ता खेल को कब तक बंद कर देगा। सबसे अधिक संभावना है, वह मुख्य स्क्रीन पर जाएगा (पृष्ठभूमि में खेल छोड़कर) और एक और एप्लिकेशन लॉन्च करेगा। या वह अपने काम को फिर से शुरू करते हुए संगीत खिलाड़ी के पास लौट आएगा, जिसे ओनडेम में ऑडियो फोकस के लिए एक नए अनुरोध की आवश्यकता होगी।
हालाँकि, एक और मामला चर्चा के योग्य है। स्थायी रूप से (ऊपर उदाहरण में) या अस्थायी रूप से ऑडियो फ़ोकस खोने के बीच अंतर है। जब कोई अनुप्रयोग AUDIOFOCUS_LOSS_TRANSIENT ईवेंट प्राप्त करता है, तो यह अपेक्षा की जाती है कि जब तक यह AUDIOFOCUS_GAIN ईवेंट प्राप्त नहीं होता है तब तक एप्लिकेशन ऑडियो उपयोग को निलंबित कर देगा। जब AUDIOFOCUS_LOSS_TRANSIENT ईवेंट होता है, तो एप्लिकेशन को यह याद रखना चाहिए कि फ़ोकस के वापस आने पर यह पता लगाने के लिए कि फोकस सही है या नहीं, यह जानने के लिए फ़ोकस का नुकसान अस्थायी है। (उदाहरण 2 देखें)।
कभी-कभी कोई एप्लिकेशन ऑडियो फ़ोकस खो देता है (यानी, यह AUDIOFOCUS_LOSS प्राप्त करता है), और एक बाधित अनुप्रयोग समाप्त हो जाता है, या किसी अन्य तरीके से ऑडियो फ़ोकस खो देता है। इस स्थिति में, अंतिम अनुप्रयोग जिसमें ऑडियो फ़ोकस था, वह AUDIOFOCUS_GAIN ईवेंट प्राप्त कर सकता है।
बाद के AUDIOFOCUS_GAIN इवेंट में, एप्लिकेशन को यह समझना चाहिए कि क्या उसे अस्थायी नुकसान के बाद ऑडियो फ़ोकस प्राप्त हुआ है और उसे प्लेबैक को फिर से शुरू करना चाहिए, या फ़ोकस के पूर्ण नुकसान के बाद प्लेबैक को पुनर्स्थापित करना और समायोजित करना चाहिए।
यदि एप्लिकेशन केवल थोड़े समय (45 सेकंड से अधिक नहीं) के लिए ऑडियो का उपयोग करता है, तो उसे ऑडियोफोकस_जीआईएन_टीआरआरएसआईएसआईएनयूएनटेंट मोड में ऑडियो फोकस का अनुरोध करना चाहिए और प्लेबैक या रिकॉर्डिंग समाप्त होने के तुरंत बाद इसे जारी करना चाहिए। सिस्टम में ऑडियो फ़ोकस को एक स्टैक की तरह माना जाता है: फ़ोकस उस एप्लिकेशन को दिया जाता है जिसके पास अंतिम स्वामित्व होता है।
जब ऑडियो फोकस प्राप्त होता है, तो MediaPlayer या MediaRecorder और आरक्षित संसाधन बनाने का समय आ जाता है। इसके अलावा, जब कोई अनुप्रयोग AUDIOFOCUS_LOSS प्राप्त करता है, तो सभी आरक्षित संसाधनों को मुक्त करने के लिए यह अच्छा अभ्यास है। ऑडियो फ़ोकस प्राप्त करने के तीन विकल्प हैं, फ़ोकस खोने के विभिन्न विकल्पों के अनुरूप। OnAudioFocusChangeListener हैंडलर में फ़ोकस खोने के सभी विकल्पों को स्पष्ट रूप से संभालना अच्छा होगा।

तालिका 1 । ऑडियो फोकस के लाभ और हानि के स्थिरांक का अर्थ है

लाभ	हानि
AUDIOFOCUS_GAIN	AUDIOFOCUS_LOSS
AUDIOFOCUS_GAIN_TRANSIENT (*)	AUDIOFOCUS_LOSS_TRANSIENT
AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK (*)	AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK

नोट: निरंतर का उपयोग दो स्थानों पर किया जाता है। जब ऑडियो फ़ोकस का अनुरोध किया जाता है, तो इसे ऑडियो मैनजर संकेत के रूप में प्रसारित किया जाता है; इसका उपयोग OnAudioFocusChangeListener में एक ईवेंट विकल्प के रूप में भी किया जाता है। फोकस लाभ स्थिरांक, (*) से संकेत मिलता है, केवल ऑडियो फोकस का अनुरोध करते समय उपयोग किया जाता है। फोकस हानि स्थिरांक का उपयोग केवल OnAudioFocusChangeListener हैंडलर में किया जाता है।

तालिका 2 । ऑडियो स्ट्रीम के प्रकार।

टाइप	विवरण
STREAM_ALARM	अलार्म घड़ी
STREAM_DTMF	टोन डायल
STREAM_MUSIC	मल्टीमीडिया प्लेबैक (संगीत, पॉडकास्ट, वीडियो)
STREAM_NOTIFICATION	नोटिस
STREAM_RING	फोन कॉल
STREAM_SYSTEM	सिस्टम लगता है

आवेदन AudioManager से ऑडियो फ़ोकस का अनुरोध करता है (उदाहरण के लिए लेख के अंत में लिंक द्वारा)। पैरामीटर एक वैकल्पिक हैंडलर हैं, ऑडियो चैनल (तालिका 2) के प्रकार के साथ एक संकेत और तालिका 1 से ऑडियो फोकस का प्रकार। ऑडियो का कोई भी इनिशियलाइज़ेशन केवल तभी किया जाना चाहिए जब सिस्टम ऑडियो फ़ोकस प्राप्त करने की अनुमति देता है (AudioManager। AUDIOFOCUS_RQUEST_GRANTED )।
नोट: यदि टेलीफ़ोन वार्तालाप होता है, तो सिस्टम ऑडियो फ़ोकस ( AUDIOFOCUS_REQUEST_FAILED ) प्राप्त करने की अनुमति नहीं देगा और कॉल समाप्त होने के बाद आवेदन को AUDIOFOCUS_GAIN नहीं भेजेगा।
OnAudioFocusChange () घटनाओं के लिए अनुप्रयोग की प्रतिक्रिया का एक संक्षिप्त विवरण तालिका 3 में वर्णित है।
ऑडियो फ़ोकस के नुकसान के मामले में, आपको सुनिश्चित होना चाहिए कि फ़ोकस पूरी तरह से खो गया है। यदि आवेदन ईवेंट AUDIOFOCUS_LOSS_TRANSIENT या AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK प्राप्त करता है, तो यह आरक्षित संसाधन (रिलीज़ को कॉल न करें) () को पकड़ सकता है, क्योंकि सबसे अधिक संभावना है कि ऑडियो फोकस बदलने की एक नई घटना जल्द ही होगी। यह कुछ ध्वज में फ़ोकस के अस्थायी नुकसान के बारे में या राज्य ग्राफ के एक अलग शीर्ष पर जाने के बारे में जानकारी सहेजने के लायक है।
यदि एप्लिकेशन AUDIOFOCUS_GAIN मोड में लगातार ऑडियो फ़ोकस का अनुरोध करता है और AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK ईवेंट प्राप्त करता है, तो उचित प्रतिक्रिया वॉल्यूम को बंद करने के लिए होगी (पुराने वॉल्यूम मान रखने के लिए मत भूलना) और फिर AUDIOFOCUS_GAIN इवेंट (चित्र देखें) प्राप्त करते समय वॉल्यूम वापस करें।

तालिका 3 । अनुप्रयोग की प्रतिक्रिया जब ऑडियो फोकस की स्थिति बदलती है।

फोकस का प्रकार बदल जाता है	प्रतिक्रिया
AUDIOFOCUS_GAIN	फ़ोकस इवेंट के नुकसान के बाद ईवेंट प्राप्त करें : यदि एप्लिकेशन स्टेट इस विरोधाभास नहीं करता है तो मीडिया प्लेबैक फिर से शुरू करें। उदाहरण के लिए, उपयोगकर्ता को फ़ोकस लॉस इवेंट से पहले रोका गया।
AUDIOFOCUS_LOSS	बंद करो प्लेबैक, मुक्त संसाधनों
AUDIOFOCUS_LOSS_TRANSIENT	प्लेबैक रोकें और उस फ़्लैग को सहेजें जो फ़ोकस लॉस अस्थायी है, ताकि जब AUDIOFOCUS_GAIN को संसाधित किया जाए तो यदि आवश्यक हो तो प्लेबैक को फिर से शुरू करना संभव है। संसाधन जारी न करें।
AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK	AUDIOFOCUS_LOSS_TRANSIENT के मामले में स्थिति की निगरानी करना न भूलें, वॉल्यूम को शांत या प्लेबैक को रोकें। संसाधन जारी न करें।

निष्कर्ष और क्या पढ़ना है

एंड्रॉइड डिवाइस पर ऑडियो एप्लिकेशन के शिविर में "अनुकरणीय नागरिक" होने का मतलब है कि ऑडियो फोकस के साथ काम करने और सभी स्थितियों को सही ढंग से संभालने के लिए नियमों का सम्मान करना। अपने एप्लिकेशन को एक उचित तरीके से बनाने की कोशिश करें और उपयोगकर्ता को अप्रिय आश्चर्य के साथ प्रस्तुत न करें। आप एंड्रॉइड ऑडियो सबसिस्टम के बारे में बहुत कुछ बता सकते हैं, इसके बारे में अधिक पढ़ने के लिए नीचे दिए गए लिंक का पालन करें।

ऑडियो फोकस का प्रबंधन , Android डेवलपर्स संसाधन पर एक सबक।
एक दूसरे के साथ अच्छा खेलने के लिए एप्लिकेशन की अनुमति देना: रिमोट कंट्रोल बटन , एंड्रॉइड डेवलपर्स ब्लॉग ब्लॉग पोस्ट को हैंडल करना।

लेख के स्रोत कोड यहां उपलब्ध हैं:
https://android.googlesource.com/platform/development/+/master/samples/RandomMusicPlayer

ऑडियोफोकस - ऑडियो सबसिस्टम तक पहुंच नियंत्रण

ऑडियो फोकस अनुरोध

हम ऑडियो फ़ोकस की स्थिति में परिवर्तन की प्रक्रिया करते हैं

निष्कर्ष और क्या पढ़ना है

More articles: