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

खास जानकारी

Cast Web Receiver SDK, कई वेब स्ट्रीमिंग प्रोटोकॉल का इस्तेमाल करके कॉन्टेंट चलाने की सुविधा देता है. इस्तेमाल किए गए प्रोटोकॉल के आधार पर, 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 वीडियो चलाने पर है. इस बारे में रोडमैप में बताया गया है.

टाइमलाइन

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

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

ऑप्ट इन करें

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

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

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

context.start(castReceiverOptions);

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

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

• स्ट्रीम टाइप: लाइव या वीओडी
• कंटेनर फ़ॉर्मैट: 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 को ज़रूरी अपडेट नहीं मिलेंगे. अगर आपको एमपीएल से जुड़ी कोई समस्या आती है, तो गाइड के ऑप्ट इन करें सेक्शन में दिए गए निर्देशों का पालन करें. इससे आपको यह पुष्टि करने में मदद मिलेगी कि Shaka Player पर स्विच करने से आपकी समस्या हल हो जाएगी या नहीं. अगर अब भी समस्या बनी रहती है या प्लेयर बदलते समय आपको कोई दूसरी समस्या आती है, तो यहां दिया गया तरीका अपनाएं.

1. समस्या को हल करने के लिए, shakaVersion को किसी दूसरे ब्रांच वर्शन पर सेट करके देखें. उदाहरण के लिए, अगर 4.15 ब्रांच में समस्या आ रही है, तो इसे किसी दूसरी ब्रांच में मौजूद नए वर्शन पर सेट करके देखें. सबसे काम के अपडेट वाली रिलीज़ ढूंढने के लिए, Shaka Player की रिलीज़ से जुड़े नोट देखें. ध्यान दें कि shakaVersion API के लिए, कम से कम और ज़्यादा से ज़्यादा वर्शन उपलब्ध है. इसके बारे में रेफ़रंस दस्तावेज़ में बताया गया है. अगर आपको लगता है कि कोई रिग्रेशन आ रहा है, तो 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 स्ट्रीमिंग प्रोटोकॉल पर माइग्रेट करें, ताकि आपको परफ़ॉर्मेंस से जुड़े अपडेट मिलते रहें और आपके कॉन्टेंट के लिए सहायता मिलती रहे.

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

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