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

परिचय

इस दस्तावेज़ में, YouTube पर लाइव ब्रॉडकास्ट की पूरी प्रोसेस के बारे में बताया गया है. इस ब्रॉडकास्ट को YouTube Live Streaming API और YouTube Content ID API का इस्तेमाल करके बनाया और मैनेज किया जाता है.

संसाधन और संसाधन टाइप

शुरू करने से जुड़ी गाइड में बताया गया है कि संसाधन, यूनीक आइडेंटिफ़ायर वाली एक अलग डेटा इकाई होती है. YouTube पर लाइव इवेंट बनाने और उन्हें मैनेज करने के लिए, आपको कई तरह के संसाधनों का इस्तेमाल करना होगा. इन संसाधनों को YouTube Data API या YouTube Content ID API के हिस्से के तौर पर तय किया गया है. YouTube Live Streaming API हेडर में दिए गए संसाधन, तकनीकी तौर पर अन्य एपीआई में तय किए गए हैं. हालांकि, इन्हें अलग से इसलिए लिस्ट किया गया है, क्योंकि इनका इस्तेमाल सिर्फ़ लाइव ब्रॉडकास्ट के लिए किया जाता है.

YouTube Live Streaming API के संसाधन

• liveBroadcast
• liveStream
• cuepoint

YouTube Data API के संसाधन

• video

YouTube Content ID API के संसाधन

• asset
• claim
• policy
• videoAdvertisingOption

लाइव ब्रॉडकास्ट बनाना और उसे मैनेज करना

YouTube पर लाइव इवेंट बनाने और उसे मैनेज करने का तरीका यहां बताया गया है. इस प्रोसेस को इन चरणों में बांटा गया है:

1. ब्रॉडकास्ट सेट अप करना
2. अपने कॉन्टेंट पर दावा करना
3. टेस्ट
4. ब्रॉडकास्ट
5. ब्रॉडकास्ट खत्म करना
6. वीडियो से पहचान फ़ाइल बनाना

पहला चरण: ब्रॉडकास्ट सेट अप करना

पहला चरण: ब्रॉडकास्ट बनाना

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

• snippet.title
• snippet.scheduledStartTime
• status.privacyStatus

ब्रॉडकास्ट सेट अप करते समय, कृपया इन दिशा-निर्देशों का पालन करें:

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

• अगर आपको रिकॉर्ड की गई ब्रॉडकास्ट से कोई रेफ़रंस बनाना है, तो आपको ब्रॉडकास्ट की contentDetails.recordFromStart प्रॉपर्टी को true पर सेट करना होगा. अगर आपको ब्रॉडकास्ट खत्म होने के तुरंत बाद, रिकॉर्ड किए गए वीडियो को चलाने के लिए उपलब्ध कराना है, तो आपको contentDetails.enableDvr प्रॉपर्टी को true पर भी सेट करना होगा. (इन दोनों प्रॉपर्टी की डिफ़ॉल्ट वैल्यू true होती है.)

• जब तक आपके ब्रॉडकास्ट का स्टेटस created या ready है, तब तक इनमें से किसी भी contentDetails प्रॉपर्टी को अपडेट किया जा सकता है.

• ब्रॉडकास्ट के शेड्यूल किए गए शुरू होने और खत्म होने के समय को अपडेट किया जा सकता है. हालांकि, ऐसा सिर्फ़ तब तक किया जा सकता है, जब तक ब्रॉडकास्ट का स्टेटस created, ready या testing हो.

• ब्रॉडकास्ट के टाइटल, जानकारी, निजता की स्थिति, और अन्य मेटाडेटा फ़ील्ड को कभी भी अपडेट किया जा सकता है. ये फ़ील्ड, ब्रॉडकास्ट के video रिसॉर्स का हिस्सा होते हैं.
  
  ध्यान दें: अगर आपको सिर्फ़ YouTube के कुछ उपयोगकर्ताओं के लिए अपना वीडियो उपलब्ध कराना है, तो status.privacyStatus प्रॉपर्टी की वैल्यू को अपनी ज़रूरत के हिसाब से unlisted या private पर सेट करें.

एपीआई से मिले रिस्पॉन्स को प्रोसेस करना

liveBroadcasts.insert तरीके को कॉल करने पर, एपीआई रिस्पॉन्स में आपके बनाए गए liveBroadcast संसाधन शामिल होते हैं. आपके कोड को उस संसाधन से id को एक्सट्रैक्ट और सेव करना चाहिए. आपको इस वैल्यू की ज़रूरत होगी, ताकि आने वाले समय में एपीआई के अनुरोधों में ब्रॉडकास्ट की पहचान की जा सके. (एक ही आईडी का इस्तेमाल करके, liveBroadcast रिसॉर्स से जुड़े video रिसॉर्स की पहचान भी की जा सकती है.)

पहला चरण 2: स्ट्रीम बनाना

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

अपने इवेंट के लिए वीडियो स्ट्रीम बनाने के लिए, liveStreams.insert तरीके को कॉल करें. स्ट्रीम बनाते समय, आपको यहां दी गई प्रॉपर्टी के लिए वैल्यू सेट करनी होंगी:

• snippet.title
• cdn.frameRate
• cdn.ingestionType
• cdn.resolution

स्ट्रीम के टाइटल को छोड़कर, स्ट्रीम बनाने के बाद इन वैल्यू को अपडेट नहीं किया जा सकता. अगर आपको इन्हें बदलना है, तो आपको यह चरण दोहराकर एक नई स्ट्रीम बनानी होगी. इस प्रोसेस के बारे में, इस दस्तावेज़ में बाद में चरण 3.5 में ज़्यादा जानकारी दी गई है.

आपके पास इन प्रॉपर्टी के लिए भी वैल्यू सेट करने का विकल्प होता है:

• snippet.description - स्ट्रीम का टाइटल की तरह, स्ट्रीम का ब्यौरा भी स्ट्रीम बनाने के बाद अपडेट किया जा सकता है. YouTube उपयोगकर्ताओं को न तो टाइटल दिखता है और न ही ब्यौरा.

• contentDetails.isReusable - इससे पता चलता है कि स्ट्रीम का दोबारा इस्तेमाल किया जा सकता है या नहीं. इसका मतलब है कि इसे एक से ज़्यादा ब्रॉडकास्ट से जोड़ा जा सकता है. इस प्रॉपर्टी की वैल्यू से यह तय होता है कि किसी चैनल के liveBroadcast और liveStream संसाधनों के बीच, मेनी-टू-वन या वन-टू-वन रिलेशनशिप है या नहीं:

  • अगर प्रॉपर्टी की डिफ़ॉल्ट वैल्यू true का इस्तेमाल किया जाता है, तो चैनल के सभी ब्रॉडकास्ट के लिए एक ही liveStream संसाधन का इस्तेमाल किया जा सकता है. इसका मतलब है कि आपको हर ब्रॉडकास्ट के लिए, यह चरण (1.2) दोहराने की ज़रूरत नहीं है. इसके बजाय, आने वाले समय में होने वाले ब्रॉडकास्ट के लिए, स्ट्रीम आईडी का फिर से इस्तेमाल किया जा सकता है.
  • अगर प्रॉपर्टी की वैल्यू false पर सेट की जाती है, तो आपको हर ब्रॉडकास्ट के लिए एक नई स्ट्रीम बनानी होगी.

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

पहला चरण.3: ब्रॉडकास्ट को उसकी स्ट्रीम से बाइंड करना

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

liveBroadcasts.bind तरीके को कॉल करते समय, id पैरामीटर को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें. साथ ही, streamId पैरामीटर को दूसरे चरण में मिले स्ट्रीम आईडी पर सेट करें.

दूसरा चरण: अपने कॉन्टेंट पर दावा करना

अगर आपको ब्रॉडकास्ट के दौरान विज्ञापन दिखाने हैं, तो आपको इवेंट शुरू होने से पहले ब्रॉडकास्ट वीडियो पर दावा करना होगा. इस प्रोसेस के बारे में यहां बताया गया है. ध्यान दें कि इस चरण में बताए गए सभी एपीआई कॉल, YouTube Content ID API में तय किए गए हैं.

दूसरा चरण: ऐसेट बनाना

asset संसाधन, बौद्धिक संपत्ति का एक हिस्सा होता है. इस मामले में, आपकी ब्रॉडकास्ट आपकी ऐसेट है. अपनी ऐसेट बनाने के लिए, assets.insert तरीके को कॉल करें.

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

दूसरा चरण: ऐसेट के मालिकाना हक की पुष्टि करना

किसी ऐसेट के मालिकाना हक वाले डेटा से, ऐसेट के मालिकों के साथ-साथ उन देशों/इलाकों के बारे में भी पता चलता है जहां उनके पास ऐसेट का मालिकाना हक है. YouTube इस डेटा का इस्तेमाल यह तय करने के लिए करता है कि मालिक, दावा किए गए वीडियो के लिए नीति कहां सेट कर सकता है.

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

ऐसेट के लिए, मालिकाना हक वाले इलाकों को तय करने के लिए, ownership.update तरीके का इस्तेमाल करें. उस अनुरोध में, assetId पैरामीटर को उस id पर सेट करें जिसे आपने चरण 2.1 में सेव किया था.

दूसरा चरण: ऐसेट के लिए मिलते-जुलते वीडियो से जुड़ी नीति सेट करना

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

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

मिलान नीति सेट करने के लिए, आपको सबसे पहले वह नीति चुननी होगी जिसे लागू करना है. policies.list तरीके का इस्तेमाल करके, मौजूदा नीतियों की सूची वापस पाई जा सकती है. इसके अलावा, policies.insert तरीके का इस्तेमाल करके, नई नीति तय की जा सकती है. दोनों ही मामलों में, आपको उस नीति का id कैप्चर करना होगा जिसे लागू करना है.

नीति की पहचान करने के बाद, assetMatchPolicy.update तरीके को कॉल करें. उस अनुरोध में, assetId पैरामीटर को उस id पर सेट करें जिसे आपने चरण 2.1 में सेव किया था.

दूसरा चरण.4: वीडियो पर दावा करना

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

दावा बनाने के लिए, claims.insert तरीके को कॉल करें. आपने जो claim संसाधन डाला है उसमें आपको इन प्रॉपर्टी की वैल्यू सेट करनी होंगी:

• assetId – यह वैल्यू आपको दूसरे चरण में मिली थी.
• videoId – यह ब्रॉडकास्ट आईडी है, जो आपको पहले चरण में मिला था.
• policy – This is a policy resource. किसी मौजूदा नीति को लागू करने के लिए, उस संसाधन की id प्रॉपर्टी को मौजूदा नीति के आईडी पर सेट करें. पिछले चरण में, मौजूदा नीति का आईडी वापस पाने का तरीका बताया गया है.
• contentType – इस वैल्यू को audiovisual पर सेट करें.

एपीआई से मिले रिस्पॉन्स को प्रोसेस करना

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

दूसरा चरण: ब्रॉडकास्ट के लिए विज्ञापन की सेटिंग अपडेट करना

अगर आपको दर्शकों के ब्रॉडकास्ट देखना शुरू करने पर प्रीरोल विज्ञापन दिखाना है या ब्रॉडकास्ट के दौरान ब्रेक में विज्ञापन दिखाने हैं, तो आपको अपने वीडियो के लिए विज्ञापन दिखाने के विकल्प सेट करने होंगे.

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

विज्ञापन दिखाने की सुविधा चालू करने के लिए, videoAdvertisingOptions.update तरीके को कॉल करें. अपने अनुरोध में, videoId पैरामीटर को उस ब्रॉडकास्ट id पर सेट करें जो आपको पहले चरण में मिला था. आपको जिन विज्ञापन फ़ॉर्मैट (preroll, midroll या postroll) को चालू करना है उनकी पहचान करने के लिए, videoAdvertisingOption संसाधन की adFormats[] प्रॉपर्टी का इस्तेमाल करें.

तीसरा चरण: टेस्ट करना

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

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

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

तीसरा चरण: मॉनिटर स्ट्रीम प्लेयर को एम्बेड करना

liveBroadcasts.list तरीके का इस्तेमाल करके, अपना ब्रॉडकास्ट वापस पाएं. इसके बाद, contentDetails.streamDetails.monitorStreamEmbedHtml प्रॉपर्टी की वैल्यू निकालें. इस वैल्यू में वह एचटीएमएल होता है जिसे आपको YouTube प्लेयर को एम्बेड करने के लिए इस्तेमाल करना होता है. इससे आपकी मॉनिटर स्ट्रीम दिखती है.

तीसरा चरण 2: वीडियो शुरू करना

अपनी वीडियो स्ट्रीम पर वीडियो ट्रांसमिट करना शुरू करें.

तीसरा चरण: पुष्टि करें कि आपकी वीडियो स्ट्रीम चालू है

अपने ब्रॉडकास्ट से जुड़े liveStream संसाधन को वापस पाने के लिए, liveStreams.list तरीके को कॉल करें. पुष्टि करें कि status.streamStatus प्रॉपर्टी की वैल्यू active है. इससे पता चलता है कि YouTube सर्वर को आपके एनकोडर से डेटा सही तरीके से मिल रहा है.

तीसरा चरण: ब्रॉडकास्ट की स्थिति को टेस्टिंग पर सेट करना

ब्रॉडकास्ट का स्टेटस अपडेट करने के लिए, liveBroadcasts.transition तरीके को कॉल करें. id पैरामीटर की वैल्यू को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें.साथ ही, broadcastStatus पैरामीटर की वैल्यू को testing पर सेट करें.

liveBroadcasts.transition तरीके को कॉल करने के बाद, ट्रांज़िशन को पूरा होने में कुछ सेकंड या एक मिनट तक का समय लग सकता है. इस दौरान, आपको ब्रॉडकास्ट की स्थिति देखने के लिए, एपीआई को पोल करना चाहिए. ट्रांज़िशन पूरा होने तक, ब्रॉडकास्ट का स्टेटस testStarting रहेगा. ट्रांज़िशन पूरा होने के बाद, स्टेटस testing हो जाएगा.

तीसरा चरण: टेस्टिंग पूरी करना

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

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

1. वीडियो स्ट्रीम को अनबाइंड करने के लिए, पहले चरण के 1.3 में दिए गए liveBroadcasts.bind तरीके को कॉल करें. एपीआई अनुरोध में, id पैरामीटर को चरण 1.1 में मिले id पर सेट करें. अनुरोध में streamId पैरामीटर शामिल न करें.

2. वीडियो स्ट्रीम मिटाने के लिए, liveStreams.delete तरीके को कॉल करें. अनुरोध में, id पैरामीटर को चरण 1.2 में मिले id पर सेट करें.

3. सही तरीके से कॉन्फ़िगर किया गया नया liveStream संसाधन बनाने के लिए, पहले चरण को दोहराएं. इसके बाद, नई स्ट्रीम को अपने ब्रॉडकास्ट से बाइंड करने के लिए, चरण 1.3 को दोहराएं. साथ ही, नई स्ट्रीम को टेस्ट करने के लिए, चरण 3.1 से 3.3 को दोहराएं.

तीसरा चरण.6: autoStart और autoStop प्रॉपर्टी चालू करना

ध्यान दें: यह चरण ज़रूरी नहीं है.

जांच पूरी होने के बाद, ब्रॉडकास्ट शुरू होने से पहले, ब्रॉडकास्ट की contentDetails.enableAutoStart और contentDetails.enableAutoStop प्रॉपर्टी को true पर सेट किया जा सकता है. इन प्रॉपर्टी को टेस्टिंग स्टेज से पहले true पर सेट नहीं किया जा सकता. ऐसा इसलिए, क्योंकि टेस्ट की वजह से ब्रॉडकास्ट शुरू हो जाएगा.

चौथा चरण: ब्रॉडकास्ट करना

इस चरण के दौरान, ब्रॉडकास्ट किया जा रहा वीडियो आपके दर्शकों को दिखता है.

चौथा चरण: वीडियो शुरू करना

अपनी वीडियो स्ट्रीम पर वीडियो ट्रांसमिट करना शुरू करें.

चौथा चरण.2: पुष्टि करें कि आपकी वीडियो स्ट्रीम चालू है

अपने ब्रॉडकास्ट से जुड़े liveStream संसाधन को वापस पाने के लिए, liveStreams.list तरीके को कॉल करें. पुष्टि करें कि status.streamStatus प्रॉपर्टी की वैल्यू active है. इससे पता चलता है कि YouTube सर्वर को आपके एनकोडर से डेटा सही तरीके से मिल रहा है.

चौथा चरण: ब्रॉडकास्ट की स्थिति को लाइव पर सेट करना

अहम जानकारी: इस चरण के बाद, आपका वीडियो दर्शकों को दिखने लगेगा.

ब्रॉडकास्ट का स्टेटस अपडेट करने के लिए, liveBroadcasts.transition तरीके को कॉल करें. id पैरामीटर की वैल्यू को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें.साथ ही, broadcastStatus पैरामीटर की वैल्यू को live पर सेट करें.

अगर आपने liveBroadcast संसाधन की contentDetails.enableAutoStart प्रॉपर्टी को true पर सेट किया है, तो आपको liveBroadcasts.transition तरीके को कॉल करने की ज़रूरत नहीं है.

इस एपीआई कॉल को करने के बाद या अगर आपने contentDetails.enableAutoStart प्रॉपर्टी को true पर सेट किया है, तो स्ट्रीमिंग शुरू करने के बाद, आपको ट्रांज़िशन पूरा होने के लिए आम तौर पर पांच से 10 सेकंड तक इंतज़ार करना होगा. बदलाव होने में एक मिनट तक लग सकता है. इस दौरान, आपको ब्रॉडकास्ट का स्टेटस देखने के लिए, एपीआई को पोल करना चाहिए. ट्रांज़िशन पूरा होने तक, ब्रॉडकास्ट का स्टेटस liveStarting रहेगा. ट्रांज़िशन पूरा होने के बाद, स्टेटस live हो जाएगा. इसके बाद, दर्शक मॉनिटर स्ट्रीम में उस पॉइंट से आपका ब्रॉडकास्ट देख पाएंगे.

इस कमांड के इन असर पर ध्यान दें:

• अगर आपने ब्रॉडकास्ट के लिए मॉनिटर स्ट्रीम चालू की है, तो आपको एम्बेड किए गए प्लेयर में मॉनिटर स्ट्रीम दिखेगी. इसके लिए, चरण 3.1 देखें.
• अगर आपने ब्रॉडकास्ट की contentDetails.streamDetails.broadcastStreamDelayMs प्रॉपर्टी के लिए कोई वैल्यू सेट की है, तो अन्य दर्शकों को दिखने वाली ब्रॉडकास्ट स्ट्रीम, उस वैल्यू के हिसाब से देर से दिखेगी.

चौथा चरण 4: ब्रॉडकास्ट में विज्ञापन ब्रेक डालना

कोई क्यूपॉइंट डालने के लिए, liveBroadcasts.cuepoint तरीके को कॉल करें. ऐसा हो सकता है कि क्यूपॉइंट की वजह से विज्ञापन विराम ट्रिगर हो जाए. अनुरोध के मुख्य भाग में दिए गए cuepoint संसाधन में, durationSecs प्रॉपर्टी को ब्रेक की उस अवधि (सेकंड में) पर सेट करें जिसे आपको दिखाना है. (डिफ़ॉल्ट वैल्यू 30 है.)

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

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

पांचवां चरण: ब्रॉडकास्ट खत्म करना

पांचवां चरण: स्ट्रीमिंग बंद करना

YouTube के लाइव ब्रॉडकास्ट सिस्टम का टेस्ट खत्म हो गया है.

पांचवां चरण 2: ब्रॉडकास्ट की स्थिति को 'पूरा हो गया' पर सेट करना

ध्यान दें: अगर आपने liveBroadcast संसाधन की contentDetails.enableAutoStop प्रॉपर्टी को true पर सेट किया है, तो आपको यह चरण पूरा करने की ज़रूरत नहीं है. लाइव स्ट्रीम पर वीडियो भेजना बंद करने के करीब एक मिनट बाद, YouTube ब्रॉडकास्ट को अपने-आप बंद कर देगा.

ब्रॉडकास्ट करना बंद करने के लिए, एपीआई के liveBroadcasts.transition तरीके का इस्तेमाल करके, ब्रॉडकास्ट का स्टेटस अपडेट करें. id पैरामीटर की वैल्यू को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें.साथ ही, broadcastStatus पैरामीटर की वैल्यू को complete पर सेट करें.

अगर आपने ब्रॉडकास्ट की contentDetails.recordFromStart और contentDetails.enableDvr प्रॉपर्टी को true पर सेट किया है, तो लाइव इवेंट खत्म होने के बाद, दर्शक तुरंत लाइव इवेंट का प्लेबैक देख सकते हैं.

छठा चरण: वीडियो से पहचान फ़ाइल बनाना

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

अहम जानकारी: रेफ़रंस बनाने के लिए, आपको ब्रॉडकास्ट की contentDetails.recordFromStart प्रॉपर्टी को true पर सेट करना होगा.

छठा चरण: वीडियो के स्टेटस के लिए Data API को पोल करना

किसी ब्रॉडकास्ट या अपलोड किए गए वीडियो का रेफ़रंस बनाने से पहले, YouTube को उस वीडियो को प्रोसेस करना होगा. यह पता लगाने के लिए कि वीडियो की प्रोसेसिंग पूरी हो गई है या नहीं, YouTube Data API के videos.list तरीके को पोल करें.इसके लिए, part पैरामीटर को status पर सेट करें और id पैरामीटर को उस ब्रॉडकास्ट आईडी पर सेट करें जिसे आपने पहले चरण में सेव किया था.

पोलिंग के आपके अनुरोध के लिए एपीआई के जवाब में video संसाधन शामिल होगा. जब उस संसाधन की status.uploadStatus प्रॉपर्टी की वैल्यू processed हो, तब छठे चरण पर जाएं.

छठा चरण.2: प्रोसेस किए गए वीडियो से रेफ़रंस बनाना

अपना रेफ़रंस बनाने के लिए, Content ID API के references.insert तरीके को कॉल करें और claimId पैरामीटर को उस दावे के आईडी पर सेट करें जिसे आपने चरण 2.4 में सेव किया था.

लाइव कॉन्टेंट के लिए Content ID की सुविधा

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

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