LiveBroadcasts

API এখন আপনার লাইভ সম্প্রচারগুলিকে "বাচ্চাদের জন্য তৈরি" হিসাবে চিহ্নিত করার ক্ষমতা সমর্থন করে এবং liveBroadcast সংস্থানটিতে এখন এমন একটি সম্পত্তি রয়েছে যা সেই লাইভ সম্প্রচারের "বাচ্চাদের জন্য তৈরি" স্থিতি সনাক্ত করে৷ YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলী এবং বিকাশকারীর নীতিগুলিও 10 জানুয়ারী 2020-এ আপডেট করা হয়েছিল৷ আরও তথ্যের জন্য, অনুগ্রহ করে YouTube লাইভ স্ট্রিমিং API পরিষেবা এবং YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলীর সংশোধনের ইতিহাসগুলি দেখুন৷

একটি liveBroadcast সংস্থান এমন একটি ইভেন্টকে প্রতিনিধিত্ব করে যা YouTube-এ লাইভ ভিডিওর মাধ্যমে স্ট্রিম করা হবে।

পদ্ধতি

API liveBroadcasts সংস্থানগুলির জন্য নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:

list
API অনুরোধের পরামিতিগুলির সাথে মেলে এমন YouTube সম্প্রচারের একটি তালিকা প্রদান করে৷ এখনই চেষ্টা করে দেখুন ।
insert
একটি সম্প্রচার তৈরি করে। এখনই চেষ্টা করে দেখুন ।
update
একটি সম্প্রচার আপডেট করে। উদাহরণস্বরূপ, আপনি liveBroadcast রিসোর্সের contentDetails অবজেক্টে সংজ্ঞায়িত সম্প্রচার সেটিংস পরিবর্তন করতে পারেন। এখনই চেষ্টা করে দেখুন ।
delete
একটি সম্প্রচার মুছে দেয়। এখনই চেষ্টা করে দেখুন ।
bind
একটি YouTube সম্প্রচারকে একটি স্ট্রীমে আবদ্ধ করে বা একটি সম্প্রচার এবং একটি স্ট্রীমের মধ্যে বিদ্যমান বাঁধাই সরিয়ে দেয়৷ একটি সম্প্রচার শুধুমাত্র একটি ভিডিও স্ট্রীমের সাথে আবদ্ধ হতে পারে, যদিও একটি ভিডিও স্ট্রীম একাধিক সম্প্রচারের সাথে আবদ্ধ হতে পারে৷ এখনই চেষ্টা করে দেখুন ।
transition
একটি YouTube লাইভ সম্প্রচারের স্থিতি পরিবর্তন করে এবং নতুন স্থিতির সাথে সম্পর্কিত যেকোনো প্রক্রিয়া শুরু করে। উদাহরণস্বরূপ, আপনি যখন একটি সম্প্রচারের স্থিতি testing স্থানান্তর করেন, তখন YouTube সেই সম্প্রচারের মনিটর স্ট্রীমে ভিডিও প্রেরণ করতে শুরু করে৷ এই পদ্ধতিতে কল করার আগে, আপনাকে নিশ্চিত করতে হবে যে আপনার সম্প্রচারে আবদ্ধ স্ট্রীমের জন্য status.streamStatus সম্পত্তির মান active । এখনই চেষ্টা করে দেখুন ।
cuepoint
একটি লাইভ সম্প্রচারে একটি কিউপয়েন্ট সন্নিবেশ করান৷ কিউপয়েন্ট একটি বিজ্ঞাপন বিরতি ট্রিগার হতে পারে.

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত JSON কাঠামো একটি liveBroadcasts সম্পদের বিন্যাস দেখায়:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
      "cuepointSchedule": {
        "enabled": boolean,
        "pauseAdsUntil": datetime,
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer,
      }
    }
  }
}

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
kind string
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#liveBroadcast .
etag etag
এই সম্পদের Etag.
id string
সম্প্রচারটিকে স্বতন্ত্রভাবে শনাক্ত করতে YouTube যে আইডি বরাদ্দ করে৷
snippet object
snippet অবজেক্টে এর শিরোনাম, বর্ণনা, শুরুর সময় এবং শেষের সময় সহ ইভেন্ট সম্পর্কে প্রাথমিক বিবরণ রয়েছে।
snippet. publishedAt datetime
YouTube-এর লাইভ সম্প্রচারের সময়সূচীতে সম্প্রচারের তারিখ এবং সময় যোগ করা হয়েছে। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷
snippet. channelId string
সম্প্রচার প্রকাশ করা চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে YouTube যে ID ব্যবহার করে।
snippet. title string
সম্প্রচারের শিরোনাম। মনে রাখবেন যে সম্প্রচারটি ঠিক একটি YouTube ভিডিওর প্রতিনিধিত্ব করে৷ আপনি সম্প্রচার সংস্থান পরিবর্তন করে বা সংশ্লিষ্ট ভিডিও সম্পদের title ক্ষেত্র সেট করে এই ক্ষেত্রটি সেট করতে পারেন।
snippet. description string
সম্প্রচারের বর্ণনা। title মতো, আপনি সম্প্রচার সংস্থান পরিবর্তন করে বা সংশ্লিষ্ট ভিডিও সংস্থানের description ক্ষেত্র সেট করে এই ক্ষেত্রটি সেট করতে পারেন৷
snippet. thumbnails object
সম্প্রচারের সাথে যুক্ত থাম্বনেইল চিত্রগুলির একটি মানচিত্র৷ এই অবজেক্টের প্রতিটি নেস্টেড অবজেক্টের জন্য, কী হল থাম্বনেইল ইমেজের নাম এবং মান হল একটি অবজেক্ট যাতে থাম্বনেইল সম্পর্কে অন্যান্য তথ্য থাকে।
snippet.thumbnails. (key) object
বৈধ কী মান হল:
  • default - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 120px চওড়া এবং 90px লম্বা। একটি চ্যানেলের জন্য ডিফল্ট থাম্বনেইল 88px চওড়া এবং 88px লম্বা।
  • medium - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে বোঝায়), এই ছবিটি 320px চওড়া এবং 180px লম্বা। একটি চ্যানেলের জন্য, এই ছবিটি 240px চওড়া এবং 240px লম্বা৷
  • high - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে নির্দেশ করে), এই ছবিটি 480px চওড়া এবং 360px লম্বা। একটি চ্যানেলের জন্য, এই চিত্রটি 800px চওড়া এবং 800px লম্বা৷
snippet.thumbnails.(key). url string
ছবির URL.
snippet.thumbnails.(key). width unsigned integer
ছবিটির প্রস্থ।
snippet.thumbnails.(key). height unsigned integer
ছবিটির উচ্চতা।
snippet. scheduledStartTime datetime
যে তারিখ এবং সময় সম্প্রচার শুরু হবে। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷ ক্রিয়েটর স্টুডিও একটি শুরুর সময় নির্ধারণ না করে একটি সম্প্রচার তৈরি করার ক্ষমতা সমর্থন করে৷ এই ক্ষেত্রে, চ্যানেল মালিক যখনই স্ট্রিমিং শুরু করেন তখনই সম্প্রচার শুরু হয়। এই সম্প্রচারগুলির জন্য, datetime মানটি UNIX সময় শূন্যের সাথে মিলে যায় এবং এই মানটি API এর মাধ্যমে বা ক্রিয়েটর স্টুডিওতে পরিবর্তন করা যায় না।
snippet. scheduledEndTime datetime
যে তারিখ এবং সময় সম্প্রচার শেষ হওয়ার কথা। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷ যদি একটি liveBroadcast সংস্থান এই সম্পত্তির জন্য একটি মান নির্দিষ্ট না করে, তাহলে সম্প্রচারটি অনির্দিষ্টকালের জন্য চালিয়ে যাওয়ার জন্য নির্ধারিত হয়৷ একইভাবে, যদি আপনি এই সম্পত্তির জন্য একটি মান নির্দিষ্ট না করেন, তাহলে YouTube সম্প্রচারটিকে এমনভাবে বিবেচনা করে যেন এটি অনির্দিষ্টকালের জন্য চলবে।
snippet. actualStartTime datetime
যে তারিখ এবং সময় সম্প্রচারটি আসলে শুরু হয়েছিল৷ সম্প্রচারের অবস্থা live হলেই এই তথ্য পাওয়া যায়। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷
snippet. actualEndTime datetime
যে তারিখ এবং সময় সম্প্রচারটি আসলে শেষ হয়েছিল৷ সম্প্রচারের অবস্থা complete হলেই এই তথ্য পাওয়া যায়। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷
snippet. isDefaultBroadcast boolean
এই প্রপার্টিটি 1 সেপ্টেম্বর, 2020 তারিখে বা তার পরে বাতিল করা হবে। সেই সময়ে, YouTube একটি ডিফল্ট স্ট্রিম তৈরি করা বন্ধ করে দেবে এবং একটি চ্যানেল লাইভ স্ট্রিমিংয়ের জন্য সক্ষম হলে ডিফল্ট সম্প্রচার বন্ধ করবে। আরও বিশদ বিবরণের জন্য অনুগ্রহ করে অবমূল্যায়ন ঘোষণাটি দেখুন।
এই বৈশিষ্ট্যটি নির্দেশ করে যে এই সম্প্রচারটি ডিফল্ট সম্প্রচার কিনা।

ডিফল্ট সম্প্রচার কিভাবে কাজ করে

যখন একটি YouTube চ্যানেল লাইভ স্ট্রিমিংয়ের জন্য সক্ষম করা হয়, তখন YouTube একটি ডিফল্ট স্ট্রিম এবং চ্যানেলের জন্য একটি ডিফল্ট সম্প্রচার তৈরি করে৷ চ্যানেলের মালিক কীভাবে YouTube-এ লাইভ ভিডিও পাঠান তা স্ট্রিমটি সংজ্ঞায়িত করে এবং দর্শকরা কীভাবে ডিফল্ট স্ট্রিম দেখতে পারে তা সম্প্রচার করে। এই সংস্থানগুলি সনাক্ত করতে একটি চ্যানেলের মালিক liveStreams.list এবং liveBroadcasts.list পদ্ধতি ব্যবহার করতে পারেন৷

যখন একটি চ্যানেল তার ডিফল্ট স্ট্রীমে ভিডিও স্ট্রিমিং শুরু করে, তখন ভিডিওটি চ্যানেলের ডিফল্ট সম্প্রচারে দৃশ্যমান হয়৷ স্ট্রীম শেষ হলে, YouTube সম্পূর্ণ সম্প্রচারকে একটি YouTube ভিডিওতে রূপান্তর করে এবং ভিডিওটিকে একটি YouTube ভিডিও আইডি বরাদ্দ করে।

রূপান্তর সম্পূর্ণ হওয়ার পরে, ভিডিওটি চ্যানেলের আপলোড করা ভিডিওগুলির তালিকায় অন্তর্ভুক্ত করা হয়। সম্প্রচার শেষ হওয়ার পরপরই ভিডিওটি পাওয়া যায় না এবং বিলম্বের দৈর্ঘ্য সম্প্রচারের প্রকৃত দৈর্ঘ্যের সাথে সম্পর্কিত।
snippet. liveChatId string
সম্প্রচারের YouTube লাইভ চ্যাটের আইডি। এই আইডি দিয়ে, আপনি চ্যাট বার্তাগুলি পুনরুদ্ধার করতে, সন্নিবেশ করতে বা মুছতে liveChatMessage সংস্থানের পদ্ধতিগুলি ব্যবহার করতে পারেন৷ এছাড়াও আপনি চ্যাট মডারেটর যোগ করতে বা সরাতে পারেন, ব্যবহারকারীদের লাইভ চ্যাটে অংশগ্রহণ থেকে নিষিদ্ধ করতে পারেন, বা বিদ্যমান নিষেধাজ্ঞাগুলি সরাতে পারেন৷
status object
status অবজেক্টে ইভেন্টের স্ট্যাটাস সম্পর্কে তথ্য থাকে।
status. lifeCycleStatus string
সম্প্রচারের অবস্থা। API-এর liveBroadcasts.transition পদ্ধতি ব্যবহার করে স্থিতি আপডেট করা যেতে পারে।

এই সম্পত্তির জন্য বৈধ মান হল:
  • complete - সম্প্রচার শেষ হয়েছে।
  • created - সম্প্রচারের অসম্পূর্ণ সেটিংস রয়েছে, তাই এটি একটি live বা testing স্থিতিতে স্থানান্তরিত করার জন্য প্রস্তুত নয়, তবে এটি তৈরি করা হয়েছে এবং অন্যথায় বৈধ।
  • live - সম্প্রচার সক্রিয়।
  • liveStarting - সম্প্রচারটি live স্ট্যাটাসে রূপান্তরের প্রক্রিয়াধীন রয়েছে৷
  • ready - সম্প্রচার সেটিংস সম্পূর্ণ এবং সম্প্রচার একটি live বা testing স্থিতিতে রূপান্তর করতে পারে৷
  • revoked - এই সম্প্রচারটি একটি অ্যাডমিন অ্যাকশন দ্বারা সরানো হয়েছে৷
  • testStarting - সম্প্রচারটি testing স্থিতিতে রূপান্তরের প্রক্রিয়ায় রয়েছে।
  • testing - সম্প্রচারটি শুধুমাত্র অংশীদারের কাছে দৃশ্যমান।
status. privacyStatus string
সম্প্রচারের গোপনীয়তার অবস্থা। মনে রাখবেন যে সম্প্রচারটি ঠিক একটি YouTube ভিডিও উপস্থাপন করে, তাই গোপনীয়তা সেটিংস ভিডিওগুলির জন্য সমর্থিতগুলির সাথে অভিন্ন৷ এছাড়াও, আপনি সম্প্রচার সংস্থান সংশোধন করে বা সংশ্লিষ্ট ভিডিও সংস্থানের privacyStatus ক্ষেত্র সেট করে এই ক্ষেত্রটি সেট করতে পারেন।

এই সম্পত্তির জন্য বৈধ মান হল:
  • private
  • public
  • unlisted
status. recordingStatus string
সম্প্রচারের রেকর্ডিং অবস্থা।

এই সম্পত্তির জন্য বৈধ মান হল:
  • notRecording
  • recorded
  • recording
status. madeForKids boolean
এই মানটি নির্দেশ করে যে সম্প্রচারটি শিশু-নির্দেশিত হিসাবে মনোনীত হয়েছে কিনা। এই সম্পত্তি মান শুধুমাত্র পঠনযোগ্য.
status. selfDeclaredMadeForKids boolean
একটি liveBroadcasts.insert অনুরোধে, এই সম্পত্তি চ্যানেল মালিককে সম্প্রচারটিকে শিশু-নির্দেশিত হিসাবে মনোনীত করার অনুমতি দেয়। একটি liveBroadcasts.list অনুরোধে, চ্যানেলের মালিক API অনুরোধ অনুমোদন করলেই সম্পত্তির মান ফেরত দেওয়া হয়।
contentDetails object
contentDetails অবজেক্টে ইভেন্টের ভিডিও বিষয়বস্তু সম্পর্কে তথ্য থাকে, যেমন বিষয়বস্তু একটি এম্বেড করা ভিডিও প্লেয়ারে দেখানো যায় কিনা বা এটি সংরক্ষণাগারভুক্ত করা হবে এবং তাই ইভেন্টটি শেষ হওয়ার পরে দেখার জন্য উপলব্ধ।
contentDetails. boundStreamId string
এই মানটি সম্প্রচারের সাথে আবদ্ধ live stream অনন্যভাবে সনাক্ত করে।
contentDetails. boundStreamLastUpdateTimeMs datetime
boundStreamId দ্বারা উল্লেখিত লাইভ স্ট্রীমের তারিখ এবং সময় সর্বশেষ আপডেট করা হয়েছিল৷
contentDetails. monitorStream object
monitorStream অবজেক্টে মনিটর স্ট্রীম সম্পর্কে তথ্য রয়েছে, যা সম্প্রচারকারী সম্প্রচার স্ট্রীম সর্বজনীনভাবে দেখানোর আগে ইভেন্ট সামগ্রী পর্যালোচনা করতে ব্যবহার করতে পারে।
contentDetails.monitorStream. enableMonitorStream boolean
এই মান নির্ধারণ করে যে মনিটর স্ট্রীম সম্প্রচারের জন্য সক্ষম কিনা। যদি মনিটর স্ট্রীম সক্ষম করা থাকে, তাহলে YouTube শুধুমাত্র সম্প্রচারকারীর ব্যবহারের উদ্দেশ্যে একটি বিশেষ স্ট্রীমে ইভেন্ট বিষয়বস্তু সম্প্রচার করবে। সম্প্রচারকারী ইভেন্টের বিষয়বস্তু পর্যালোচনা করতে এবং কিউপয়েন্ট সন্নিবেশ করার জন্য সর্বোত্তম সময় সনাক্ত করতে স্ট্রিমটি ব্যবহার করতে পারে।

আপনি যদি আপনার সম্প্রচারের জন্য একটি testing পর্যায় করতে চান বা আপনি যদি আপনার ইভেন্টের জন্য একটি সম্প্রচার বিলম্ব করতে চান তবে আপনাকে এই মানটিকে true হিসাবে সেট করতে হবে৷ উপরন্তু, যদি এই সম্পত্তির মান true হয়, তাহলে live স্টেটে স্থানান্তর করার আগে আপনাকে অবশ্যই আপনার সম্প্রচারকে testing স্টেটে স্থানান্তর করতে হবে। (যদি সম্পত্তির মান false হয়, আপনার সম্প্রচারের একটি testing পর্যায় থাকতে পারে না, তাই আপনি সরাসরি সম্প্রচারকে live অবস্থায় স্থানান্তর করতে পারেন।)

যখন আপনি update a broadcast , আপনার API অনুরোধে part প্যারামিটার মানের মধ্যে contentDetails অংশটি অন্তর্ভুক্ত থাকলে এই বৈশিষ্ট্যটি অবশ্যই সেট করা উচিত। যাইহোক, যখন আপনি insert a broadcast , সম্পত্তিটি ঐচ্ছিক এবং true একটি ডিফল্ট মান থাকে।

গুরুত্বপূর্ণ: একবার সম্প্রচার testing বা live অবস্থায় থাকলে এই সম্পত্তি আপডেট করা যাবে না।
contentDetails.monitorStream. broadcastStreamDelayMs unsigned integer
আপনি যদি enableMonitorStream প্রপার্টি true তে সেট করে থাকেন, তাহলে এই প্রপার্টি লাইভ সম্প্রচার বিলম্বের দৈর্ঘ্য নির্ধারণ করে।

যখন আপনি update a broadcast , আপনার API অনুরোধে part প্যারামিটার মানের মধ্যে contentDetails অংশটি অন্তর্ভুক্ত থাকলে এই বৈশিষ্ট্যটি অবশ্যই সেট করা উচিত। যাইহোক, যখন আপনি insert a broadcast , সম্পত্তিটি ঐচ্ছিক এবং একটি ডিফল্ট মান 0 থাকে। এই মানটি নির্দেশ করে যে সম্প্রচারের সম্প্রচার বিলম্ব নেই। দ্রষ্টব্য: একবার সম্প্রচার testing বা live অবস্থায় থাকলে এই সম্পত্তি আপডেট করা যাবে না।
contentDetails.monitorStream. embedHtml string
এইচটিএমএল কোড যা একটি প্লেয়ারকে এমবেড করে যা মনিটর স্ট্রিম চালায়।
contentDetails. enableEmbed boolean
এই সেটিং ইঙ্গিত করে যে সম্প্রচার ভিডিও একটি এমবেডেড প্লেয়ারে চালানো যাবে কিনা৷ আপনি যদি ভিডিওটি সংরক্ষণাগার বেছে নেন ( enableArchive বৈশিষ্ট্য ব্যবহার করে), এই সেটিংটি সংরক্ষণাগারভুক্ত ভিডিওতেও প্রযোজ্য হবে৷

যখন আপনি update a broadcast , আপনার API অনুরোধে part প্যারামিটার মানের মধ্যে contentDetails অংশটি অন্তর্ভুক্ত থাকলে এই বৈশিষ্ট্যটি অবশ্যই সেট করা উচিত। যাইহোক, যখন আপনি insert a broadcast , সম্পত্তিটি ঐচ্ছিক এবং true একটি ডিফল্ট মান থাকে।

দ্রষ্টব্য: একবার সম্প্রচার testing বা live অবস্থায় থাকলে এই সম্পত্তি আপডেট করা যাবে না।
contentDetails. enableDvr boolean
এই সেটিং নির্ধারণ করে যে দর্শকরা ভিডিও দেখার সময় DVR নিয়ন্ত্রণ অ্যাক্সেস করতে পারবে কিনা। DVR কন্ট্রোল দর্শককে ভিডিও প্লেব্যাকের অভিজ্ঞতাকে বিরতি, রিওয়াইন্ডিং বা দ্রুত ফরওয়ার্ডিং বিষয়বস্তু নিয়ন্ত্রণ করতে সক্ষম করে। এই সম্পত্তির জন্য ডিফল্ট মান true ।

যখন আপনি update a broadcast , আপনার API অনুরোধে part প্যারামিটার মানের মধ্যে contentDetails অংশটি অন্তর্ভুক্ত থাকলে এই বৈশিষ্ট্যটি অবশ্যই সেট করা উচিত। যাইহোক, যখন আপনি insert a broadcast , সম্পত্তিটি ঐচ্ছিক এবং true একটি ডিফল্ট মান থাকে।

গুরুত্বপূর্ণ: যদি আপনি সম্প্রচার শেষ হওয়ার সাথে সাথে প্লেব্যাক উপলব্ধ করতে চান তবে আপনাকে অবশ্যই মানটিকে true সেট করতে হবে এবং enableArchive সম্পত্তির মানটিকে true হিসাবে সেট করতে হবে৷ উপরন্তু, একবার সম্প্রচার testing বা live অবস্থায় থাকলে এই সম্পত্তি আপডেট করা যাবে না।
contentDetails. recordFromStart boolean
এই সেটিং ইঙ্গিত করে যে ইভেন্টের স্থিতি লাইভে পরিবর্তন হওয়ার পরে YouTube স্বয়ংক্রিয়ভাবে সম্প্রচার রেকর্ড করা শুরু করবে কিনা।

এই সম্পত্তির ডিফল্ট মান true , এবং এটি শুধুমাত্র false সেট করা যেতে পারে যদি সম্প্রচার চ্যানেলটিকে লাইভ সম্প্রচারের জন্য রেকর্ডিং অক্ষম করার অনুমতি দেওয়া হয়।

যদি আপনার চ্যানেলের রেকর্ডিং অক্ষম করার অনুমতি না থাকে, এবং আপনি recordFromStart প্রপার্টি false সেট করে একটি সম্প্রচার সন্নিবেশ করার চেষ্টা করেন, API একটি Forbidden ত্রুটি ফিরিয়ে দেবে। উপরন্তু, যদি আপনার চ্যানেলের সেই অনুমতি না থাকে এবং আপনি recordFromStart প্রপার্টি false সেট করতে একটি সম্প্রচার আপডেট করার চেষ্টা করেন, তাহলে API একটি modificationNotAllowed ত্রুটি ফিরিয়ে দেবে।

যখন আপনি update a broadcast , আপনার API অনুরোধে part প্যারামিটার মানের মধ্যে contentDetails অংশটি অন্তর্ভুক্ত থাকলে এই বৈশিষ্ট্যটি অবশ্যই সেট করা উচিত। যাইহোক, যখন আপনি insert a broadcast , সম্পত্তিটি ঐচ্ছিক এবং true একটি ডিফল্ট মান থাকে।

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

দ্রষ্টব্য: একবার সম্প্রচার testing বা live অবস্থায় থাকলে এই সম্পত্তি আপডেট করা যাবে না।
contentDetails. enableClosedCaptions boolean
এই সম্পত্তিটি 17 ডিসেম্বর, 2015 থেকে অবচয় করা হয়েছে। পরিবর্তে contentDetails.closedCaptionsType প্রপার্টি ব্যবহার করুন।

এই সেটিংটি নির্দেশ করে যে এই সম্প্রচারের জন্য HTTP POST ক্লোজড ক্যাপশনিং সক্ষম করা হয়েছে কিনা৷ API ক্লায়েন্টদের জন্য যারা ইতিমধ্যে এই সম্পত্তি ব্যবহার করছেন:
  • সম্পত্তি মান true সেট করা হল contentDetails.closedCaptionsType প্রপার্টি closedCaptionsHttpPost এ সেট করার সমতুল্য।
  • সম্পত্তির মান false সেট করা হল contentDetails.closedCaptionsType প্রপার্টি closedCaptionsDisabled সেট করার সমতুল্য।
contentDetails. closedCaptionsType string
দ্রষ্টব্য: এই বৈশিষ্ট্যটি contentDetails.enableClosedCaptions সম্পত্তি প্রতিস্থাপন করে ।

এই বৈশিষ্ট্যটি নির্দেশ করে যে আপনার সম্প্রচারের জন্য ক্লোজড ক্যাপশনিং সক্ষম করা হয়েছে এবং যদি তাই হয়, তাহলে আপনি কি ধরনের বন্ধ ক্যাপশন প্রদান করছেন:
  • closedCaptionsDisabled : লাইভ সম্প্রচারের জন্য বন্ধ ক্যাপশন অক্ষম করা হয়েছে।
  • closedCaptionsHttpPost : আপনি HTTP POST-এর মাধ্যমে আপনার লাইভ স্ট্রিমের সাথে যুক্ত একটি ইনজেশন URL- এ ক্যাপশন পাঠাবেন।
  • closedCaptionsEmbedded : EIA-608 এবং/অথবা CEA-708 ফর্ম্যাট ব্যবহার করে ভিডিও স্ট্রীমে ক্যাপশনগুলি এনকোড করা হবে৷
contentDetails. projection string
এই সম্প্রচারের অভিক্ষেপ বিন্যাস. সম্পত্তির ডিফল্ট মান হল rectangular ।

এই সম্পত্তির জন্য বৈধ মান হল:
  • 360
  • rectangular
contentDetails. enableLowLatency boolean
কম লেটেন্সি স্ট্রিমিংয়ের জন্য এই সম্প্রচারটি এনকোড করা উচিত কিনা তা নির্দেশ করে৷ একটি কম লেটেন্সি স্ট্রীম একটি সম্প্রচার দেখছেন এমন ব্যবহারকারীদের কাছে ভিডিও দৃশ্যমান হতে যে সময় লাগে তা কমাতে পারে, যদিও এটি স্ট্রিমের দর্শকদের জন্য রেজোলিউশনকেও প্রভাবিত করতে পারে।
contentDetails. latencyPreference string
এই সম্প্রচারের জন্য কোন লেটেন্সি সেটিং ব্যবহার করতে হবে তা নির্দেশ করে৷ এই বৈশিষ্ট্যটি enableLowLatency এর পরিবর্তে ব্যবহার করা যেতে পারে, যা ultraLow ​​সমর্থন করে না।

একটি কম লেটেন্সি স্ট্রীম একটি সম্প্রচার দেখছেন এমন ব্যবহারকারীদের কাছে ভিডিও দৃশ্যমান হতে যে সময় লাগে তা কমাতে পারে, যদিও এটি প্লেব্যাকের মসৃণতাকেও প্রভাবিত করতে পারে।

একটি অতি-লো-ল্যাটেন্সি স্ট্রীম ভিডিওটি দর্শকদের কাছে দৃশ্যমান হতে যে সময় লাগে তা আরও কমিয়ে দেয়, দর্শকদের সাথে মিথস্ক্রিয়াকে সহজ করে তোলে, কিন্তু অতি-নিম্ন লেটেন্সি ক্লোজড ক্যাপশন, বা 1080p এর বেশি রেজোলিউশন সমর্থন করে না।

এই সম্পত্তির জন্য বৈধ মান হল:
  • normal
  • low
  • ultraLow
contentDetails. enableAutoStart boolean
আপনি যখন আবদ্ধ live stream ভিডিও স্ট্রিমিং শুরু করবেন তখন এই সম্প্রচারটি স্বয়ংক্রিয়ভাবে শুরু হবে কিনা তা নির্দেশ করে৷
contentDetails. enableAutoStop boolean
চ্যানেলের মালিক আবদ্ধ ভিডিও স্ট্রীমে ভিডিও স্ট্রিমিং বন্ধ করার এক মিনিট পরে এই সম্প্রচারটি স্বয়ংক্রিয়ভাবে বন্ধ হওয়া উচিত কিনা তা নির্দেশ করে৷
statistics object
statistics বস্তুতে একটি লাইভ সম্প্রচার সম্পর্কিত পরিসংখ্যান রয়েছে। এই পরিসংখ্যানগুলির মানগুলি সম্প্রচারের সময় পরিবর্তিত হতে পারে এবং সম্প্রচারটি লাইভ থাকাকালীনই পুনরুদ্ধার করা যেতে পারে৷
statistics. totalChatCount unsigned long
সম্প্রচারের সাথে যুক্ত লাইভ চ্যাট বার্তার মোট সংখ্যা। সম্প্রচারটি ব্যবহারকারীর কাছে দৃশ্যমান হলে, লাইভ চ্যাট বৈশিষ্ট্য সক্ষম থাকলে এবং কমপক্ষে একটি বার্তা থাকলে সম্পত্তি এবং এর মান উপস্থিত থাকে। মনে রাখবেন যে সম্প্রচার শেষ হওয়ার পরে এই সম্পত্তি একটি মান নির্দিষ্ট করবে না। সুতরাং, এই সম্পত্তি একটি সম্পূর্ণ লাইভ সম্প্রচারের একটি আর্কাইভ করা ভিডিওর জন্য চ্যাট বার্তার সংখ্যা চিহ্নিত করবে না।
monetizationDetails object
monetizationDetails অবজেক্টে স্ট্রীমের নগদীকরণের বিবরণ সম্পর্কে তথ্য থাকে, যেমন বিজ্ঞাপন অটোমেটর চালু থাকলে বা মিডরোল বিজ্ঞাপন সন্নিবেশ বিলম্বিত হলে।

monetizationDetails. cuepointSchedule object
cuepointSchedule অবজেক্টটি সম্প্রচারের জন্য বিজ্ঞাপন অটোমেশন সেটিংস নির্দিষ্ট করে।
monetizationDetails.cuepointSchedule. enabled boolean
এই মান নির্ধারণ করে যে বিজ্ঞাপনগুলি সম্প্রচারে স্বয়ংক্রিয়ভাবে ঢোকানো হবে কিনা। মানটি true হলে, YouTube স্বয়ংক্রিয়ভাবে সম্প্রচারে মিডরোল বিজ্ঞাপন সন্নিবেশ করবে৷ বিজ্ঞাপন চালানোর সময়সূচী monetizationDetails.cuepointSchedule অবজেক্টের অন্যান্য ক্ষেত্রের মান দ্বারা নির্ধারিত হবে।
monetizationDetails.cuepointSchedule. pauseAdsUntil datetime
এই মানটি নির্দিষ্ট করে যে নির্দিষ্ট তারিখ এবং সময় না হওয়া পর্যন্ত YouTube-এর সম্প্রচারে মিডরোল বিজ্ঞাপন সন্নিবেশ করা উচিত নয়৷ মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷ বিজ্ঞাপনগুলিকে বিরতি দেওয়ার জন্য মানটি অবশ্যই ভবিষ্যতের তারিখের জন্য সেট করতে হবে; সময় অতিবাহিত হয়ে গেলে বিজ্ঞাপনগুলি বন্ধ করার জন্য ক্ষেত্রের মানটি নিকট ভবিষ্যতের তারিখের সময়ও সেট করা যেতে পারে।
monetizationDetails.cuepointSchedule. scheduleStrategy string
এই মান কৌশলটি নির্দিষ্ট করে যা YouTube-এর সময়সূচী নির্ধারণের জন্য অনুসরণ করা উচিত। বৈধ মান হল:
  • CONCURRENT : সমস্ত দর্শকদের জন্য একই সময়ে কিউপয়েন্ট নির্ধারণ করা হয়েছে
  • NON_CONCURRENT : বিভিন্ন দর্শকদের জন্য বিভিন্ন সময়ে কিউপয়েন্ট নির্ধারিত হয়। এই পদ্ধতিটি বিজ্ঞাপনগুলিকে বর্ধিত হারে দেখানোর জন্য সক্ষম করে যা দর্শকদের যোগ্য হলে ক্যুপয়েন্ট পেতে দেয়।
monetizationDetails.cuepointSchedule. repeatIntervalSecs unsigned integer
এই মানটি একটি সম্প্রচারের সময় স্বয়ংক্রিয় বিজ্ঞাপন সন্নিবেশের মধ্যে, সেকেন্ডে, ব্যবধান নির্দিষ্ট করে। উদাহরণস্বরূপ, যদি মান 300 হয়, তাহলে YouTube পাঁচ মিনিটের ব্যবধানে মিডরোল বিজ্ঞাপন কিউপয়েন্ট সন্নিবেশ করতে পারে।

মনে রাখবেন যে মানটি ধারাবাহিক কিউপয়েন্টের শুরুর মধ্যে সময় নির্দিষ্ট করে। অর্থাৎ, একটি কিউপয়েন্টের শেষ থেকে পরবর্তী শুরু পর্যন্ত ব্যবধান পরিমাপ করা হয় না।