डिफ़ॉल्ट ब्रॉडकास्ट और स्ट्रीम की सुविधा बंद होने से जुड़ी माइग्रेशन गाइड

खास जानकारी

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

  • यह liveBroadcast संसाधन की isDefaultBroadcast प्रॉपर्टी की वैल्यू की जांच करता है.
  • यह liveStream संसाधन की isDefaultStream प्रॉपर्टी की वैल्यू की जांच करता है.

  • यह liveBroadcasts.list मेथड को कॉल करता है और broadcastType पैरामीटर वैल्यू को persistent पर सेट करता है. बंद होने की तारीख के बाद:

    • अगर broadcastType पैरामीटर की वैल्यू persistent है, तो liveBroadcasts.list तरीके से कोई नतीजा नहीं दिखेगा.
    • अगर broadcastType पैरामीटर की वैल्यू all है, तो liveBroadcasts.list तरीका, उस समय से पहले मौजूद स्थायी ब्रॉडकास्ट नहीं दिखाएगा.

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

क्या हो रहा है?

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

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

डिफ़ॉल्ट संसाधनों पर भरोसा करने के बजाय, एपीआई क्लाइंट को liveBroadcast और liveStream संसाधन बनाने और मैनेज करने की ज़रूरत होती है. साथ ही, इन संसाधनों को एक साथ बाइंड करने की भी ज़रूरत होती है.

ऐप्लिकेशन अपडेट करना

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

डिफ़ॉल्ट ब्रॉडकास्ट से माइग्रेट करना

इस सुविधा के बंद होने से पहले, एपीआई क्लाइंट के पास किसी चैनल के डिफ़ॉल्ट ब्रॉडकास्ट का इस्तेमाल करने या इवेंट के हिसाब से ब्रॉडकास्ट बनाने का विकल्प होता था. डिफ़ॉल्ट ब्रॉडकास्ट, एक ऐसा संसाधन था जिसे कई इवेंट के लिए फिर से इस्तेमाल किया जा सकता था. वहीं, किसी इवेंट के लिए ब्रॉडकास्ट संसाधन, एक बार इस्तेमाल होने वाला संसाधन होता है. यह सिर्फ़ एक YouTube वीडियो के लिए होता है.

अगर आपका क्लाइंट ऐप्लिकेशन liveBroadcasts.list तरीके को कॉल करता है और इनमें से कोई एक काम करता है, तो वह डिफ़ॉल्ट ब्रॉडकास्ट का इस्तेमाल करता है:

  • यह broadcastType पैरामीटर की वैल्यू को persistent पर सेट करता है. यह अनुरोध सिर्फ़ डिफ़ॉल्ट ब्रॉडकास्ट को वापस लाता है.
  • यह broadcastType पैरामीटर की वैल्यू को all पर सेट करता है. इसके बाद, एपीआई रिस्पॉन्स में उस liveBroadcast रिसॉर्स की पहचान करता है जिसके लिए isDefaultBroadcast प्रॉपर्टी की वैल्यू true है.

इस सुविधा के बंद होने के बाद, YouTube सिर्फ़ इवेंट से जुड़ी ब्रॉडकास्टिंग की सुविधा देगा. इसका मतलब है कि क्लाइंट ऐप्लिकेशन को डिफ़ॉल्ट ब्रॉडकास्ट पर निर्भर रहने के बजाय, हर ब्रॉडकास्ट इवेंट के लिए liveBroadcast रिसॉर्स बनाने होंगे.

liveBroadcast रिसॉर्स बनाने के लिए, liveBroadcasts.insert तरीके को कॉल करें. इस प्रोसेस के बारे में, "ब्रॉडकास्ट की लाइफ़" गाइड के चरण 1.1 में बताया गया है.

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

डिफ़ॉल्ट स्ट्रीम से माइग्रेट करना

स्ट्रीम की मदद से, YouTube पर ऑडियो-वीडियो कॉन्टेंट को ब्रॉडकास्ट किया जा सकता है. साथ ही, इससे यह तय होता है कि YouTube पर कॉन्टेंट को किस तरह स्ट्रीम किया जाए. ब्रॉडकास्टर के लिए, एक ही स्ट्रीम का इस्तेमाल कई अलग-अलग ब्रॉडकास्ट के लिए करना आम बात है. ऐसा तब होता है, जब वे ब्रॉडकास्ट अलग-अलग समय पर होते हैं.

भले ही, आपका ऐप्लिकेशन डिफ़ॉल्ट स्ट्रीम का इस्तेमाल न कर पाए, लेकिन वह फिर से इस्तेमाल की जा सकने वाली स्ट्रीम बना सकता है. इस स्ट्रीम का इस्तेमाल हर ब्रॉडकास्ट के लिए किया जा सकता है. liveStream संसाधन बनाने के लिए, liveStreams.insert तरीके को कॉल करें. इसके लिए, "ब्रॉडकास्ट की लाइफ़" गाइड के चरण 1.2 में दिए गए निर्देशों का पालन करें. डिफ़ॉल्ट रूप से, नई स्ट्रीम का दोबारा इस्तेमाल किया जा सकता है. हालांकि, अगर आप चाहें, तो contentDetails.isReusable प्रॉपर्टी को false पर सेट करके, एक बार इस्तेमाल होने वाली स्ट्रीम बनाई जा सकती हैं. साथ ही, ब्रॉडकास्ट और स्ट्रीम के बीच वन-टू-वन रिलेशनशिप बनाई जा सकती है.

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

ब्रॉडकास्ट को स्ट्रीम से बाइंड करना

YouTube पर लाइव ब्रॉडकास्ट शुरू करने से पहले, हर liveBroadcast संसाधन को सिर्फ़ एक स्ट्रीम से बाउंड करना ज़रूरी है. (ब्रॉडकास्ट को बनाते समय, उसे किसी भी स्ट्रीम से नहीं जोड़ा जाता.)

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

किसी ब्रॉडकास्ट को स्ट्रीम से जोड़ने के लिए, liveBroadcasts.bind तरीके को कॉल करें. इसके बारे में "ब्रॉडकास्ट की लाइफ़" गाइड के चरण 1.3 में बताया गया है.

  • अगर फिर से इस्तेमाल की जा सकने वाली स्ट्रीम का इस्तेमाल किया जा रहा है, तो एक बार स्ट्रीम बनाएं और फिर हर ब्रॉडकास्ट को उस स्ट्रीम से बाइंड करें.
  • अगर फिर से इस्तेमाल की जा सकने वाली स्ट्रीम का इस्तेमाल नहीं किया जा रहा है, तो आपको एक ब्रॉडकास्ट और एक स्ट्रीम बनानी होगी. इसके बाद, उन दोनों को एक साथ जोड़ना होगा.

ब्रॉडकास्ट की जांच करना

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

अगर आपके एपीआई क्लाइंट ने पहले डिफ़ॉल्ट ब्रॉडकास्ट और स्ट्रीम का इस्तेमाल किया था और आपको अपनी स्ट्रीमिंग प्रोसेस में टेस्टिंग फ़ेज़ जोड़ना है, तो "ब्रॉडकास्ट की लाइफ़" गाइड का तीसरा चरण देखें.

अगर आपको अपनी स्ट्रीम की जांच करनी है, तो ब्रॉडकास्ट जोड़ते समय, contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी को true पर और contentDetails.enableAutoStart प्रॉपर्टी को false पर सेट करना होगा. ये दोनों प्रॉपर्टी के लिए डिफ़ॉल्ट वैल्यू हैं.

अपने-आप शुरू और बंद होने की सुविधाओं का इस्तेमाल करना

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

डिफ़ॉल्ट ब्रॉडकास्ट के लिए, अपने-आप शुरू और बंद होने की सुविधाएं डिफ़ॉल्ट ऐक्शन और सेटिंग थीं. हालांकि, अब ये सुविधाएं वैकल्पिक हैं और इन्हें अन्य ब्रॉडकास्ट के लिए चालू करना होगा. अगर आपको इन सुविधाओं का इस्तेमाल करना है, तो ब्रॉडकास्ट को शामिल करते समय, आपको contentDetails.enableAutoStart और contentDetails.enableAutoStop प्रॉपर्टी की वैल्यू को true पर सेट करना होगा. ये सुविधाएं एक-दूसरे से अलग हैं. इसलिए, आपके पास किसी एक सुविधा को इस्तेमाल करने और दूसरी को न इस्तेमाल करने का विकल्प होता है.

अगर आपने नए ब्रॉडकास्ट के लिए, अपने-आप शुरू और बंद होने की सुविधाएं चालू नहीं की हैं, तो आपके एपीआई क्लाइंट को liveBroadcasts.transition तरीके को कॉल करना होगा. इससे, वीडियो की स्ट्रीमिंग शुरू और खत्म होने पर, ब्रॉडकास्ट की स्थिति अपडेट हो जाएगी. "लाइफ़ ऑफ़ अ ब्रॉडकास्ट" गाइड में, ब्रॉडकास्ट की शुरुआत और आखिर में इन ट्रांज़िशन को मैनेज करने के निर्देश देखें. इसके लिए, चौथा चरण 4.3 और पांचवां चरण 5.2 देखें.