शाका प्लेयर पर 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 का इस्तेमाल करेगा. पार्टनर को माइग्रेशन की प्रोसेस के बारे में बताने के लिए, यह काम चरणों में किया जाएगा.

फ़ेज़ (चरण)	शुरू होने की तारीख	खास जानकारी
1	अक्टूबर 2022	Cast Web Receiver SDK ने, Shaka Player पर HLS कॉन्टेंट चलाने के लिए एपीआई लॉन्च किए हैं, ताकि ऑप्ट-इन किया जा सके.
2	18 मई, 2026	Cast 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.53 वर्शन सेट करना चाहिए, ताकि HLS में किए गए नए सुधारों का फ़ायदा लिया जा सके. ऑप्ट-इन करने के लिए, यहां दिया गया कोड स्निपेट इस्तेमाल करें:

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

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

context.start(castReceiverOptions);

ध्यान दें: सेट करने पर, shakaVersion प्रॉपर्टी, Shaka Player के वर्शन को पिन कर देती है. इससे, Web Receiver SDK की तय की गई डिफ़ॉल्ट वैल्यू बदल जाती है. हमारा सुझाव है कि Shaka Player का डिफ़ॉल्ट वर्शन, आपके सेट किए गए वर्शन से ज़्यादा होने पर, shakaVersion प्रॉपर्टी को हटा दें. इससे आपका ऐप्लिकेशन, Web Receiver SDK में किए गए नए बदलावों के साथ अप-टू-डेट रहेगा. Shaka Player के डिफ़ॉल्ट वर्शन में किए गए बदलावों को, रिलीज़ नोट में पोस्ट किया जाता है. साथ ही, इनकी जानकारी cast-sdk-announcements Google ग्रुप के ज़रिए दी जाती है.

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

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

• स्ट्रीम टाइप: LIVE या VOD
• कंटेनर फ़ॉर्मैट: TS, MP4 या एलिमेंट्री स्ट्रीम
• ऐसा कॉन्टेंट जिसमें रुकावटें हों या एम्बेड किए गए विज्ञापन हों
• इन डिवाइसों पर कॉन्टेंट चलाना: स्मार्ट डिसप्ले, 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 के रिलीज़ नोट देखें. ध्यान दें कि रेफ़रंस दस्तावेज़ में दी गई जानकारी के मुताबिक, the 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 के Issue Tracker में गड़बड़ी की शिकायत करें.

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

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

क्या मुझे 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 पर आने वाली समस्याओं के बारे में गड़बड़ी की शिकायत करें. पार्टनर को MPL का इस्तेमाल बंद कर देना चाहिए.

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

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

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

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