ব্রডকাস্টের মেয়াদ

ভূমিকা

এই ডকুমেন্ট আপনাকে YouTube-এ লাইভ ব্রডকাস্টের জীবনচক্রের ব্যাপারে জানাবে যা YouTube Live Streaming API এবং YouTube Content ID API ব্যবহার করে তৈরি ও ম্যানেজ করা হয়।

রিসোর্স ও রিসোর্সের ধরন

শুরু করার নির্দেশিকা-তে যেমন ব্যাখ্যা করা হয়েছে, রিসোর্স হল অনন্য শনাক্তকারী সহ একটি স্বতন্ত্র ডেটা এন্টিটি। YouTube-এ লাইভ ইভেন্ট তৈরি ও ম্যানেজ করতে, আপনি বিভিন্ন ধরনের রিসোর্স ব্যবহার করবেন যেগুলি YouTube Data API অথবা YouTube Content ID API-এর অংশ হিসেবে সংজ্ঞায়িত করা হয়েছে। YouTube Live Streaming API হেডারের অধীনে তালিকাভুক্ত রিসোর্সগুলি টেকনিক্যালি অন্যান্য API-তে সংজ্ঞায়িত করা হয়েছে, তবে সেগুলি আলাদাভাবে তালিকাভুক্ত করা হয়েছে কারণ সেগুলি শুধুমাত্র লাইভ ব্রডকাস্টের জন্য ব্যবহৃত হয়।

YouTube Live Streaming API রিসোর্স

YouTube Data API রিসোর্স

YouTube Content ID API রিসোর্স

লাইভ সম্প্রচার তৈরি ও ম্যানেজ করা

YouTube-এ কীভাবে লাইভ ইভেন্ট তৈরি ও ম্যানেজ করতে হয় তা নিম্নলিখিত ধাপগুলি থেকে জানতে পারবেন। ধাপগুলিকে নিম্নলিখিত পর্যায়ে ভাগ করা হয়েছে:

  1. আপনার ব্রডকাস্ট সেট-আপ করুন
  2. আপনার কন্টেন্ট দাবি করা
  3. পরীক্ষা করুন
  4. ব্রডকাস্ট
  5. আপনার ব্রডকাস্ট শেষ করা
  6. রেফারেন্স তৈরি করা

পর্যায় ১: আপনার ব্রডকাস্ট সেট-আপ করা

ধাপ ১.১: আপনার ব্রডকাস্ট তৈরি করুন

YouTube-এর লাইভ ইভেন্টের শিডিউলে আপনার ব্রডকাস্ট যোগ করতে liveBroadcasts.insert মেথড কল করুন। আপনি যে liveBroadcast রিসোর্স যোগ করছেন, সেটির জন্য নিচে তালিকাভুক্ত প্রপার্টির ভ্যালু উল্লেখ করতে হবে।

আপনার ব্রডকাস্ট সেট-আপ করার সময় নিম্নলিখিত নির্দেশিকা বিবেচনা করুন:

  • আপনি যদি ব্রডকাস্টের জন্য একটি টেস্টিং ফেজ রাখতে চান, যখন আপনি অন্যান্য দর্শকদের ব্রডকাস্ট দেখতে না দিয়েও আপনার ভিডিও ব্রডকাস্ট দেখতে পারবেন, আপনাকে অবশ্যই contentDetails.monitorStream.enableMonitorStream প্রপার্টি true-এ এবং contentDetails.enableAutoStart প্রপার্টি false-এ সেট করতে হবে। এই দুটি প্রপার্টির ডিফল্ট ভ্যালু এগুলি।

  • আপনার রেকর্ড করা ব্রডকাস্ট থেকে রেফারেন্স তৈরি করতে চাইলে, আপনাকে ব্রডকাস্টের contentDetails.recordFromStart প্রপার্টি true-এ সেট করতে হবে। ব্রডকাস্ট শেষ হওয়ার সাথে সাথেই রেকর্ড করা ভিডিও প্লেব্যাকের জন্য উপলভ্য করতে চাইলে, আপনাকে contentDetails.enableDvr প্রপার্টি true হিসেবে সেট করতে হবে। (এই দুটি প্রপার্টিরই ডিফল্ট ভ্যালু হল true।)

  • আপনার ব্রডকাস্ট যেসব অঞ্চলে দেখা যাবে তা সীমাবদ্ধ করতে চাইলে, আপনি contentDetails.availabilityConfig প্রপার্টি সেট করতে পারেন। এই প্রপার্টি আপনাকে নির্দিষ্ট অঞ্চল ব্লক করতে অথবা অঞ্চলের নির্দিষ্ট তালিকায় উপলভ্যতা সীমিত করতে দেয়। এছাড়াও, আপনি আঞ্চলিক উপলভ্যতার জন্য সময়সীমা নির্দিষ্ট করতে পারবেন।

  • আপনি চাইলে snippet.categoryId প্রপার্টি ব্যবহার করে ব্রডকাস্টের জন্য ভিডিওর বিভাগ নির্দিষ্ট করতে পারেন। উল্লেখ করা না থাকলে, ডিফল্ট হিসেবে বিভাগ Entertainment হবে।

  • আপনার ব্রডকাস্টের স্ট্যাটাস created বা ready থাকলে, আপনি যেকোনও contentDetails প্রপার্টি আপডেট করতে পারবেন।

  • ব্রডকাস্টের স্ট্যাটাস created, ready বা testing হলে, আপনি ব্রডকাস্টের শিডিউল করা শুরু হওয়ার সময় ও শেষ হওয়ার সময় আপডেট করতে পারবেন।

  • ব্রডকাস্টের শীর্ষক, বিবরণ, বিভাগ ও গোপনীয়তা স্ট্যাটাস এবং অন্যান্য মেটাডেটা ফিল্ড যা ব্রডকাস্টের video রিসোর্সের অংশ, যেকোনও সময় আপডেট করা যেতে পারে।

    মনে রাখবেন: আপনি যদি চান যে আপনার ভিডিও শুধুমাত্র নির্দিষ্ট YouTube ব্যবহারকারীদের জন্য উপলভ্য হোক, তাহলে আপনার প্রয়োজন অনুযায়ী status.privacyStatus প্রপার্টি ভ্যালু unlisted বা private-এ সেট করুন।

API রেসপন্স প্রসেস করা হচ্ছে

আপনি liveBroadcasts.insert মেথড কল করলে, API রেসপন্সে আপনার তৈরি করা liveBroadcast রিসোর্স থাকে। আপনার কোডকে সেই রিসোর্স থেকে id এক্সট্র্যাক্ট ও স্টোর করতে হবে। ভবিষ্যতে API অনুরোধে ব্রডকাস্ট শনাক্ত করার জন্য আপনার এই ভ্যালু প্রয়োজন হবে। (এছাড়াও, আপনি একই আইডি ব্যবহার করে liveBroadcast রিসোর্সের সাথে সম্পর্কিত video রিসোর্স শনাক্ত করতে পারেন।)

ধাপ ১.২: আপনার স্ট্রিম তৈরি করুন

liveStream রিসোর্স আপনাকে YouTube-এ ভিডিও ট্রান্সমিট করতে দেয় এবং আপনি যে কন্টেন্ট ট্রান্সমিট করছেন সেটি বর্ণনা করে। প্রতিটি ব্রডকাস্ট অবশ্যই ঠিক একটি স্ট্রিমের সাথে যুক্ত হতে হবে।

আপনার ইভেন্টের জন্য ভিডিও স্ট্রিম তৈরি করতে liveStreams.insert মেথড কল করুন। আপনার স্ট্রিম তৈরি করার সময়, নিচে তালিকাভুক্ত প্রপার্টির জন্য আপনাকে অবশ্যই ভ্যালু সেট করতে হবে:

স্ট্রিমের নাম ছাড়া, স্ট্রিম তৈরি হওয়ার পরে এইসব ভ্যালু আপডেট করা যায় না। আপনাকে সেগুলি পরিবর্তন করতে হলে, এই ধাপটি আবার অনুসরণ করে একটি আলাদা স্ট্রিম তৈরি করতে হবে। এই প্রসেসটি সম্পর্কে আরও বিস্তারিতভাবে এই ডকুমেন্টের ধাপ ৩.৫-এ আলোচনা করা হয়েছে।

এছাড়াও, আপনার কাছে নিম্নলিখিত প্রপার্টির জন্য ভ্যালু সেট করার বিকল্প আছে:

  • snippet.description - স্ট্রিমের শীর্ষক, স্ট্রিমের বিবরণের মতো বিষয়গুলি স্ট্রিম তৈরি হওয়ার পরে আপডেট করা যেতে পারে। YouTube ব্যবহারকারীরা ভিডিওর শীর্ষক বা বিবরণ দেখতে পাবেন না।

  • [contentDetails.isReusable](

    /youtube/data/live/reference/rest/v3/liveStreams#contentDetails.isReusable)

    স্ট্রিমটি আবার ব্যবহারযোগ্য কিনা তা নির্দেশ করে, যার অর্থ হল এটি একাধিক ব্রডকাস্টের সাথে বাউন্ড করা যেতে পারে। এই প্রপার্টির ভ্যালু কার্যকরভাবে নির্ধারণ করে যে liveBroadcast এবং liveStream রিসোর্সের মধ্যে একটি চ্যানেলের অনেক-থেকে-এক বা এক-থেকে-এক সম্পর্ক আছে কিনা:

    • আপনি যদি প্রপার্টির ডিফল্ট ভ্যালু true ব্যবহার করেন, তাহলে চ্যানেলের সব ব্রডকাস্টের জন্য একই liveStream রিসোর্স ব্যবহার করতে পারবেন। এর অর্থ হল, প্রতিটি ব্রডকাস্টের জন্য আপনাকে এই ধাপ (১.২) রিপিট করতে হবে না। পরিবর্তে, আপনি পরবর্তী ব্রডকাস্টের জন্য স্ট্রিম আইডি আবার ব্যবহার করতে পারবেন।
    • আপনি যদি প্রপার্টির ভ্যালু false-এ সেট করেন, তাহলে আপনাকে প্রতিটি ব্রডকাস্টের জন্য একটি নতুন স্ট্রিম তৈরি করতে হবে।

আপনি API অনুরোধ পাঠানোর পরে, API-এর উত্তর আপনার তৈরি করা liveStream রিসোর্স থাকে। আপনার কোডকে সেই রিসোর্স থেকে id এক্সট্র্যাক্ট ও স্টোর করতে হবে। ভবিষ্যতে API অনুরোধে স্ট্রিম শনাক্ত করতে এই মানটি আপনার প্রয়োজন হবে।

ধাপ ১.৩: আপনার ব্রডকাস্টকে এর স্ট্রিমের সাথে বাইন্ড করা

আপনার liveBroadcast এবং liveStream রিসোর্স তৈরি করার পরে, আপনাকে এখন liveBroadcasts.bind পদ্ধতি ব্যবহার করে দুটিকে যুক্ত করতে হবে। এই অ্যাকশন ভিডিওর সেইসব বিট লিঙ্ক করে যা আপনি YouTube-এ ট্রান্সমিট করবেন এবং সেই ভিডিওর জন্য ইভেন্ট ব্রডকাস্ট করবেন।

liveBroadcasts.bind মেথড কল করার সময়, id প্যারামিটারকে ১.১ ধাপে পাওয়া ব্রডকাস্ট আইডিতে এবং streamId প্যারামিটারকে ১.২ ধাপে পাওয়া স্ট্রিম আইডিতে সেট করুন।

ধাপ ২: আপনার কন্টেন্ট দাবি করুন

আপনি যদি ব্রডকাস্ট চলাকালীন বিজ্ঞাপন দেখাতে চান, তাহলে ইভেন্ট শুরু হওয়ার আগে আপনাকে ব্রডকাস্ট ভিডিও দাবি করতে হবে। ব্রডকাস্ট, এর ভিডিও ও বিজ্ঞাপন সেট-আপ করতে এইসব ধাপ অনুসরণ করুন। মনে রাখবেন, ব্রডকাস্ট মালিকের চ্যানেল বিজ্ঞাপন দেখানোর উপযুক্ত হতে হবে।

মনে রাখবেন, এই ধাপে আলোচনা করা সব API কল YouTube Content ID API-তে সংজ্ঞায়িত করা হয়েছে।

ধাপ ২.১: অ্যাসেট তৈরি করা

asset রিসোর্স কোনও মেধা সম্পত্তিকে উপস্থাপন করে। এই ক্ষেত্রে, অ্যাসেট হল আপনার ব্রডকাস্ট। আপনার অ্যাসেট তৈরি করতে assets.insert পদ্ধতি কল করুন।

API রেসপন্সে আপনার তৈরি করা asset রিসোর্স থাকবে। আপনার কোডকে ওই রিসোর্স থেকে id এক্সট্র্যাক্ট করে স্টোর করতে হবে, কারণ ভবিষ্যতে API অনুরোধে অ্যাসেট শনাক্ত করার জন্য আপনার এই ভ্যালু প্রয়োজন হবে।

ধাপ ২.২: অ্যাসেটের উপর আপনার মালিকানা নির্ধারণ করুন

অ্যাসেটের মালিকানা সংক্রান্ত ডেটা থেকে অ্যাসেটের মালিকদের পাশাপাশি তারা যেসব অঞ্চলে অ্যাসেটের মালিক সেইসব অঞ্চলকেও শনাক্ত করা যায়। YouTube এই ডেটা ব্যবহার করে নির্ধারণ করে যে মালিক কোথায় দাবি করা ভিডিওর জন্য নীতি সেট করতে পারবেন।

যেমন, আপনার যদি মার্কিন যুক্তরাষ্ট্রে কোনও ইভেন্ট সম্প্রচার করার অধিকার থাকে, এবং অন্য কোনও ব্রডকাস্টারের যদি কানাডায় একই অধিকার থাকে, তাহলে আপনারা প্রত্যেকেই সম্প্রচার করা ভিডিও এবং ব্যবহারকারীর আপলোড করা ভিডিওর জন্য আলাদা আলাদা নীতি নির্ধারণ করতে পারেন যেগুলি সম্প্রচার করা ভিডিওর সাথে মেলে। মার্কিন যুক্তরাষ্ট্রে ব্যবহারকারীর আপলোড করা ভিডিওর সাথে মিলে যাওয়া ভিডিওর ক্ষেত্রে আপনার সমরূপতার নীতি প্রযোজ্য হবে, অন্যদিকে কানাডায় মিলে যাওয়া ভিডিওর ক্ষেত্রে অন্য মালিকের নীতি প্রযোজ্য হবে।

অ্যাসেটের জন্য আপনার মালিকানার অঞ্চল নির্ধারণ করতে, ownership.update পদ্ধতি কল করুন। সেই অনুরোধে, assetId প্যারামিটারটিকে id হিসেবে সেট করুন যা আপনি ২.১ ধাপে সেভ করেছেন।

ধাপ ২.৩: অ্যাসেটের সমরূপতার নীতি সেট করা

কোনও অ্যাসেটের মিলে যাওয়া সংক্রান্ত নীতি থেকে বোঝা যায় যে, কোনও ব্যবহারকারী অ্যাসেটের সাথে যুক্ত রেফারেন্সের সাথে মিলে যাওয়া ভিডিও আপলোড করলে YouTube-এর কী করা উচিত। এই ক্ষেত্রে, সমরূপতার নীতি থেকে বোঝা যাবে যে আপনার লাইভ ব্রডকাস্টের সাথে মিলে যাওয়া আপলোড করা ভিডিওর ক্ষেত্রে YouTube-এর কী করা উচিত।

মনে রাখবেন: আপনি যদি ব্রডকাস্ট ভিডিও থেকে রেফারেন্স তৈরি করার এবং সেই রেফারেন্স ব্যবহার করে আপনার ব্রডকাস্টের সাথে মিলে যায় এমন ব্যবহারকারীর আপলোড করা ভিডিও শনাক্ত করার পরিকল্পনা করেন, তাহলে আপনাকে সমরূপতার নীতি সেট করতে হবে। অন্যথায়, আপনি এই ধাপটি এড়িয়ে যেতে পারেন।

সমরূপতার নীতি সেট করতে, আপনাকে প্রথমে সেই নীতিটি শনাক্ত করতে হবে যা আপনি প্রয়োগ করতে চান। আপনি policies.list পদ্ধতি কল করে আগে থেকে থাকা নীতির তালিকা ফিরিয়ে আনতে পারেন অথবা policies.insert পদ্ধতি কল করে নতুন নীতি সংজ্ঞায়িত করতে পারেন। যেকোনও ক্ষেত্রে, আপনি যে নীতি প্রয়োগ করতে চান তার id ক্যাপচার করতে হবে।

আপনি নীতি শনাক্ত করার পরে, assetMatchPolicy.update মেথড কল করুন। সেই অনুরোধে, ধাপ ২.১-এ আপনার সেভ করা id-এ assetId প্যারামিটার সেট করুন।

ধাপ ২.৪: আপনার ভিডিও দাবি করুন

এই ধাপে, আপনি একটি দাবি তৈরি করেন, যা আপনার ব্রডকাস্ট করা ভিডিওটিকে ২.১ ধাপে তৈরি করা অ্যাসেটের সাথে লিঙ্ক করে। দাবিটি এমন একটি নীতি সেট করে যা শুধুমাত্র আপনার ব্রডকাস্ট ভিডিওর ক্ষেত্রে প্রযোজ্য। (ব্যবহারকারীর আপলোড করা ভিডিও যা আপনার ব্রডকাস্ট ভিডিওর সাথে মেলে সেগুলি আগের ধাপে সেট করা ম্যাচ নীতি দ্বারা কভার করা হয়।)

দাবি তৈরি করতে, claims.insert পদ্ধতি কল করুন। আপনি যে claim রিসোর্স যোগ করেন, সেটিতে নিম্নলিখিত প্রপার্টির জন্য ভ্যালু সেট করতে হবে:

  • assetId – আপনি এই ভ্যালু ২.১ ধাপে পেয়েছেন।
  • videoId – এটি হল ব্রডকাস্ট আইডি যা আপনি ১.১ ধাপে পেয়েছেন।
  • policy – এটি একটি policy রিসোর্স। আপনি আগে থেকে থাকা নীতিতে সেই রিসোর্সের id প্রপার্টি সেট করে আগে থেকে থাকা নীতি প্রয়োগ করতে পারবেন। আগের ধাপে ব্যাখ্যা করা হয়েছে যে কীভাবে আগে থেকে থাকা নীতির আইডি ফিরিয়ে আনা যায়।
  • contentType – এই ভ্যালু audiovisual-এ সেট করুন।

API রেসপন্স প্রসেস করা হচ্ছে

আপনি দাবি যোগ করলে, API রেসপন্সে আপনার তৈরি করা claim রিসোর্স থাকবে। আপনার কোডকে সেই রিসোর্স থেকে id এক্সট্র্যাক্ট ও স্টোর করতে হবে। প্রসেস করা ভিডিও থেকে রেফারেন্স তৈরি করার জন্য আপনি পরে সেই ভ্যালু ব্যবহার করবেন।

ধাপ ২.৫: ব্রডকাস্টের জন্য বিজ্ঞাপনের সেটিংস আপডেট করা

আপনার ভিডিওর জন্য বিজ্ঞাপন দেখানোর বিকল্প সেট করতে হবে, যদি আপনি দর্শকরা আপনার ব্রডকাস্ট দেখা শুরু করার সময় প্রি-রোল বিজ্ঞাপন চালাতে চান অথবা আপনার ব্রডকাস্টে বিরতির সময় বিজ্ঞাপন চালাতে চান।

  • আপনার ব্রডকাস্টের জন্য প্রি-রোল বিজ্ঞাপন চালু করলে, সব দর্শক আপনার ব্রডকাস্ট দেখা শুরু করার সময় একটি বিজ্ঞাপন দেখতে পাবেন, এমনকি তারা ব্রডকাস্টের মাঝখানে দেখা শুরু করলেও এটি প্রযোজ্য হবে।
  • আপনার ব্রডকাস্টের জন্য মিডরোল বিজ্ঞাপন চালু করলে, ব্রডকাস্ট চলাকালীন আপনি বিজ্ঞাপন কিউপয়েন্ট যোগ করতে পারবেন।

বিজ্ঞাপন চালু করতে, videoAdvertisingOptions.update পদ্ধতি কল করুন। আপনার অনুরোধে, আপনি ১.১ ধাপে যে ব্রডকাস্ট id পেয়েছেন, সেটির জন্য videoId প্যারামিটার সেট করুন। আপনি যে বিজ্ঞাপনের ফর্ম্যাট (preroll, midroll বা postroll) চালু করতে চান, সেটি শনাক্ত করতে videoAdvertisingOption রিসোর্সের adFormats[] প্রপার্টি ব্যবহার করুন।

পর্যায় ৩: পরীক্ষা

এই পর্যায়ে, আপনি এমন একটি প্লেয়ার এম্বেড করেন যা আপনার ব্রডকাস্টের জন্য মনিটর স্ট্রিম দেখায় যাতে আপনি দেখার অভিজ্ঞতা পরীক্ষা করতে পারেন। মনিটর স্ট্রিম হল একটি ব্যক্তিগত স্ট্রিম যা আপনাকে ব্রডকাস্ট ভিডিওর প্রিভিউ দেখায়, ঠিক যেমনটি YouTube দর্শকরা দেখতে পাবেন।

মনে রাখবেন, আপনার ভিডিও ব্রডকাস্টের মনিটর স্ট্রিম চালু করা থাকলে তবেই আপনি সেটি পরীক্ষা করতে পারবেন। ডিফল্ট হিসেবে, ব্রডকাস্টের মনিটর স্ট্রিম চালু করা থাকে। কোনও ব্রডকাস্ট তৈরি বা আপডেট করার সময় contentDetails.monitorStream.enableMonitorStream প্রপার্টি false হিসেবে সেট করে আপনি কোনও ব্রডকাস্টের মনিটর স্ট্রিম বন্ধ করতে পারবেন।

ধাপ ৩.১: মনিটর স্ট্রিম প্লেয়ার এম্বেড করা

liveBroadcasts.list পদ্ধতি ব্যবহার করে আপনার ব্রডকাস্ট রিট্রিভ করুন এবং contentDetails.streamDetails.monitorStreamEmbedHtml প্রপার্টির ভ্যালু এক্সট্র্যাক্ট করুন। এই ভ্যালুতে HTML থাকে যা আপনার মনিটর স্ট্রিম দেখানোর জন্য YouTube প্লেয়ার এম্বেড করতে প্রয়োজন হয়।

ধাপ ৩.২: আপনার ভিডিও শুরু করুন

আপনার ভিডিও স্ট্রিমে ভিডিও ট্রান্সমিট করা শুরু করুন।

ধাপ ৩.৩: আপনার ভিডিও স্ট্রিম অ্যাক্টিভ আছে কিনা তা কনফার্ম করুন

আপনার ব্রডকাস্টের সাথে যুক্ত liveStream রিসোর্স পেতে liveStreams.list পদ্ধতি কল করুন। কনফার্ম করুন যে status.streamStatus প্রপার্টির ভ্যালু হল active, যা ইঙ্গিত করে যে YouTube সার্ভার আপনার এনকোডার থেকে সঠিকভাবে ডেটা পাচ্ছে।

ধাপ ৩.৪: আপনার ব্রডকাস্টের স্ট্যাটাস টেস্টিংয়ে পরিবর্তন করুন

ব্রডকাস্টের স্ট্যাটাস আপডেট করতে liveBroadcasts.transition পদ্ধতি কল করুন। id প্যারামিটারের ভ্যালু ১.১ ধাপে পাওয়া ব্রডকাস্ট আইডিতে সেট করুন এবং broadcastStatus প্যারামিটারের ভ্যালু testing-এ সেট করুন।

liveBroadcasts.transition মেথড কল করার পরে, সেই ট্রানজিশন সম্পূর্ণ হতে কয়েক সেকেন্ড বা এমনকি এক মিনিট পর্যন্ত সময় লাগতে পারে। সেই সময়, ব্রডকাস্টের স্ট্যাটাস চেক করার জন্য আপনাকে API পোল করতে হবে। ট্রানজিশন সম্পূর্ণ না হওয়া পর্যন্ত, ব্রডকাস্টের স্ট্যাটাস testStarting হিসেবে দেখানো হবে। ট্রানজিশন সম্পূর্ণ হলে স্ট্যাটাস testing হয়ে যাবে।

ধাপ ৩.৫: আপনার টেস্টিং সম্পূর্ণ করা

আপনার পরীক্ষা ভালোভাবে হয়ে গেলে, আপনি ৪র্থ ধাপে যেতে পারেন। তবে, কিছু ক্ষেত্রে, আপনাকে আরও পরীক্ষা করতে হতে পারে। যেমন, পরীক্ষা করে যদি দেখেন যে ভিডিও স্ট্রিম সঠিকভাবে কনফিগার করা নেই, তাহলে ব্রডকাস্ট শুরু করার আগে আপনাকে সেটি ঠিক করতে হবে।

ভিডিও স্ট্রিম সঠিকভাবে কনফিগার করা না থাকলে, আপনাকে বর্তমান স্ট্রিম আনবাইন্ড (এবং মুছে দিতে) হবে এবং একটি নতুন স্ট্রিম তৈরি করতে হবে। যেমন, কোনও স্ট্রিম ভুল ভিডিও ফর্ম্যাট নির্দিষ্ট করলে সেটি সঠিকভাবে কনফিগার করা নাও হতে পারে।

  1. ভিডিও স্ট্রিম আনবাইন্ড করতে, ১.৩ ধাপ থেকে liveBroadcasts.bind মেথড কল করুন। API অনুরোধে, id প্যারামিটারকে ধাপ ১.১-এ পাওয়া id-এ সেট করুন। অনুরোধে streamId প্যারামিটার যোগ করবেন না।

  2. ভিডিও স্ট্রিম মুছে দিতে, liveStreams.delete মেথড কল করুন। অনুরোধে, id প্যারামিটারকে id-এ সেট করুন যা ১.২ ধাপে পাওয়া গেছে।

  3. নতুন, সঠিকভাবে কনফিগার করা liveStream রিসোর্স তৈরি করতে ধাপ ১.২ আবার করুন। তারপরে, আপনার ব্রডকাস্টের সাথে নতুন স্ট্রিম বাইন্ড করতে ১.৩ নম্বর ধাপ এবং নতুন স্ট্রিম পরীক্ষা করতে ৩.১ থেকে ৩.৩ নম্বর ধাপগুলি আবার করুন।

ধাপ ৩.৬: autoStart ও autoStop প্রপার্টি চালু করুন

পরীক্ষা করার ধাপ সম্পূর্ণ করার পরে, আসল ব্রডকাস্ট শুরু হওয়ার আগে, আপনার কাছে ব্রডকাস্টের contentDetails.enableAutoStart ও contentDetails.enableAutoStop প্রপার্টি true করার বিকল্প থাকে। এইসব প্রপার্টি পরীক্ষা করার আগে true হিসেবে সেট করা যায় না, কারণ পরীক্ষা করলে আসলে ব্রডকাস্ট শুরু হয়ে যাবে।

ধাপ ৪: ব্রডকাস্ট

এই পর্যায়ে, আপনার ব্রডকাস্ট ভিডিও দর্শকরা দেখতে পাবেন।

ধাপ ৪.১: আপনার ভিডিও শুরু করুন

আপনার ভিডিও স্ট্রিমে ভিডিও ট্রান্সমিট করা শুরু করুন।

ধাপ ৪.২: আপনার ভিডিও স্ট্রিম অ্যাক্টিভ আছে কিনা তা কনফার্ম করুন

আপনার ব্রডকাস্টের সাথে যুক্ত liveStream রিসোর্স ফিরিয়ে আনতে liveStreams.list মেথড কল করুন। কনফার্ম করুন যে status.streamStatus প্রপার্টির ভ্যালু হল active, যা ইঙ্গিত করে যে YouTube সার্ভার আপনার এনকোডার থেকে সঠিকভাবে ডেটা পাচ্ছে।

ধাপ ৪.৩: আপনার ব্রডকাস্টের স্ট্যাটাস লাইভে পরিবর্তন করুন

গুরুত্বপূর্ণ: এই ধাপটি আপনার ভিডিওকে দর্শকদের কাছে দৃশ্যমান করে তোলে।

ব্রডকাস্টের স্ট্যাটাস আপডেট করতে, liveBroadcasts.transition মেথড কল করুন। id প্যারামিটারের ভ্যালু ১.১ ধাপে পাওয়া ব্রডকাস্ট আইডিতে সেট করুন এবং broadcastStatus প্যারামিটারের ভ্যালু live-এ সেট করুন।

আপনি liveBroadcast রিসোর্সের contentDetails.enableAutoStart প্রপার্টি true হিসেবে সেট করলে, আপনাকে liveBroadcasts.transition মেথড কল করতে হবে না।

এই API কল করার পরে -- অথবা, আপনি contentDetails.enableAutoStart প্রপার্টি true হিসেবে সেট করে থাকলে, স্ট্রিমিং শুরু করার পরে -- সাধারণত এই ট্রানজিশন সম্পূর্ণ হওয়ার জন্য আপনাকে ৫ থেকে ১০ সেকেন্ড অপেক্ষা করতে হবে। ট্রানজিশন হতে এক মিনিট পর্যন্ত সময় লাগতে পারে। সেই সময়, ব্রডকাস্টের স্ট্যাটাস চেক করার জন্য আপনাকে API পোল করতে হবে। ট্রানজিশন সম্পূর্ণ না হওয়া পর্যন্ত, ব্রডকাস্টের স্ট্যাটাস liveStarting হিসেবে দেখানো হবে। ট্রানজিশন সম্পূর্ণ হলে স্ট্যাটাস live হয়ে যাবে এবং দর্শকরা আপনার মনিটর স্ট্রিমের সেই পয়েন্ট থেকে আপনার ব্রডকাস্ট দেখতে পাবেন।

এই কমান্ডের নিম্নলিখিত প্রভাবগুলি লক্ষ্য করুন:

  • আপনার ব্রডকাস্টের জন্য মনিটর স্ট্রিম চালু করে থাকলে – ধাপ ৩.১ দেখুন – আপনি এম্বেড করা প্লেয়ারে মনিটর স্ট্রিম দেখতে পাবেন।
  • আপনি যদি ব্রডকাস্টের contentDetails.streamDetails.broadcastStreamDelayMs প্রপার্টির জন্য কোনও ভ্যালু সেট করে থাকেন, তাহলে ব্রডকাস্ট স্ট্রিম, যা অন্যান্য দর্শকরা দেখতে পান, সেই পরিমাণ সময় দেরি করে দেখানো হবে।

ধাপ ৪.৪: আপনার ব্রডকাস্টে বিজ্ঞাপন বিরতি যোগ করুন

কিউপয়েন্ট যোগ করতে liveBroadcasts.cuepoint মেথড কল করুন। কিউপয়েন্ট বিজ্ঞাপন বিরতি ট্রিগার করতে পারে। cuepoint অনুরোধের বডিতে প্রদান করা রিসোর্সে, আপনি দেখাতে চান এমন বিরতির কাঙ্খিত দৈর্ঘ্য (সেকেন্ডে) durationSecs প্রপার্টিতে সেট করুন। (ডিফল্ট ভ্যালু হল 30।)

এই সময়, বিজ্ঞাপন কিউপয়েন্ট যোগ করার সময় যেসব দর্শক সম্প্রচার দেখছিলেন, YouTube তাদের জন্য ভিডিও প্লেয়ারে বিজ্ঞাপন চালানোর চেষ্টা করে। কোনও বিজ্ঞাপন দেখানো হবে কিনা তা বিভিন্ন বিষয়ের উপর নির্ভর করে, যেমন বিজ্ঞাপনের উপলভ্যতা এবং দর্শকের বিজ্ঞাপন দেখার ইতিহাস। যেসব দর্শক বিজ্ঞাপন বিরতি দেখেন, বিজ্ঞাপন বিরতি শেষ হলে তারা আপনার ব্রডকাস্টে ফিরে আসেন, অন্যদিকে যেসব দর্শককে বিজ্ঞাপন দেখানো হয় না তারা বিরতির সময়ও ব্রডকাস্ট স্ট্রিম দেখা চালিয়ে যান।

শুরু করা গাইড থেকে লাইভ ব্রডকাস্টের বিজ্ঞাপন বিরতির সময় দেখার অভিজ্ঞতা সম্পর্কে আরও তথ্য পাবেন।

ধাপ ৫: আপনার ব্রডকাস্ট শেষ করুন

ধাপ ৫.১: স্ট্রিমিং বন্ধ করা

এর মাধ্যমে YouTube লাইভ ব্রডকাস্ট সিস্টেমের পরীক্ষা শেষ হল।

ধাপ ৫.২: আপনার ব্রডকাস্টের স্ট্যাটাস 'সম্পূর্ণ হয়েছে' হিসেবে পরিবর্তন করা

সম্প্রচার বন্ধ করার জন্য রেডি হয়ে গেলে, API-এর liveBroadcasts.transition মেথড কল করে সম্প্রচারের স্ট্যাটাস আপডেট করুন। id প্যারামিটারের ভ্যালু ১.১ ধাপে পাওয়া ব্রডকাস্ট আইডিতে সেট করুন এবং broadcastStatus প্যারামিটারের ভ্যালু complete-এ সেট করুন।

আপনি যদি ব্রডকাস্টের contentDetails.recordFromStart এবং contentDetails.enableDvr প্রপার্টি true-এ সেট করে থাকেন, তাহলে লাইভ ইভেন্ট শেষ হওয়ার সাথে সাথেই আপনার দর্শকরা লাইভ ইভেন্টের প্লেব্যাক দেখতে পাবেন।

ধাপ ৬: রেফারেন্স তৈরি করা

লাইভ রেকর্ডিং সম্পূর্ণ হয়ে গেলে, আপনি রেকর্ড করা ভিডিও থেকে রেফারেন্স তৈরি করতে পারবেন। এই অ্যাকশন YouTube-কে ব্রডকাস্টের সাথে মিলে যায় এমন ব্যবহারকারীর আপলোড করা ভিডিও খুঁজতে এবং ধাপ ২.৩-এ আপনার সেট করা সমরূপতার নীতি অনুযায়ী সেগুলি ম্যানেজ করতে নির্দেশ দেয়।

গুরুত্বপূর্ণ: রেফারেন্স তৈরি করতে, আপনাকে অবশ্যই ব্রডকাস্টের contentDetails.recordFromStart প্রপার্টি true-এ সেট করতে হবে।

ধাপ ৬.১: ভিডিওর স্ট্যাটাসের জন্য ডেটা API পোল করুন

কোনও ভিডিও থেকে রেফারেন্স তৈরি করার আগে, YouTube-কে অবশ্যই ব্রডকাস্ট বা আপলোড করা ভিডিও প্রসেস করা শেষ করতে হবে। ভিডিও প্রসেস করা সম্পূর্ণ হয়েছে কিনা তা নির্ধারণ করতে, YouTube Data API-এর videos.list পদ্ধতি পোল করুন, part প্যারামিটার status-এ এবং id প্যারামিটার ব্রডকাস্ট আইডিতে সেট করুন যা আপনি ধাপ ১.১-এ স্টোর করেছেন।

আপনার পোলিং অনুরোধের API রেসপন্সে একটি video রিসোর্স থাকবে। সেই রিসোর্সের status.uploadStatus প্রপার্টির ভ্যালু processed হলে, ৬.২ ধাপে যান।

ধাপ ৬.২: প্রসেস করা ভিডিও থেকে রেফারেন্স তৈরি করা

আপনার রেফারেন্স তৈরি করতে, Content ID API-এর references.insertমেথড কল করুন এবং claimId প্যারামিটারকে সেই দাবি আইডিতে সেট করুন যা আপনি ধাপ ২.৪-এ স্টোর করেছেন।

লাইভ Content ID ডেলিভারি

কিছু YouTube পার্টনার তাদের ব্রডকাস্ট testing স্ট্যাটাসে পরিবর্তিত হওয়ার আগে রেফারেন্স তৈরি করতে পারেন, তবে এই ফিচার সব পার্টনারের জন্য উপলভ্য নয়। সেই ফ্লোতে, YouTube আপনার লাইভ ইভেন্টের ব্রডকাস্ট স্ট্রিম থেকে রেফারেন্স তৈরি করে এবং ব্রডকাস্ট চলাকালীন তা ক্রমাগত আপডেট করে। এছাড়াও, সম্প্রচার চলাকালীন YouTube ব্যবহারকারীর আপলোড করা ভিডিওর সাথে মিলছে কিনা তা দেখা হয়। মনে রাখবেন, ব্রডকাস্ট শুরু হওয়ার আগে রেফারেন্স তৈরি করলে, ব্রডকাস্টের জন্য রেকর্ডিং অটোমেটিক চালু হয়ে যায় এবং রেফারেন্স তৈরি হওয়ার পরে রেকর্ডিং বন্ধ করা যায় না।

লাইভ Content ID ডেলিভারির জন্য আপনার ব্রডকাস্ট চালু করতে, ২.৪ ধাপে আপনার ভিডিও দাবি করার পরে ৬.২ ধাপে বর্ণিত অ্যাকশনগুলি চেষ্টা করুন। লাইভ সম্প্রচার শুরু হওয়ার আগে আপনার পার্টনার অ্যাকাউন্ট যদি সেই সম্প্রচারের জন্য রেফারেন্স তৈরি করার অনুমোদন না পায়, তাহলে API fingerprintingNotAllowed সমস্যা দেখাবে। সেই ক্ষেত্রে, রেফারেন্স তৈরি করার আগে আপনাকে ব্রডকাস্ট সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করতে হবে। উপরে ৬.১ ও ৬.২ ধাপে এই বিষয়ে বর্ণনা করা হয়েছে।