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

खास जानकारी

यह गाइड, एपीआई क्लाइंट ऐप्लिकेशन के उन डेवलपर के लिए है जो लाइव कॉन्टेंट स्ट्रीम करने के लिए, 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 देखें.