शाका प्लेयर पर HLS से जुड़ी जानकारी

खास जानकारी

Cast Web Receiver SDK, कई वेब स्ट्रीमिंग प्रोटोकॉल का इस्तेमाल करके कॉन्टेंट चलाने की सुविधा देता है. इस्तेमाल किए गए प्रोटोकॉल के आधार पर, SDK टूल कॉन्टेंट चलाने के लिए प्लेयर लोड करता है. एचएलएस कॉन्टेंट के मामले में, मीडिया प्लेयर लाइब्रेरी (MPL) लोड होती है. DASH कॉन्टेंट के मामले में, Shaka Player लोड किया जाता है.

आने वाले समय में, Cast SDK और Shaka Player की इंजीनियरिंग टीमें, Shaka Player पर एचएलएस कॉन्टेंट चलाने की सुविधा को बेहतर बनाने के लिए काम कर रही हैं. MPL को अब ज़रूरी अपडेट नहीं मिलेंगे. हमारा सुझाव है कि आप अपने ऐप्लिकेशन के एचएलएस कॉन्टेंट को चलाने के लिए, Shaka Player का इस्तेमाल करने के लिए ऑप्ट इन करें.

Shaka Player के फ़ायदे

प्लेयर बदलने पर, ऐप्लिकेशन को ये फ़ायदे मिलते हैं:

• उपयोगकर्ताओं के लिए बेहतर स्ट्रीमिंग सेशन, जिनमें लोड होने में लगने वाले समय और इंतज़ार की अवधि में सुधार किया गया है.
• एचएलएस की नई सुविधाओं को लगातार अपनाना.
• Shaka Player के ओपन सोर्स होने की वजह से, प्लेयर और कॉन्टेंट के साथ काम न करने से जुड़ी समस्याओं के लिए, मूल वजहों के विश्लेषण में ज़्यादा जानकारी मिलती है.
• ओपन सोर्स प्लेयर कोडबेस की मदद से, पार्टनर Shaka Player प्रोजेक्ट में योगदान दे सकते हैं.
• प्रोडक्शन में सुविधाओं और गड़बड़ी को ठीक करने में लगने वाले समय में काफ़ी कमी आई है. ऐसा इसलिए हुआ है, क्योंकि Shaka Player का रिलीज़ कैडेंस अक्सर होता है और यह वेब रिसीवर SDK टूल की रिलीज़ से अलग होता है.
• shakaVersion एपीआई की मदद से, वीडियो चलाने के माहौल को बेहतर तरीके से कंट्रोल करना.
• Google की ओर से वीडियो चलाने के लिए ज़्यादा सहायता. इसमें, Shaka Player पर एचएलएस वीडियो चलाने के लिए इंजीनियरिंग रिसॉर्स का इस्तेमाल किया जाता है. इस बारे में रोडमैप में बताया गया है.

टाइमलाइन

वेब रिसीवर SDK टूल, एचएलएस कॉन्टेंट चलाने के लिए डिफ़ॉल्ट प्लेयर के तौर पर Shaka Player का इस्तेमाल करेगा. यह प्रोसेस अलग-अलग चरणों में पूरी की जाएगी, ताकि पार्टनर को माइग्रेशन की प्रोसेस के बारे में जानकारी दी जा सके.

वेब रिसीवर SDK की इंजीनियरिंग टीमें, परफ़ॉर्मेंस पर आधारित तरीका अपना रही हैं. वे अगले चरण में सिर्फ़ तब आगे बढ़ेंगी, जब Shaka Player की परफ़ॉर्मेंस, MPL की बेसलाइन परफ़ॉर्मेंस के बराबर हो. इन बदलावों का एलान, cast-sdk-announcements Google ग्रुप में किया जाएगा. साथ ही, इस गाइड में भी इन्हें अपडेट किया जाएगा.

ऑप्ट इन करें

CAF के 3.0.0105 वर्शन से, ऐप्लिकेशन लेवल पर एक कॉन्फ़िगरेशन है. इसकी मदद से, HLS वीडियो चलाने के लिए Shaka Player का इस्तेमाल करने के लिए ऑप्ट-इन किया जा सकता है. इस वर्शन में, Shaka Player के उन वर्शन में से किसी एक को चुनने के लिए एपीआई भी जोड़ा गया है जिसका इस्तेमाल किया जा सकता है. ये फ़्लैग, useShakaForHls और shakaVersion प्रॉपर्टी के ज़रिए CastReceiverOptions क्लास में दिए जाते हैं. साथ ही, CastReceiverContext शुरू होने पर इनका आकलन किया जाता है. एचएलएस के लिए Shaka में ऑप्ट-इन करने वाले किसी भी ऐप्लिकेशन को, एचएलएस के नए वर्शन में हुए सुधारों का फ़ायदा पाने के लिए, Shaka Player का कम से कम 4.3.4 वर्शन सेट करना चाहिए. ऑप्ट-इन करने के लिए, नीचे दिए गए कोड स्निपेट का इस्तेमाल करें:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

कॉन्टेंट की पुष्टि करना

पार्टनर को अपने प्रोडक्शन ऐप्लिकेशन में Shaka Player का इस्तेमाल करने के लिए ऑप्ट-इन करने से पहले, Shaka Player पर अपने कॉन्टेंट के चलने की पुष्टि करनी चाहिए. हमारा सुझाव है कि आप अपने कॉन्टेंट के नीचे दिए गए हर वैरिएशन को टेस्ट करें:

• स्ट्रीम के टाइप: लाइव या वीओडी
• कंटेनर फ़ॉर्मैट: TS, MP4 या एलिमेंटरी स्ट्रीम
• ऐसा कॉन्टेंट जिसमें बीच में रुकावटें आती हैं या एम्बेड किए गए विज्ञापन दिखते हैं
• इन डिवाइसों पर वीडियो चलाना: स्मार्ट डिसप्ले, Chromecast डोंगल, Android TV डिवाइस, Chromecast बिल्ट-इन टेक्नोलॉजी वाले टीवी, स्मार्ट स्पीकर

अगर आपको कोई गड़बड़ी या अनचाहा व्यवहार मिलता है, तो बग की शिकायत करें. जब यह पुष्टि हो जाए कि आपके कॉन्टेंट में वीडियो चलाने से जुड़ी कोई गंभीर समस्या नहीं है, तो बदलावों को अपने प्रोडक्शन एनवायरमेंट में पुश करें.

ऑप्ट आउट करें

वेब रिसीवर SDK टूल, टाइमलाइन के हिसाब से, Shaka Player के एचएलएस कॉन्टेंट को चलाने के लिए, ऑप्ट-आउट मॉडल पर स्विच कर देगा. प्रॉपर्टीuseShakaForHls की डिफ़ॉल्ट वैल्यू, false से बदलकर true हो जाएगी. उस समय, ऐप्लिकेशन इस प्रॉपर्टी को मैन्युअल तरीके से false पर सेट करके, एचएलएस वीडियो चलाने के लिए एमपीएल का इस्तेमाल कर सकते हैं. CastReceiverContext शुरू होने पर, वेब रिसीवर SDK टूल, Shaka Player के बजाय एमपीएल को लोड करने के लिए वापस आ जाएगा. ऑप्ट-आउट करने का तरीका जानने के लिए, यहां दिया गया सैंपल देखें:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

समस्याओं की शिकायत करना

हमारा सुझाव है कि पार्टनर, एचएलएस कॉन्टेंट चलाने के दौरान मिलने वाली किसी भी समस्या की शिकायत करें. जैसा कि बताया गया है, MPL को अब ज़रूरी अपडेट नहीं मिलेंगे. अगर MPL में कोई समस्या आती है, तो गाइड के ऑप्ट इन करें सेक्शन में दिए गए निर्देशों का पालन करें. इससे यह पता चलेगा कि Shaka Player पर स्विच करने से आपकी समस्या हल होगी या नहीं. अगर समस्या अब भी मौजूद है या खिलाड़ी बदलते समय आपको कोई दूसरी समस्या आती है, तो नीचे दिया गया तरीका अपनाएं.

1. समस्या को ठीक करने के लिए, shakaVersion को किसी दूसरे ब्रैंच वर्शन पर सेट करें. उदाहरण के लिए, अगर समस्या 4.3 शाखा पर आ रही है, तो इसे 4.2.x या 3.3.x वर्शन में सबसे नई रिलीज़ पर सेट करने की कोशिश करें. Shaka Player के रिलीज़ नोट देखें. इससे आपको सबसे काम के अपडेट वाली रिलीज़ के बारे में पता चलेगा. ध्यान दें कि shakaVersion एपीआई के लिए, कम से कम और ज़्यादा से ज़्यादा वर्शन इस्तेमाल किए जा सकते हैं. इस बारे में ज़्यादा जानकारी, रेफ़रंस दस्तावेज़ में दी गई है. अगर आपको लगता है कि परफ़ॉर्मेंस में गिरावट आई है, तो Shaka Player के समस्या ट्रैकर में इसकी शिकायत करें.

2. प्लेयर के कॉन्फ़िगरेशन पैरामीटर बदलकर देखें. Shaka Player को PlayerConfiguration ऑब्जेक्ट की मदद से कॉन्फ़िगर किया जा सकता है. वेब रिसीवर SDK टूल, डिफ़ॉल्ट वैल्यू का एक सेट तय करता है. साथ ही, ऐप्लिकेशन को PlaybackConfig ऑब्जेक्ट में shakaConfig प्रॉपर्टी की मदद से, इस कॉन्फ़िगरेशन में बदलाव करने की सुविधा देता है. इसका आकलन, प्लेयर इंस्टेंस बनने के दौरान लोड होने में लगने वाले समय के दौरान किया जाता है. ज़्यादा जानकारी के लिए

   ऐप्लिकेशन कॉन्फ़िगरेशन और विकल्प. वेब रिसीवर SDK टूल से सेट की गई डिफ़ॉल्ट वैल्यू, सुझाई गई वैल्यू होती हैं.

3. देखें कि समस्या की शिकायत, Shaka Player के समस्या ट्रैकर या Cast के समस्या ट्रैकर में की गई है या नहीं. गड़बड़ी के बारे में टिप्पणी करें. अगर गड़बड़ी से जुड़ी जानकारी में आपकी समस्या के बारे में भी बताया गया है, तो उससे जुड़ी कोई भी काम की जानकारी जोड़ें.

4. Shaka Player की डेमो साइट पर अपने कॉन्टेंट की जांच करें. अगर आपको लगता है कि आपके कॉन्टेंट की डेमो साइट पर भी यह समस्या आ रही है, तो Shaka Player प्रोजेक्ट के लिए बग दर्ज करें.

5. अगर आपको कास्ट एंडपॉइंट पर, Shaka Player से जुड़ी कोई खास समस्या आ रही है, तो कास्ट की समस्या ट्रैकर में गड़बड़ी की शिकायत करें.

अक्सर पूछे जाने वाले सवाल

खिलाड़ियों को बदलने से कई सवाल उठ सकते हैं. यहां आपको अक्सर पूछे जाने वाले सवालों के जवाब मिलेंगे. इनसे आपको माइग्रेशन की प्रोसेस के बारे में जानकारी मिलेगी.

क्या मुझे Shaka Player पर माइग्रेट करना चाहिए?

हम अपने उन पार्टनर को जल्द से जल्द माइग्रेशन की प्रोसेस शुरू करने का सुझाव देते हैं जो एचएलएस कॉन्टेंट का इस्तेमाल करते हैं. इससे, आपके ऐप्लिकेशन पर उपयोगकर्ताओं को स्ट्रीमिंग का बेहतर अनुभव मिलेगा. इस गाइड के Shaka Player के फ़ायदे सेक्शन में, ज़्यादा फ़ायदों के बारे में बताया गया है. पार्टनर को यह पुष्टि करनी चाहिए कि उनके ऐप्लिकेशन, Shaka Player का इस्तेमाल करके सही तरीके से काम कर रहे हैं. इससे, आसानी से ट्रांज़िशन किया जा सकेगा. अगर पार्टनर, पहले से यह पुष्टि नहीं करते कि उनका कॉन्टेंट Shaka Player पर सही तरीके से चलता है, तो जब वेब रिसीवर SDK, ऑप्ट-आउट मॉडल पर ट्रांज़िशन करेगा, तो कुछ ऐप्लिकेशन को खतरा हो सकता है.

खिलाड़ियों को बदलने में कितना समय लगेगा?

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

मेरा ऐप्लिकेशन जल्द ही कॉन्टेंट स्ट्रीम करने के लिए HLS का इस्तेमाल करेगा. मुझे क्या करना चाहिए?

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

मेरा कॉन्टेंट या ऐप्लिकेशन, Shaka Player के साथ काम नहीं करता. अब मुझे क्या करना चाहिए?

आपको Shaka Player प्रोजेक्ट या Cast प्रोजेक्ट के लिए गड़बड़ी की शिकायत करनी चाहिए (समस्याओं की शिकायत करना देखें). Cast SDK इंजीनियरिंग टीम, इन ट्रैकर की लगातार निगरानी कर रही है. साथ ही, वह किसी भी समस्या को हल करने के लिए आपके साथ मिलकर काम करेगी. इन समस्याओं का पता जितनी जल्दी चलेगा, उन्हें ठीक करने में उतना ही ज़्यादा समय लगेगा.

MPL को अब अहम अपडेट नहीं मिल रहे हैं. इसका क्या मतलब है?

MPL ने पहले भी HLS की नई सुविधाओं को अपनाया है और अहम अपडेट के ज़रिए बड़ी गड़बड़ियों को ठीक किया है. अब MPL को ये अपडेट नहीं मिलेंगे. इसलिए, प्लेयर में HLS की नई सुविधाएं नहीं जोड़ी जाएंगी. इसी तरह, MPL पर एचएलएस वीडियो चलाने से जुड़ी कोई भी समस्या ठीक नहीं की जाएगी. वीडियो चलाने के लिए Shaka Player पर स्विच करके, इन समस्याओं को हल किया जा सकता है. अगर समस्याएं बनी रहती हैं, तो Shaka Player पर आ रही समस्याओं के बारे में बग दर्ज करें. पार्टनर को एमपीएल का इस्तेमाल बंद कर देना चाहिए.

मेरा कॉन्टेंट, स्मूद स्ट्रीमिंग प्रोटोकॉल का इस्तेमाल करता है. इससे मेरे ऐप्लिकेशन पर क्या असर पड़ेगा?

एमपीएल बाइनरी अब भी होस्ट की जाएंगी और आपके रिसीवर ऐप्लिकेशन के लिए ऐक्सेस की जा सकेंगी. हालांकि, स्मूद स्ट्रीमिंग से जुड़ी सुविधाओं के अनुरोध और गड़बड़ी ठीक करने के अनुरोध स्वीकार नहीं किए जाएंगे. ऐसा इसलिए, क्योंकि स्मूद स्ट्रीमिंग स्पेसिफ़िकेशन को चार साल से अपडेट नहीं किया गया है. हमारा सुझाव है कि आप अपने कॉन्टेंट को DASH या HLS स्ट्रीमिंग प्रोटोकॉल का इस्तेमाल करने के लिए माइग्रेट करें. इससे आपको अपने कॉन्टेंट की परफ़ॉर्मेंस के अपडेट और सहायता मिलती रहेगी.

मेरे कॉन्टेंट में एचएलएस या स्मूद स्ट्रीम प्रोटोकॉल का इस्तेमाल नहीं किया जाता. इससे मेरे ऐप्लिकेशन पर क्या असर पड़ेगा?

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