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

खास जानकारी

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

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

Shaka Player के फ़ायदे

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

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

टाइमलाइन

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

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

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

ऑप्ट इन करें

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

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

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

context.start(castReceiverOptions);

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

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

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

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

ऑप्ट आउट करें

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

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

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

context.start(castReceiverOptions);

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

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

1. shakaVersion को इस पर सेट करके देखें: इसके लिए, ब्रांच का इस्तेमाल करें. उदाहरण के लिए, अगर समस्या 4.3 ब्रांच में इस्तेमाल किया गया है. इसे इतने समय में सबसे नई रिलीज़ पर सेट करने की कोशिश करें 4.2.x या 3.3.x वर्शन. Shaka Player की रिलीज़ देखें नोट खोजें सबसे ज़्यादा काम के अपडेट वाली रिलीज़. ध्यान दें कि shakaVersion एपीआई में, कम से कम और ज़्यादा से ज़्यादा वैल्यू सेट की गई है के साथ काम करता है. अगर आपको लगता है कि अगर रिग्रेशन है, तो Shaka Player में समस्या की शिकायत करें समस्या को ट्रैक करने वाला टूल.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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