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

खास जानकारी

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

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

Shaka Player के फ़ायदे

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

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

टाइमलाइन

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

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

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

ऑप्ट इन करें

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

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 प्रॉपर्टी को हटा दें. इससे आपका ऐप्लिकेशन, वेब रिसीवर के SDK टूल में हुए नए बदलावों के साथ अप-टू-डेट रहता है. Shaka Player के डिफ़ॉल्ट वर्शन में किए गए बदलावों को रिलीज़ नोट में पोस्ट किया जाता है और cast-sdk-announcements Google ग्रुप की मदद से जानकारी दी जाती है.

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

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

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

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

ऑप्ट आउट करें

टाइमलाइन के हिसाब से, वेब रिसीवर SDK टूल को Shaka Player HLS से वीडियो चलाने के लिए ऑप्ट-आउट मॉडल में बदल दिया जाएगा. प्रॉपर्टी useShakaForHls अपनी डिफ़ॉल्ट वैल्यू को false से बदलकर true कर देगी. उस समय ऐप्लिकेशन में इस प्रॉपर्टी को मैन्युअल तरीके से false पर सेट करके, HLS वीडियो चलाने के लिए MPL का इस्तेमाल करने का विकल्प चुना जा सकता है. CastReceiverContext के शुरू होने पर, वेब रिसीवर के लिए 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.3 ब्रांच में कोई समस्या आई है, तो इसे 4.2.x या 3.3.x वर्शन में, नए वर्शन पर सेट करें. सबसे ज़्यादा काम के अपडेट वाली रिलीज़ ढूंढने के लिए, Shaka Player के रिलीज़ नोट देखें. ध्यान दें कि shakaVersion एपीआई का कम से कम और ज़्यादा से ज़्यादा वर्शन उपलब्ध है, जैसा कि रेफ़रंस दस्तावेज़ में बताया गया है. अगर आपको पता चलता है कि किसी तरह की रिग्रेशन हुई है, तो Shaka प्लेयर जारी करने वाले ट्रैकर में समस्या की शिकायत करें.

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

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

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

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

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

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

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

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

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

खिलाड़ियों को बदलते समय किस हद तक कोशिश करनी चाहिए?

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

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

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

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

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

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

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

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

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

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

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