ऐसे मीडिया ऐप्लिकेशन जो Android फ़ोन पर Google Assistant के साथ आवाज़ से इंटरैक्ट करते हैं, कार, टीवी, और हेडफ़ोन, Android मीडिया सेशन एपीआई से चलते हैं और मीडिया से जुड़ी कार्रवाइयों का इस्तेमाल करते हैं. मीडिया ऐक्शन की लाइफ़साइकल को फ़ॉलो करना मुश्किल हो सकता है. यहां तक कि खोज से एक साधारण प्ले भी अनुरोध में कई मध्यवर्ती चरण होते हैं, जिनमें कुछ गलत हो सकता है, जैसा कि आसान टाइमलाइन:
मीडिया कंट्रोलर टेस्ट (एमसीटी) ऐप से आपको Android पर मीडिया प्लेबैक की बारीकियों की जांच करने में मदद मिलती है और अपने मीडिया सेशन के लागू होने की पुष्टि करें.
MCT आपके ऐप्लिकेशन के MediaController
के बारे में जानकारी दिखाती है, जैसे कि
PlaybackState
और मेटाडेटा की जानकारी है. इसका इस्तेमाल, इंटर-ऐप्लिकेशन मीडिया कंट्रोल की जांच करने के लिए किया जा सकता है.
MCT में पुष्टि की जांच करने की सुविधा भी शामिल है
फ़्रेमवर्क को ध्यान में रखकर बनाया गया है,
की मदद से, आपकी QA जांच को ऑटोमेट किया जा सकता है.
MCT का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन में मीडिया ब्राउज़र सेवा होनी चाहिए और आपको MCT को उससे कनेक्ट करने की अनुमति देनी होगी. यहां जाएं: मीडिया ब्राउज़र सर्विस बनाना हमारा वीडियो देखें.
MCT शुरू करना
![MCT लॉन्च पेज](https://developer.android.com/static/media/images/MCT/MCT-Launch-Screen.png?authuser=9&hl=hi)
MCT लॉन्च करने पर आपको दो सूचियां दिखेंगी:
- ऐक्टिव मीडिया सेशन - MCT लॉन्च करने पर, शुरुआत में यह सूची खाली रहती है साथ ही, आपको "कोई मीडिया ऐप्लिकेशन नहीं मिला. सूचना ऐक्टिव मीडिया सेशन को स्कैन करने के लिए, लिसनर की अनुमति ज़रूरी है." सेटिंग पर क्लिक करके अनुमतियां स्क्रीन पर जाएं और MCT के लिए अनुमति चालू करें.
- MediaBrowserService लागू करने से जुड़ी कार्रवाइयां - इस सूची में ऐसे ऐप्लिकेशन दिखते हैं जिनमें मीडिया ब्राउज़र सेवा लागू की गई है. अगर आपने मीडिया ब्राउज़र सेवा लागू की है, तो आपका ऐप्लिकेशन इस सूची में दिखेगा, लेकिन आप MCT का इस्तेमाल सिर्फ़ तब कर सकते हैं, जब आपने अपने ऐप्लिकेशन को कनेक्शन बनाया या MCT को अनुमति वाली सूची में जोड़ा. इसके साथ क्लाइंट कनेक्शन नियंत्रित करना onGetRoot() हमारा वीडियो देखें.
फ़ोन ऐप्लिकेशन की मैन्युअल तरीके से जांच करना
अगर आपने MCT को अपने ऐप्लिकेशन की मीडिया ब्राउज़र सेवा से कनेक्ट करने की अनुमति दी है, तो आपका ऐप्लिकेशन मीडिया ब्राउज़र सेवा सूची लागू करने की सूची में दी गई है. इसे वहां पाएं और अपने ऐप्लिकेशन को बैकग्राउंड में शुरू करने के लिए, कंट्रोल पर क्लिक करें.
अगर ऐसा नहीं है, तो पहले आपको बैकग्राउंड में अपना ऐप्लिकेशन खुद चलाना होगा. इसके बाद, चालू मीडिया सेशन की सूची में दिखने पर, कंट्रोल करें.
तैयारी करें और खेलें
जब MCT आपके ऐप्लिकेशन को कंट्रोल करना शुरू करती है, तब यह ऐप्लिकेशन का मौजूदा सेशन दिखाती है मेटाडेटा: मौजूदा समय में चुना गया मीडिया और सेशन में की जाने वाली कार्रवाइयां तैयार रहते हैं.
![कंट्रोल पेज](https://developer.android.com/static/media/images/MCT/audio-focus.png?authuser=9&hl=hi)
MCT कंट्रोल पेज के सबसे ऊपर एक ड्रॉप-डाउन मेन्यू होता है, जहां टेक्स्ट फ़ील्ड के साथ Search, यूआरआई, मीडिया आईडी या कोई नहीं ताकि खोज, यूआरआई, या मीडिया आईडी से जुड़ा इनपुट डेटा तय किया जाए, उनमें से किसी एक विकल्प को चुनें.
टेक्स्ट फ़ील्ड के ठीक नीचे मौजूद तैयार करें और खेलें बटन, यह काम करते हैं:
सही कॉल (onPrepare()
, onPrepareFromSearch()
, onPrepareFromUri()
,
onPrepareFromMediaId()
, onPlay()
, onPlayFromSearch()
, onPlayFromUri()
,
onPlayFromMediaId()
) आपकी चुनी हुई कार्रवाई के आधार पर तय होता है.
ऑडियो फ़ोकस की जांच की जा रही है
अच्छी तरह काम करने वाले मीडिया ऐप्लिकेशन के पास ऑडियो की सुविधा इस्तेमाल करने की सुविधा होनी चाहिए फ़ोकस. ऑडियो फ़ोकस की जांच चलाने के लिए आपके पास एक अन्य ऑडियो ऐप्लिकेशन होना चाहिए. MCT कंट्रोल पेज में ऐसा बटन जो ऑडियो फ़ोकस का अनुरोध करता है और उसे रिलीज़ करता है.
ऑडियो फ़ोकस की जांच करने के लिए, यह तरीका अपनाएं:
- समय के तीन संकेतों में से किसी एक को चुनने के लिए, ऑडियो फ़ोकस ड्रॉप-डाउन मेन्यू का इस्तेमाल करें
AUDIOFOCUS_GAIN
,AUDIOFOCUS_GAIN_TRANSIENT
याAUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
. - फ़ोकस का अनुरोध करने के लिए बटन दबाएं.
- फ़ोकस को हटाने के लिए, बटन को फिर से दबाएं.
ट्रांसपोर्ट कंट्रोल की जांच करना
![ट्रांसपोर्ट कंट्रोल की जांच करना](https://developer.android.com/static/media/images/MCT/MCT-Controller-Screen.png?authuser=9&hl=hi)
MCT का यूज़र इंटरफ़ेस (यूआई) व्यू देखने के लिए, बाईं ओर स्वाइप करें. यह व्यू इसमें मानक मीडिया कंट्रोलर के ट्रांसपोर्ट बटन होते हैं और यह सेशन की प्रोग्राम की इमेज और डेटा. बंद किए गए ट्रांसपोर्ट बटन के चारों ओर सर्कल होता है नारंगी. अन्य सभी सक्रिय हैं.
ट्रांसपोर्ट बटन का इस्तेमाल करके, अपने प्लेयर को टेस्ट करें. ट्रांसपोर्ट बटन की स्थिति उम्मीद के मुताबिक बदलाव होना चाहिए. उदाहरण के लिए, 'चलाएं' बटन दबाने पर बंद हो जाना चाहिए, और 'रोकें' और 'रोकें' बटन चालू हो जाएँ.
वैकल्पिक कार्रवाइयां दिखाने वाले व्यू के लिए, फिर से बाईं ओर स्वाइप करें. हर कार्रवाई जिसमें यह बताया गया हो कि वह चालू है या नहीं. अगर यह चालू है, तो उस कार्रवाई पर क्लिक करें.
अगर आपने उन ऐप्लिकेशन की सूची से कनेक्ट किया है जिनमें मीडिया ब्राउज़र सेवा है, तो अपने ऐप्लिकेशन के कॉन्टेंट को देखने के लिए, दो बार और बाईं ओर स्वाइप करें खोजें या कॉन्टेंट ट्री खोजें.
वीडियो ऐप्लिकेशन की मैन्युअल तरीके से जांच करना
वीडियो ऐप्लिकेशन कंट्रोलर की जांच करने के लिए, स्प्लिट स्क्रीन मोड का इस्तेमाल करें. सबसे पहले, अपना वीडियो ऐप्लिकेशन खोलें और फिर MCT को स्प्लिट स्क्रीन मोड में खोलें.
पुष्टि की जांच की जा रही है
पुष्टि की प्रक्रिया का फ़्रेमवर्क, एक-क्लिक में ऐसे टेस्ट करने की सुविधा देता है जिन्हें चलाया जा सकता है पक्का करें कि आपका मीडिया ऐप्लिकेशन, वीडियो चलाने के अनुरोध का सही तरीके से जवाब देता हो.
फ़ोन ऐप्लिकेशन की जांच करना
![टेस्ट बटन](https://developer.android.com/static/media/images/MCT/MCT-Test-Button.png?authuser=9&hl=hi)
पुष्टि की जांच को ऐक्सेस करने के लिए, मीडिया के बगल में मौजूद जांच करें बटन पर क्लिक करें है.
MCT स्थिति
![मीडिया कंट्रोल की स्थिति](https://developer.android.com/static/media/images/MCT/MCT-Testing-Info-Screen.png?authuser=9&hl=hi)
अगले व्यू में आपको एमसीटी के MediaController
के बारे में ज़्यादा जानकारी दिखेगी,
उदाहरण के लिए, PlaybackState
, मेटाडेटा, और सूची. आगे दो बटन हैं
ऊपर दाईं ओर. बाईं ओर मौजूद बटन, पार्स करने लायक बटन के बीच टॉगल करता है
और फ़ॉर्मैट किए गए लॉग. दाईं ओर मौजूद बटन
सबसे ताज़ा जानकारी मिलेगी.
कोई टेस्ट चुनना
![परीक्षण चयन पेज](https://developer.android.com/static/media/images/MCT/MCT-Testing-Verification-Screen.png?authuser=9&hl=hi)
बाईं ओर स्वाइप करने पर, पुष्टि की जांच वाले व्यू पर पहुंचा जा सकता है, जहां उपलब्ध टेस्ट की एक स्क्रोल की जा सकने वाली सूची देखें. अगर किसी टेस्ट में किसी क्वेरी का इस्तेमाल किया जाता है, जैसे कि इमेज 7 में दिखाई गई खोज के नतीजों से चलाएं, क्वेरी स्ट्रिंग डालने के लिए टेक्स्ट फ़ील्ड.
MCT में मीडिया से जुड़ी इन कार्रवाइयों के टेस्ट शामिल हैं. साथ ही, अन्य टेस्ट में प्रोजेक्ट में लगातार जोड़ा जाता है:
- चलाएं
- खोज से चलाएं
- मीडिया आईडी से चलाएं
- यूआरआई से चलाएं
- रोकें
- रोकें
- अगले पर जाएं
- पिछले पर जाएं
- सीधे आइटम की सूची पर जाएं
- इस पर जाएं
परीक्षण के नतीजे
![टेस्ट का नतीजा सफल रहा](https://developer.android.com/static/media/images/MCT/MCT-Testing-Success-Screen.png?authuser=9&hl=hi)
व्यू में सबसे नीचे, नतीजे वाली जगह शुरुआत में खाली रहती है. यह आपको दिखाएगा से आपको नतीजे मिल सकते हैं. उदाहरण के लिए, खोज टेस्ट से प्ले चलाने के लिए, टेक्स्ट फ़ील्ड में खोज क्वेरी डालें और जांच करें पर क्लिक करें. नीचे दिए गए इस स्क्रीनशॉट में, एक्सपेरिमेंट का नतीजा सफल हुआ.
Android TV ऐप्लिकेशन की टेस्टिंग करना
Android TV पर MCT लॉन्च करने पर, आपको इंस्टॉल किए गए मीडिया ऐप्लिकेशन की सूची दिखती है. ध्यान दें कि कोई ऐप्लिकेशन इस सूची में सिर्फ़ तब दिखेगा, जब वह किसी मीडिया ब्राउज़र को लागू करता हो सेवा.
किसी ऐप्लिकेशन को चुनने पर, आपको टेस्टिंग स्क्रीन पर ले जाया जाएगा. स्क्रीन पर, पुष्टि करने से जुड़ी टेस्ट की सूची दिखेगी.
जब आप कोई परीक्षण करते हैं, तो स्क्रीन की बाईं ओर चुना गया MediaController. ज़्यादा जानकारी के लिए, Logcat में MCT लॉग देखें.
जिन जांचों के लिए क्वेरी की ज़रूरत होती है उन्हें कीबोर्ड आइकॉन से मार्क किया जाता है. किसी एक पर क्लिक करके इन टेस्ट से क्वेरी के लिए एक इनपुट फ़ील्ड खुलता है. जांच करने के लिए, Enter पर क्लिक करें.
टेक्स्ट इनपुट को आसान बनाने के लिए, adb
निर्देश का भी इस्तेमाल किया जा सकता है:
adb shell input text your-query
आप "%s" का उपयोग कर सकते हैं का इस्तेमाल करें. उदाहरण के लिए, निम्न आदेश में "नमस्ते दुनिया" लिखा जाता है डालें.
adb shell input text hello%sworld
टेस्ट तैयार करना
अगर आपको लगता है कि ज़्यादा टेस्ट काम के हैं, तो पुल का अनुरोध सबमिट किया जा सकता है. नए टेस्ट बनाने का तरीका जानने के लिए, इस लिंक पर जाएं MCT GitHub विकी और देखें कि पुष्टि की जांच निर्देश दिए गए हों.
कृपया योगदान के लिए निर्देश देखें.
अन्य संसाधन
MCT को उन ऐप्लिकेशन के साथ इस्तेमाल किया जाना चाहिए जो मीडिया एपीआई लागू करते हैं. ज़्यादा जानकारी के लिए, यूनिवर्सल Android म्यूज़िक प्लेयर उदाहरण के लिए, .
गड़बड़ियां ठीक की गई हैं और सुधार किए गए हैं. कृपया योगदान के लिए निर्देश.