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

खास जानकारी

यह गाइड, एपीआई क्लाइंट ऐप्लिकेशन के उन डेवलपर के लिए है जो लाइव कॉन्टेंट स्ट्रीम करने के लिए, 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.ट्रांज़िशन का तरीका कॉल करना होगा. "ब्रॉडकास्ट की लाइफ़" गाइड में, चरण 4.3 और चरण 5.2 देखें. इससे, ब्रॉडकास्ट के शुरू और खत्म होने पर, ट्रांज़िशन को मैनेज करने से जुड़े निर्देश मिलते हैं.