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

खास जानकारी

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

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

Shaka Player के फ़ायदे

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

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

टाइमलाइन

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

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

ऑप्ट इन करें

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

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

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

context.start(castReceiverOptions);

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

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

• स्ट्रीम के टाइप: लाइव या वीओडी
• कंटेनर फ़ॉर्मैट: टीएस, एमपी4 या एलिमेंट्री स्ट्रीम
• कॉन्टेंट में रुकावटें या एम्बेड किए गए विज्ञापन
• इन डिवाइसों पर प्लेबैक: स्मार्ट डिसप्ले, Google Cast डोंगल, Android TV डिवाइस, Google Cast वाले टीवी, स्मार्ट स्पीकर

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

ऑप्ट आउट करें

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

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

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

context.start(castReceiverOptions);

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

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

1. समस्या हल करने के लिए, shakaVersion को किसी दूसरे ब्रांच वर्शन पर सेट करें. उदाहरण के लिए, अगर 4.15 ब्रांच में समस्या आ रही है, तो इसे किसी दूसरी ब्रांच में मौजूद सबसे नए वर्शन पर सेट करके देखें. सबसे काम के अपडेट वाली रिलीज़ ढूंढने के लिए, Shaka Player के रिलीज़ नोट देखें. ध्यान दें कि shakaVersion API का कम से कम और ज़्यादा से ज़्यादा काम करने वाला वर्शन होता है. अगर आपको पता चलता है कि कोई समस्या फिर से आ रही है, तो Shaka Player इश्यूट्रैकर में इसकी शिकायत करें.
2. प्लेयर के कॉन्फ़िगरेशन पैरामीटर बदलने की कोशिश करें. PlayerConfiguration ऑब्जेक्ट के ज़रिए, Shaka Player को कॉन्फ़िगर किया जा सकता है. Web Receiver SDK, डिफ़ॉल्ट वैल्यू का एक सेट तय करता है. साथ ही, ऐप्लिकेशन को इस कॉन्फ़िगरेशन में बदलाव करने की अनुमति देता है. यह बदलाव, shakaConfig प्रॉपर्टी के ज़रिए किया जाता है. यह प्रॉपर्टी, PlaybackConfig ऑब्जेक्ट में मौजूद होती है. प्लेयर इंस्टेंस बनने पर, लोड होने के दौरान इसका आकलन किया जाता है. ज़्यादा जानकारी के लिए, ऐप्लिकेशन का कॉन्फ़िगरेशन और विकल्प देखें. Web Receiver SDK की सेट की गई डिफ़ॉल्ट वैल्यू, सुझाई गई वैल्यू होती हैं.
3. देखें कि क्या इस समस्या की शिकायत, Shaka Player के इश्यूट्रैकर या Cast के इश्यूट्रैकर में की गई है. अगर गड़बड़ी की जानकारी में आपकी समस्या भी शामिल है, तो उस पर टिप्पणी करें और उससे जुड़ी कोई भी जानकारी जोड़ें.
4. Shaka Player की डेमो साइट पर अपने कॉन्टेंट की जांच करें. अगर आपको पता चलता है कि डेमो साइट पर आपके कॉन्टेंट में समस्या फिर से आ रही है, तो Shaka Player प्रोजेक्ट के साथ गड़बड़ी की शिकायत करें.
5. अगर आपको Cast एंडपॉइंट पर Shaka Player से जुड़ी कोई समस्या आ रही है, तो **Cast के इश्यू ट्रैकर में गड़बड़ी की शिकायत करें**.

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

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

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

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

प्लेयर बदलने पर, कितनी मेहनत करनी होगी?

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

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

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

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

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

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

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

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

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

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

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