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

खास जानकारी

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

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

Shaka Player के फ़ायदे

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

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

टाइमलाइन

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

फ़ेज़ (चरण)	शुरू होने की तारीख	खास जानकारी
1	अक्टूबर '22	Cast Web Receiver SDK टूल में, Shaka Player पर HLS कॉन्टेंट चलाने के लिए, ऑप्ट-इन करने के लिए एपीआई उपलब्ध कराए गए हैं.
2	नवंबर 2025	Cast Web Receiver SDK, HLS कॉन्टेंट को चलाने के लिए डिफ़ॉल्ट प्लेयर को Shaka Player में बदल देता है.

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

ऑप्ट इन करें

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

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

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

context.start(castReceiverOptions);

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

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

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

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

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

ऑप्ट आउट करें

वेब रिसीवर एसडीके, 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 एपीआई के लिए, कम से कम और ज़्यादा से ज़्यादा वर्शन उपलब्ध हैं. इनके बारे में रेफ़रंस दस्तावेज़ में बताया गया है. अगर आपको लगता है कि कोई समस्या फिर से हो रही है, तो Shaka Player के इश्यू ट्रैकर में इसकी शिकायत करें.
2. प्लेयर कॉन्फ़िगरेशन पैरामीटर बदलकर देखें. Shaka Player को PlayerConfiguration ऑब्जेक्ट के ज़रिए कॉन्फ़िगर किया जा सकता है. Web Receiver SDK, डिफ़ॉल्ट वैल्यू का एक सेट तय करता है. साथ ही, ऐप्लिकेशन को इस कॉन्फ़िगरेशन में बदलाव करने की अनुमति देता है. इसके लिए, PlaybackConfig ऑब्जेक्ट में shakaConfig प्रॉपर्टी का इस्तेमाल किया जाता है. जब प्लेयर इंस्टेंस बनाया जाता है, तब लोड होने के दौरान इसका आकलन किया जाता है. ऐप्लिकेशन कॉन्फ़िगरेशन और विकल्प में जाकर, इसके बारे में ज़्यादा जानें. Web Receiver SDK की ओर से सेट की गई डिफ़ॉल्ट वैल्यू, सुझाई गई वैल्यू होती हैं.
3. देखें कि क्या समस्या की शिकायत Shaka Player issuetracker या Cast issuetracker में की गई है. बग के बारे में टिप्पणी करें. साथ ही, अगर यह आपकी समस्या के बारे में भी बताता है, तो इससे जुड़ी कोई भी ज़रूरी जानकारी जोड़ें.
4. Shaka Player की डेमो साइट पर अपने कॉन्टेंट की जांच करें. अगर आपको लगता है कि आपके कॉन्टेंट की डेमो साइट में समस्या फिर से आ रही है, तो Shaka Player प्रोजेक्ट के साथ बग की शिकायत करें.
5. अगर आपको कास्ट एंडपॉइंट पर Shaka Player से जुड़ी कोई समस्या आ रही है, तो Cast Issue Tracker में समस्या की जानकारी दें.

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

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

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

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

खिलाड़ियों को बदलते समय, किस लेवल की मेहनत करनी होगी?

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

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

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

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

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

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

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

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

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

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

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