कस्टम वेब रिसीवर

जंप स्टार्ट - बेसिक कस्टम वेब रिसीवर बनाने का कोड आसान है. वेब रिसीवर का ऐप्लिकेशन रजिस्टर करें पर जाएं. इसके बाद, वेब रिसीवर का ऐप्लिकेशन बनाएं.

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

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

Google वेब रिसीवर SDK

आपका वेब रिसीवर ऐप्लिकेशन नीचे दिए गए संदर्भ के साथ वेब रिसीवर एपीआई ऐक्सेस करता है:

<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>

यूआरएल प्रोटोकॉल के लिए सबसे सही तरीका: ध्यान दें कि ऊपर दिए गए यूआरएल में कोई &&tt&http:" या "https:" प्रोटोकॉल नहीं है. cast_receiver_framework.js संसाधन सोर्स करते समय इन प्रोटोकॉल को छोड़ देने से, इस संसाधन को उसी प्रोटोकॉल का इस्तेमाल करके फ़ेच किया जा सकता है जिसका इस्तेमाल वेब रिसीवर ऐप्लिकेशन को होस्ट करने वाले सर्वर पर किया जाता है. इसका मतलब है कि प्रोडक्शन के लिए एचटीटीपी और एचटीटीपीएस के बीच स्विच करने में पारदर्शी है और इसलिए कोड में बदलाव करने की ज़रूरत नहीं होती. (पब्लिश किए गए वेब रिसीवर ऐप्लिकेशन, TLS की सुविधा वाले सर्वर पर होस्ट होने चाहिए.)

SDK टूल की झलक

कास्ट वेब रिसीवर SDK का रिलीज़ से पहले का वर्शन, गैर-प्रोडक्शन ऐप्लिकेशन में टेस्ट करने के लिए भी उपलब्ध है. SDK टूल की झलक दिखाने वाले यूआरएल के बारे में ज़्यादा जानकारी, Google Cast वेब रिसीवर SDK टूल के यूआरएल पर मिल सकती है.

ऐप्लिकेशन का लाइफ़ साइकल

वेब रिसीवर ऐप्लिकेशन का लाइफ़ साइकल उस समय से शुरू होता है जब वेब रिसीवर कास्ट डिवाइस पर लोड होता है और उस बिंदु पर जाता है जहां से ऐप्लिकेशन काम नहीं करता है और कास्ट डिवाइस अपनी डिफ़ॉल्ट स्थिति पर वापस चला जाता है.

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

कोई वेब रिसीवर ऐप्लिकेशन इन शर्तों के तहत काम करना बंद कर सकता है, उसका मौजूदा लाइफ़ साइकल खत्म कर सकता है, और ऐप्लिकेशन बंद कर सकता है:

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

वेब रिसीवर SDK सभी सामान्य मामलों को हमारे UX दिशा-निर्देशों के अनुसार प्रबंधित करता है.

मुख्य कक्षाएं

वेब रिसीवर SDK फ़्रेमवर्क की दो मुख्य कक्षाएं हैं:

  • cast.framework.CastReceiverContext - सभी फ़्रेमवर्क को मैनेज करता है और ज़रूरी लाइब्रेरी लोड करता है. इस ऑब्जेक्ट की मदद से, ये काम किए जा सकते हैं:

    • ऐप्लिकेशन के कॉन्फ़िगरेशन के विकल्प सेट करें
    • सिस्टम के इवेंट हैंडल करना (जैसे कि भेजने वाला या कनेक्ट नहीं होना)
    • कस्टम चैनल बनाएं
    • कास्ट बातचीत शुरू करें
  • cast.framework.PlayerManager - मीडिया प्लेबैक मैनेज किया जाता है. यह डेटा भेजने वाले के अनुरोध के हिसाब से, प्लेयर और मीडिया के एलिमेंट को मैनेज करता है. इस ऑब्जेक्ट की मदद से, ये काम किए जा सकते हैं:

    • वीडियो चलाने की कार्रवाइयों को मैनेज करना
    • मैसेज भेजने वाले से मिले मैसेज को हैंडल करना
    • वीडियो चलाने से जुड़े इवेंट मैनेज करना

वेब रिसीवर ऐप्लिकेशन रजिस्टर करना

वेब रिसीवर ऐप्लिकेशन बनाने से पहले, आपको अपने वेब रिसीवर ऐप्लिकेशन को Google Cast SDK Developer Console के साथ रजिस्टर करना होगा. ज़्यादा जानकारी के लिए, रजिस्ट्रेशन देखें. सभी वेब रिसीवर ऐप्लिकेशन को भेजने वाले ऐप्लिकेशन की ज़रूरत होती है, ताकि वे उन मैसेज मैसेज के साथ ऐप्लिकेशन आईडी दे सकें जिन्हें वे वेब पाने वाले को भेजने वाले एपीआई के ज़रिए भेजते हैं. जब आप वेब रिसीवर का ऐप्लिकेशन रजिस्टर करते हैं, तब आपको भेजने वाले का एपीआई कॉल में शामिल करने के लिए, ऐप्लिकेशन का आईडी मिलेगा.

एक साधारण वेब रिसीवर ऐप्लिकेशन बनाएं

नीचे दिए गए बेसिक वेब रिसीवर ऐप्लिकेशन की मुख्य बनावट है जिसमें कोई कस्टमाइज़ेशन नहीं है:

  1. मीडिया प्लेयर को दिखाने के लिए, cast-media-player एचटीएमएल एलिमेंट.
  2. वेब रिसीवर फ़्रेमवर्क लोड करने के लिए एक स्क्रिप्ट एचटीएमएल एलिमेंट.
  3. बिना किसी विकल्प के वेब रिसीवर ऐप्लिकेशन को शुरू करने के लिए start() कॉल करें.

यहां बिना किसी कस्टमाइज़ेशन के कास्ट ऐप्लिकेशन फ़्रेमवर्क का इस्तेमाल करके, वेब रिसीवर ऐप्लिकेशन के लिए कम से कम कोड दिया गया है. अपना वेब रिसीवर ऐप्लिकेशन बनाने के लिए, आप इस स्क्रिप्ट को ठीक अपने ऐप्लिकेशन में ज्यों-का-त्यों कॉपी करके पेस्ट कर सकते हैं.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

इस समय उपयोगकर्ता, अपना भेजने वाला ऐप्लिकेशन खोल सकता है और अपने कास्ट डिवाइस से कनेक्ट कर सकता है. इसके बाद, वह मीडिया पर जा सकता है और Play बटन दबा सकता है, जो वेब रिसीवर को टीवी पर मीडिया स्ट्रीम करने के लिए कहता है, ताकि उपयोगकर्ता उसे देख सकें.

इस बेसिक वेब रिसीवर की तुलना पसंद के मुताबिक बनाए गए रिसीवर ऐप्लिकेशन से करें.

मीडिया और प्लेयर

कास्ट फ़्रेमवर्क, बिल्ट-इन मीडिया प्लेयर की सुविधा देता है, जिसे cast-media-player एचटीएमएल एलिमेंट से दिखाया जाता है. यह मीडिया प्लेयर MPEG-DASH, HLS, और स्मूद स्ट्रीमिंग जैसे स्ट्रीमिंग प्रोटोकॉल के लिए प्लेबैक का समर्थन करता है.

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

क्रॉस-ऑरिजिन रिसॉर्स शेयरिंग

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