ऑडियो डिवाइस के लिए Google Cast केवल ऑडियो प्लेबैक का समर्थन करता है. इस गाइड में बताया गया है कि सिर्फ़-ऑडियो वाले डिवाइसों के लिए कास्ट ऐप्लिकेशन को ऑप्टिमाइज़ करने और इससे मेमोरी, सीपीयू, और नेटवर्क बैंडविथ के इस्तेमाल की मांग कम हो जाती है.
ऑडियो के लिए Google Cast की सुविधा देने वाले ऐप्लिकेशन को इन बातों का ध्यान रखना चाहिए: विचार:
- ऑडियो डिवाइसों के लिए Google Cast, वीडियो या ग्राफ़िक नहीं दिखाता है. हालांकि, कई ऑडियो डिवाइसों में मेटाडेटा दिखाने के लिए डिसप्ले होता है. जैसे, प्लेबैक स्थिति (चलाना या रोका गया) और प्रगति. आपका ऐप्लिकेशन नहीं दिखना चाहिए उपयोगकर्ता से जुड़ी ऐसी अहम जानकारी जो सिर्फ़ पाने वाले व्यक्ति के पास हो; करने के लिए, यूज़र इंटरफ़ेस का ज़्यादातर ��िस्सा, भेजने वाले की स्क्रीन पर दिखना चाहिए.
- वेब रिसीवर ऐप्लिकेशन को ठीक से चलाने के लिए, ऑडियो डिवाइस के लिए Google Cast को ग्राफ़िक तो दिखाने होंगे, भले ही वे दिखाए न गए हों. से हो सकता है कि डिवाइस में हार्डवेयर से तेज़ी से चलने वाले ग्राफ़िक ऑपरेशन काम न करते हों, रिसीवर ऐप्लिकेशन को ग्राफ़िक-इंटेंसिव ऑपरेशन से बचना चाहिए जैसे कि कलर ग्रेडिएंट, रोटेशन, ऐल्फ़ा ब्लेंडिंग, और री-ड्रॉइंग लार्ज प्रोग्रेस बार जैसे ऑब्जेक्ट, एक सेकंड में एक से ज़्यादा बार दिखाए जा सकते हैं.
- ऑडियो डिवाइसों के लिए Google Cast, सिर्फ़ डिजिटल अधिकारों के लिए Widevine के साथ काम करता है मैनेजमेंट (डीआरएम) से सुरक्षित कॉन्टेंट.
- ऑडियो डिवाइस के लिए ज़्यादातर Google Cast के लिए, भेजने वाले ऐप्लिकेशन के कंट्रोल डिवाइस की पूरी आवाज़ रेंज (उदाहरण के लिए, एक स्पीकर), न सिर्फ़ टीवी पर ऑडियो सोर्स के इनपुट का वॉल्यूम, जैसा कि Chromecast डिवाइस पर होता है.
- भेजने वाले के डिवाइस से प्लेबैक को कंट्रोल करने के अलावा, उदाहरण के लिए), ऐप्लिकेशन को रिमोट कंट्रोल, डिवाइस पर मौजूद बटन या कोई बाहरी रिमोट ऐप्लिकेशन.
- ऑडियो डिवाइस के लिए Google Cast, सामग्री मेटाडेटा दिखाने की सुविधा दे सकता है छोटी LCD स्क्रीन, एचडीएमआई आउटपुट (साउंडबार या ऑडियो-वीडियो के लिए) के साथ रिसीवर), या बाहरी रिमोट ऐप्लिकेशन है. डिवाइस का यूज़र इंटरफ़ेस (यूआई).
डेवलेपमेंट
ऑडियो के लिए Google Cast का समर्थन करने के लिए Cast ऐप्लिकेशन विकसित करने का पहला चरण ऑडियो-वीडियो के लिए एक Cast ऐप्लिकेशन विकसित करना है और यह पक्का करना है कि वह Chromecast. यह दस्तावेज़ मानता है कि आपने ऐसा ऐप्लिकेशन डेवलप किया है और उसकी जांच की है.
कोई ऐप्लिकेशन, ऑडियो-वीडियो और सिर्फ़-ऑडियो वाले, दोनों तरह के डिवाइसों पर काम कर सकता है. इसे जानने की ज़रूरत है जब हम एक-दूसरे की तुलना में कास्ट कर रहे हों और यह पक्का करने के लिए कदम उठाते हों कि उपयोगकर्ता अनुभव को बेहतर बनाएं.
उदाहरण के लिए, ड्यूअल वी��ियो और ऑडियो ऐप्लिकेशन (जैसे कि लोकल/एनएएस फ़ाइल प्लेबैक) ऐप्लिकेशन) को सिर्फ़-ऑडियो डिवाइसों पर कास्ट करने की सुविधा चालू करनी चाहिए, ताकि ऑडियो फ़ाइलें चला रहा है, लेकिन ऐप्लिकेशन को उपयोगकर्ता को वीडियो फ़ाइलें भेजने की अनुमति नहीं देनी चाहिए ऑडियो-वीडियो डिवाइस में बदलना है. यह ऐप्लिकेशन, ईमेल भेजने वालों के लिए, डिवाइस की सुविधाओं से जुड़े एपीआई डिवाइस के लिए सही कॉन्टेंट तय करने के लिए नीचे बताया गया है.
ऑडियो के लिए Google Cast का समर्थन करने के लिए, आपके ऐप्लिकेशन को निम्न करना होगा:
सिर्फ़-ऑडियो के साथ काम करता है: संगीत और ऑडियो फ़ाइलें, रेडियो वगैरह स्ट्रीम करना. मीडिया वेब रिसीवर ऐप्लिकेशन पर स्ट्रीम की जाने वाली वीडियो स्ट्रीम, वीडियो स्ट्रीम नहीं होनी चाहिए. साथ ही, ऐसा करने से बचें ऐप्लिकेशन के लॉन्च का समय कम करने के लिए, ग्राफ़िक और इमेज स्ट्रीम करना और मेमोरी के इस्तेमाल को दिखाता है. नीचे मेमोरी के इस्तेमाल से जुड़े दिशा-निर्देश देखें.
सामान्य Chromecast और ऑडियो डिवाइस के लिए, Cast पर उम्मीद के मुताबिक चलाएं.
डिवाइस की क्षमताएं
आपका ऐप्लिकेशन सिर्फ़-ऑडियो वाले डिवाइस पर चल ��ह��� ��ै ��ा ��हीं, ��स���े लिए डिवाइस की सुविधाओं से जुड़े एपीआई, जो डिवाइस में या डिवाइस भेजने वाले के ज़रिए उपलब्ध होते हैं या रिसीवर एपीआई के साथ काम करता है.
डिवाइस एचटीटीपी हेडर
CAST-DEVICE-CAPABILITIES
एचटीटीपी हेडर, जिसे कास्ट डिवाइस ने इस दौरान उपलब्ध कराया था
ऐप्लिकेशन लॉन्च, डिवाइस की क्षमताओं के बारे में बताता है. डिवाइस एक अनुरोध भेजता है
इस हेडर के साथ वेब रिसीवर ऐप्लिकेशन को होस्ट करने वाले सर्वर पर ट्रांसफ़र करेगा. इसके लिए हेडर
सिर्फ़-ऑडियो वाला डिवाइस, डिवाइस की क्षमताओं के बारे में बताता है
CAST-DEVICE-CAPABILITIES: {"display_supported":false}
.
जब आपके सर्वर को डिवाइस से अनुरोध मिलता है, तो आप अनुरोध को उस वेब प्राप्तकर्ता ऐप्लिकेशन पर रीडायरेक्ट करने के लिए जो इस हेडर में मौजूद जानकारी को ऑडियो डिवाइसों के लिए ऑप्टिमाइज़ किया गया है.
वेब प्राप्तकर्ता API
आप CastReceiverManager.getDeviceCapabilities()
पर कॉल करके, डिवाइस की सुविधाओं वाला वही ऑब्जेक्ट पा सकते हैं
जब वेब रिसीवर ऐप्लिकेशन लोड होता है.
ज़्यादा जानकारी के लिए, डिवाइस की सुविधाएं देखें जानकारी.
सेंडर एपीआई
कास्ट करने वाले सभी ईमेल पतों के एपीआई में, डिवाइस से जुड़ी सुविधाओं की जानकारी भी होती है. इनसे आपके भेजने वाले ऐप्लिकेशन को यह तय करने में मदद मिलती है कि कॉन्टेंट पाने वाले को किस तरह का मीडिया भेजा जाए. अगर आपके ऐप्लिकेशन में ऑडियो और वीडियो, दोनों सुविधाएं काम करती हैं, तो वह इन प्लैटफ़ॉर्म पर वीडियो कॉन्टेंट भेजने से बच सकता है सिर्फ़-ऑडियो वाले डिवाइस. आपका ऐप्लिकेशन वॉल्यूम को कम या ज़्यादा करने के लिए, डिवाइस के लिए सही होना चाहिए, जैसा कि डिज़ाइन चेकलिस्ट में बताया गया है. भेजने वालों के लिए डिवाइस की सुविधाओं से जुड़े ये एपीआई देखें:
- Android: CastDevice.hasCapabilities
- iOS: deviceCapabilities
- Chrome: chrome.cast.Capability
मेमोरी के इस्तेमाल से जुड़े दिशा-निर्देश
ऑडियो डिवाइस पर चल रहे वे��� रिसीवर ऐप्लिकेशन को मेमोरी के इस्तेमाल को इस तरह से मैनेज करना होगा:
- मेमोरी कम करने के लिए, किसी भी इमेज या ग्राफ़िक एसेट को डाउनलोड करने या इस्तेमाल करने से बचें फ़ुटप्रिंट और वीडियो चलाना शुरू होने तक लगने वाले समय को कम करता है.
- मीडिया सोर्स एक्सटेंशन (MSE) का इस्तेमाल करते समय, ऐप्लिकेशन को स्ट्रीम को सीमित करना चाहिए बफ़र का साइज़ 2 एमबी से ज़्यादा न करें. अगर मीडिया प्लेयर लाइब्रेरी (एमपीएल) का इस्तेमाल किया जा रहा है, तो ऐप्लिकेशन की स्ट्रीम बफ़र का साइज़ पहले से ही MPL तय करता है.
- HTMLMediaElement का इस्तेमाल करते समय, ऐप्लिकेशन के स्ट्रीम बफ़र का साइज़ तय होता है स्ट्रीम रेट के हिसाब से चुनें. ऑडियो बिटरेट को प्रति मेगाबिट तक सीमित रखें दूसरा, जो इसमें बताए गए सभी कोडेक पर काम करता हो इस्तेमाल किया जा सकने वाला मीडिया (48KHz/16बिट तक).
आवाज़ कंट्रोल करें
ऑडियो डिवाइस के लिए ज़्यादातर Google Cast के लिए, भेजने वाले ऐप्लिकेशन इसका नियंत्रण करते हैं किसी डिवाइस की फ़ुल वॉल्यूम रेंज में, न सिर्फ़ ऑडियो सोर्स के इनपुट वॉल्यूम को, बल्कि Chromecast डिवाइस. इसका मतलब है कि इनके लिए आवाज़ में होने वाले बदलाव कम होने चाहिए केवल-ऑडियो वाले ऐप्लिकेशन. जानकारी उपलब्ध कराने के बारे में दिशा-निर्देशों के लिए, ये दस्तावेज़ देखें आपके ऐप में व��ल्यूम पर नियंत्रण:
- भेजने वाले की आवाज़ के कंट्रोल में डिज़ाइन चेकलिस्ट
- Android से जुड़े लोगों की संख्या
- iOS पर भेजने वाले लोगों की संख्या
- वेब से भेजने वाले लोगों की संख्या
डिवाइस कंट्रोल
ऑडियो डिवाइस के लिए Google Cast के खुद के प्लेबैक कंट्रोल हो सकते हैं (जैसे
बटन, रिमोट). ये उन मीडिया प्लेबैक मैसेज का इस्तेमाल करते हैं जो
urn:x-cast:com.google.cast.media
नेमस्पेस, जैसा कि इसमें बताया गया है
प्लेबैक को कंट्रोल करने के लिए, मीडिया प्लेबैक मैसेज
पाने वाले ऐप्लिकेशन पर. आपका रिसीवर ऐप्लिकेशन इसे
ये मीडिया प्लेबैक मैसेज, डिवाइस के प्लेबैक कंट्रोल के साथ काम करने के लिए होते हैं.
साथ ही, आपके भेजने वाले ऐप्लिकेशन से पाने वाले से भेजने वाले तक के मैसेज काम करेंगे ताकि अगर उपयोगकर्ता डिवाइस कंट्रोल की मदद से मीडिया की स्थिति बदलता है, तो भेजने वाले ऐप्लिकेशन को, मैसेज पाने वाले से स्टेटस मैसेज मिल सकता है और वह यूज़र इंटरफ़ेस (यूआई) अपडेट कर सकता है भुगतान करते हैं.
डिवाइस का डिसप्ले
ऑडियो डिवाइस के लिए Google Cast में डिवाइस पर LCD स्क्रीन हो सकती है या किसी डिवाइस के लिए खास तौर पर बनाया गया कंट्रोल ऐप्लिकेशन, जो मीडिया मेटाडेटा दिखाता है. आपका रिसीवर ऐप्लिकेशन को सभी ऑडियो ट्रैक के लिए यह मेटाडेटा देना होगा. साथ ही, पक्का करना होगा कि यह मेटाडेटा सिंक किया गया हो इस बात का ध्यान रखने के लिए कि मौजूदा समय में चल रहे कॉन्टेंट के साथ मेटाडेटा पर सही तरीके से दिखेगा. अगर ऐप्लिकेशन कस्टम मेटाडेटा का इस्तेमाल कर रहा है, इसमें स्टैंडर्ड ऑडियो मेटाडेटा भी शामिल होना चाहिए. जैसे, ट्रैक का नाम, कलाकार का नाम, एल्बम टाइटल, वगैरह) के बारे में नीचे बताया गया है.
मीडिया लोड करते समय, कॉन्टेंट पाने वाले व्यक्ति को मेटाडेटा भेजने वाले से मेटाडेटा मिल जाता है. तय सीमा में भेजने वाले ऐप्लिकेशन का इस्तेमाल करके, मीडिया फ़ाइल पाने वाले व्यक्ति पर मीडिया लोड करने के निर्देश के साथ-साथ, नीचे दिए गए फ़ील्ड को चुनें, ताकि मेटाडेटा ऑडियो डिवाइस के लिए Google Cast. इन ��पीआई का इस्तेमाल करें:
Android
MediaMetadata
MEDIA_TYPE_MUSIC_TRACK
के साथ और:iOS
GCKMediaMetadata
GCKMediaMetadataType
के साथGCKMediaMetadataTypeMusicTrack
और:MusicTrackMediaMetadata
के साथ ChromeMediaInfo
और:
अगर Cast ऐप्लिकेशन, कॉन्टेंट पाने वाले या क्लाउड में मीडिया सूची को मैनेज करता है, तो
वेब प्राप्तकर्ता को
urn:x-cast:com.google.cast.media
नेमस्पेस, ताकि सभी ईमेल भेजने वाले
सिंक किया गया.
रजिस्ट्रेशन
जांच और रजिस्टर करने के लिए, आपको ऑडियो डिवाइस के लिए अपने Google Cast को रजिस्टर करना होगा ऑडियो डिवाइस के लिए Google Cast का समर्थन करने के लिए अपना ऐप्लिकेशन Google Cast SDK Developer Console का इस्तेमाल करें.
- ज़्यादा जानकारी के लिए डिवाइस देखें डिवाइसों को रजिस्टर करने के बारे में है.
- आपको सिर्फ़-ऑडियो वाले डिवाइसों पर कास्ट करने की सुविधा काम करती है चेकबॉक्स को चुनना होगा. ऐसा तब करें, जब आपके ऐप्लिकेशन को रजिस्टर किया जा रहा है, ताकि आपके ऐप्लिकेशन को ऑडियो डिवाइस. अपना ऐप्लिकेशन रजिस्टर करें देखें.
टेस्ट करने के लिए इस्तेमाल किए जाने वाले ऐप्लिकेशन जैसे अनपब्लिश किए गए ऐप्लिकेशन के लिए, आपको सिर्फ़-ऑडियो वाले ���िवाइसों पर सुविधा उपलब्ध कराने का विकल्प, ताकि ऐप्लिकेशन खोज सके सिर्फ़-ऑडियो वाले डिवाइस.
ऑडियो 2.0 के लिए Google Cast
ऑडियो के लिए Google Cast (GC4A) 2.0, अगली पीढ़ी का कास्ट ऑडियो प्लैटफ़ॉर्म है इसे कम मेमोरी वाले डिवाइसों को टारगेट करने के लिए डिज़ाइन किया गया है. इसका मकसद, ऐसे डिवाइसों के नेटवर्क को बढ़ाना है आपके कॉन्टेंट को स्ट्रीम कर सकती है. GC4A 2.0, ऑडियो प्लैटफ़ॉर्म को टारगेट करता है, इसलिए वेब एपीआई को कम करके डिसप्लेलेस डिवाइसों के साथ अलाइन किया जा सकता है. GC4A 2.0, नए कुछ मौजूदा स्पीकर भी हैं.
जांच और डीबग करना
GC4A 2.0 की सुविधा वाले सभी स्पीकर की सुविधाओं का इस्तेमाल किया जाएगा. इसलिए, यह ज़रूरी है कि ऑडियो ऐप्लिकेशन डेवलपर, GC4A 2.0 पर अपने ऐप्लिकेशन की जांच करते हैं. आप इसके लिए अपने Cast ऐप्लिकेशन का परीक्षण कर सकते हैं Bose वाई-फ़ाई के प्रोडक्शन वाले स्पीकर पर GC4A 2.0, JBL Charge 5 Wi-Fi, JBL ऑथेंटिक्स, Cambridge Audio, Teuful Motiv Home, और LG 2024 साउंडबार.
GC4A 2.0, Chrome रिमोट डीबगर के साथ काम नहीं करता. अगर आपको ऐप्लिकेशन के लिए, Google Cast Debug Logger का इस्तेमाल करने का सुझाव देता है.
सुझाए गए बेसिक टेस्ट केस
हमारा सुझाव है कि आप GC4A 2.0 पर मौजूद, ऐप्लिकेशन की सभी सुविधाओं की जांच कर लें. अपनी ऑडियंस की सूची में हर तरह के मीडिया (पॉडकास्ट, स्ट्रीम वगैरह), रोकने, स्क्रबिंग करने, स्किप करना, प्लेलिस्ट बदलना, रोकना, और कास्ट को फिर से कनेक्ट करना.
काम करने वाले एपीआई
GC4A 2.0 में ये एपीआई इस्तेमाल किए जा सकते हैं:
- एचटीएमएल
- JavaScript ECMA 6
- DOMParser
- XMLSerializer
- दस्तावेज़ और सब-क्लास
- DocumentFragment
- HTMLMediaElement और HTMLAudioElement
- HTMLVideoElement (सिर्फ़ ऑडियो कॉन्टेंट चलाया जा सकता है)
- HTMLScriptElement
- HTMLBaseElement
- HTMLTemplateElement
- कस्टम एलिमेंट
- शैडो डीओएम
- स्क्रिप्ट मॉड्यूल / एक साथ काम नहीं करने वाली प्रोसेस / स्थगित
- फ़ेच / XHR
- WebSocket
- MessagePort
- कुकी
- MSE (मीडिया सोर्स एक्सटेंशन)
- ईएमई (एन्क्रिप्टेड मीडिया एक्सटेंशन)
- लोकल / सेशन स्टोरेज
GC4A 2.0 में इनका इस्तेमाल नहीं किया जा सकता:
- डाइनैमिक मॉड्यूल इंपोर्ट (2024 में जोड़ा जाएगा)
- सीएसएस
- IFrame
- TextTracks
संपर्क
कृपया संपर्क करें gc4a-support-external@google.com पर संपर्क करें, अगर आपको जांच के लिए सेट अप करने में मदद चाहिए या Bose स्पीकर इस्तेमाल नहीं कर पा रहे हैं.