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 বৈধ কী মান হল:
|
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 মান ইউনিক্স যুগের সময় শূন্যের সাথে মিলে যায় এবং এই মানটি 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 পদ্ধতি ব্যবহার করে স্থিতি আপডেট করা যেতে পারে।এই সম্পত্তির জন্য বৈধ মান হল:
|
status. privacyStatus | string সম্প্রচারের গোপনীয়তার অবস্থা। মনে রাখবেন যে সম্প্রচারটি ঠিক একটি YouTube ভিডিও উপস্থাপন করে, তাই গোপনীয়তা সেটিংস ভিডিওগুলির জন্য সমর্থিতগুলির সাথে অভিন্ন৷ এছাড়াও, আপনি সম্প্রচার সংস্থান সংশোধন করে বা সংশ্লিষ্ট ভিডিও সংস্থানের privacyStatus ক্ষেত্র সেট করে এই ক্ষেত্রটি সেট করতে পারেন।এই সম্পত্তির জন্য বৈধ মান হল:
|
status. recordingStatus | string সম্প্রচারের রেকর্ডিং অবস্থা। এই সম্পত্তির জন্য বৈধ মান হল:
|
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 ক্লায়েন্টদের জন্য যারা ইতিমধ্যে এই সম্পত্তি ব্যবহার করছেন:
|
contentDetails. closedCaptionsType | string দ্রষ্টব্য: এই বৈশিষ্ট্যটি contentDetails.enableClosedCaptions সম্পত্তি প্রতিস্থাপন করে ।এই বৈশিষ্ট্যটি নির্দেশ করে যে আপনার সম্প্রচারের জন্য ক্লোজড ক্যাপশনিং সক্ষম করা হয়েছে এবং যদি তাই হয়, তাহলে আপনি কি ধরনের বন্ধ ক্যাপশন প্রদান করছেন:
|
contentDetails. projection | string এই সম্প্রচারের অভিক্ষেপ বিন্যাস. সম্পত্তির ডিফল্ট মান হল rectangular ।এই সম্পত্তির জন্য বৈধ মান হল:
|
contentDetails. enableLowLatency | boolean কম লেটেন্সি স্ট্রিমিংয়ের জন্য এই সম্প্রচারটি এনকোড করা উচিত কিনা তা নির্দেশ করে৷ একটি কম লেটেন্সি স্ট্রীম একটি সম্প্রচার দেখছেন এমন ব্যবহারকারীদের কাছে ভিডিও দৃশ্যমান হতে যে সময় লাগে তা কমাতে পারে, যদিও এটি স্ট্রিমের দর্শকদের জন্য রেজোলিউশনকেও প্রভাবিত করতে পারে। |
contentDetails. latencyPreference | string এই সম্প্রচারের জন্য কোন লেটেন্সি সেটিং ব্যবহার করতে হবে তা নির্দেশ করে৷ এই বৈশিষ্ট্যটি enableLowLatency এর পরিবর্তে ব্যবহার করা যেতে পারে, যা ultraLow সমর্থন করে না।একটি কম লেটেন্সি স্ট্রীম একটি সম্প্রচার দেখছেন এমন ব্যবহারকারীদের কাছে ভিডিও দৃশ্যমান হতে যে সময় লাগে তা কমাতে পারে, যদিও এটি প্লেব্যাকের মসৃণতাকেও প্রভাবিত করতে পারে। একটি অতি-লো-ল্যাটেন্সি স্ট্রীম ভিডিওটি দর্শকদের কাছে দৃশ্যমান হতে যে সময় লাগে তা আরও কমিয়ে দেয়, দর্শকদের সাথে মিথস্ক্রিয়াকে সহজ করে তোলে, কিন্তু অতি-নিম্ন লেটেন্সি ক্লোজড ক্যাপশন, বা 1080p এর বেশি রেজোলিউশন সমর্থন করে না। এই সম্পত্তির জন্য বৈধ মান হল:
|
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-এর সময়সূচী নির্ধারণের জন্য অনুসরণ করা উচিত। বৈধ মান হল:
|
monetizationDetails.cuepointSchedule. repeatIntervalSecs | unsigned integer এই মানটি একটি সম্প্রচারের সময় স্বয়ংক্রিয় বিজ্ঞাপন সন্নিবেশের মধ্যে, সেকেন্ডে, ব্যবধান নির্দিষ্ট করে। উদাহরণস্বরূপ, যদি মান 300 হয়, তাহলে YouTube পাঁচ মিনিটের ব্যবধানে মিডরোল বিজ্ঞাপন কিউপয়েন্ট সন্নিবেশ করতে পারে।মনে রাখবেন যে মানটি ধারাবাহিক কিউপয়েন্টের শুরুর মধ্যে সময় নির্দিষ্ট করে। অর্থাৎ, একটি কিউপয়েন্টের শেষ থেকে পরবর্তী শুরু পর্যন্ত ব্যবধান পরিমাপ করা হয় না। |
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 বৈধ কী মান হল:
|
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 মান ইউনিক্স যুগের সময় শূন্যের সাথে মিলে যায় এবং এই মানটি 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 পদ্ধতি ব্যবহার করে স্থিতি আপডেট করা যেতে পারে।এই সম্পত্তির জন্য বৈধ মান হল:
|
status. privacyStatus | string সম্প্রচারের গোপনীয়তার অবস্থা। মনে রাখবেন যে সম্প্রচারটি ঠিক একটি YouTube ভিডিও উপস্থাপন করে, তাই গোপনীয়তা সেটিংস ভিডিওগুলির জন্য সমর্থিতগুলির সাথে অভিন্ন৷ এছাড়াও, আপনি সম্প্রচার সংস্থান সংশোধন করে বা সংশ্লিষ্ট ভিডিও সংস্থানের privacyStatus ক্ষেত্র সেট করে এই ক্ষেত্রটি সেট করতে পারেন।এই সম্পত্তির জন্য বৈধ মান হল:
|
status. recordingStatus | string সম্প্রচারের রেকর্ডিং অবস্থা। এই সম্পত্তির জন্য বৈধ মান হল:
|
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 এই সেটিংটি নির্দেশ করে যে ইউটিউব ইভেন্টের স্থিতি লাইভে পরিবর্তিত হওয়ার পরে স্বয়ংক্রিয়ভাবে সম্প্রচারটি রেকর্ডিং শুরু করবে কিনা। এই সম্পত্তির ডিফল্ট মানটি true এবং এটি কেবল তখনই false হিসাবে সেট করা যেতে পারে যদি সম্প্রচার চ্যানেলটিকে সরাসরি সম্প্রচারের জন্য রেকর্ডিংগুলি অক্ষম করার অনুমতি দেওয়া হয়।যদি আপনার চ্যানেলের রেকর্ডিংগুলি অক্ষম করার অনুমতি না থাকে এবং আপনি recordFromStart সম্পত্তিটি false হিসাবে সেট করে একটি সম্প্রচার সন্নিবেশ করার চেষ্টা করেন, এপিআই একটি Forbidden ত্রুটি ফিরিয়ে দেবে। তদ্ব্যতীত, যদি আপনার চ্যানেলের সেই অনুমতি না থাকে এবং আপনি recordFromStart সম্পত্তিটিকে false হিসাবে সেট করার জন্য কোনও সম্প্রচার আপডেট করার চেষ্টা করেন, এপিআই একটি modificationNotAllowed ত্রুটিটি ফিরিয়ে দেবে।আপনি যখন update a broadcast , এই সম্পত্তিটি অবশ্যই সেট করা উচিত যদি আপনার এপিআই অনুরোধটি part প্যারামিটার মানটিতে contentDetails অংশগুলি অন্তর্ভুক্ত করে। যাইহোক, আপনি যখন insert a broadcast , তখন সম্পত্তিটি al চ্ছিক এবং true একটি ডিফল্ট মান থাকে।গুরুত্বপূর্ণ: আপনি যদি প্লেব্যাকটি সম্প্রচার শেষ হওয়ার সাথে সাথেই প্লেব্যাকটি উপলভ্য হতে চান তবে আপনাকে অবশ্যই enableDvr সম্পত্তির মানটি true সেট করতে হবে। আপনি যদি এই সম্পত্তির মানটি true সেট করেন তবে enableDvr সম্পত্তিটিকে true সেট না করে, সংরক্ষণাগারভুক্ত ভিডিওটি প্লেব্যাকের জন্য উপলব্ধ হওয়ার আগে প্রায় একদিন বিলম্ব হতে পারে।দ্রষ্টব্য: সম্প্রচারটি testing বা live অবস্থায় থাকলে এই সম্পত্তিটি আপডেট করা যায় না। |
contentDetails. enableClosedCaptions | boolean এই সম্পত্তিটি 17 ডিসেম্বর, 2015 পর্যন্ত অবমূল্যায়ন করা হয়েছে। contentDetails.closedCaptionsType ব্যবহার করুন osedএই সেটিংটি ইঙ্গিত দেয় যে এইচটিটিপি পোস্ট বন্ধ ক্যাপশনিং এই সম্প্রচারের জন্য সক্ষম হয়েছে কিনা। এপিআই ক্লায়েন্টদের জন্য যা ইতিমধ্যে এই সম্পত্তিটি ব্যবহার করছে:
|
contentDetails. closedCaptionsType | string দ্রষ্টব্য: এই সম্পত্তিটি contentDetails.enableClosedCaptions প্রতিস্থাপন করে enএই সম্পত্তিটি নির্দেশ করে যে আপনার সম্প্রচারের জন্য বদ্ধ ক্যাপশনিং সক্ষম হয়েছে কিনা এবং যদি তাই হয় তবে আপনি কী ধরণের বদ্ধ ক্যাপশন সরবরাহ করছেন:
|
contentDetails. projection | string এই সম্প্রচারের প্রজেকশন ফর্ম্যাট। সম্পত্তির ডিফল্ট মানটি rectangular ।এই সম্পত্তির জন্য বৈধ মানগুলি হ'ল:
|
contentDetails. enableLowLatency | boolean এই সম্প্রচারটি কম-লেটেন্সি স্ট্রিমিংয়ের জন্য এনকোড করা উচিত কিনা তা নির্দেশ করে। একটি স্বল্প-ল্যাটেন্সি স্ট্রিম ভিডিওর জন্য ভিডিওর জন্য দৃশ্যমান হতে সময় লাগতে পারে এমন পরিমাণ হ্রাস করতে পারে, যদিও এটি প্রবাহের দর্শকদের জন্য রেজোলিউশনেও প্রভাব ফেলতে পারে। |
contentDetails. latencyPreference | string এই সম্প্রচারের জন্য কোন বিলম্বিত সেটিংস ব্যবহার করতে হবে তা নির্দেশ করে। এই সম্পত্তিটি enableLowLatency পরিবর্তে ব্যবহার করা যেতে পারে, যা ultraLow সমর্থন করে না।একটি স্বল্প-লেটেন্সি স্ট্রিম ভিডিওর জন্য ভিডিওর জন্য দৃশ্যমান হতে সময় লাগে এমন পরিমাণ হ্রাস করতে পারে, যদিও এটি প্লেব্যাকের মসৃণতাও প্রভাবিত করতে পারে। একটি অতি-স্বল্প-লেটেন্সি স্ট্রিমটি ভিডিওর জন্য দর্শকদের কাছে দৃশ্যমান হতে সময় নেয়, দর্শকদের সাথে মিথস্ক্রিয়া আরও সহজ করে তোলে, তবে অতি-নিম্ন বিলম্বতা বন্ধ ক্যাপশনগুলি সমর্থন করে না, বা 1080p এর চেয়ে বেশি রেজোলিউশনগুলিকে সমর্থন করে না। এই সম্পত্তির জন্য বৈধ মানগুলি হ'ল:
|
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 এই মানটি নির্ধারণ করে যে বিজ্ঞাপনগুলি সম্প্রচারে স্বয়ংক্রিয়ভাবে serted োকানো হয় কিনা। যদি মানটি true হয় তবে ইউটিউব স্বয়ংক্রিয়ভাবে সম্প্রচারে মিডরোল বিজ্ঞাপনগুলি সন্নিবেশ করবে। চলমান বিজ্ঞাপনগুলির সময়সূচীটি monetizationDetails.cuepointSchedule অবজেক্টে অন্যান্য ক্ষেত্রগুলির মান দ্বারা নির্ধারিত হবে। |
monetizationDetails.cuepointSchedule. pauseAdsUntil | datetime এই মানটি নির্দিষ্ট করে যে ইউটিউব নির্দিষ্ট তারিখ এবং সময় না হওয়া পর্যন্ত সম্প্রচারে মিডরোল বিজ্ঞাপনগুলি সন্নিবেশ করা উচিত নয়। মানটি আইএসও 8601 ( yyyy-mm-ddthh: মিমি: এসএসজেড ) ফর্ম্যাটে নির্দিষ্ট করা আছে। বিজ্ঞাপনগুলি বিরতি দেওয়ার জন্য মানটি অবশ্যই ভবিষ্যতের তারিখের সময় সেট করতে হবে; সময়টি পাস হওয়ার সময় বিজ্ঞাপনগুলি ছাড়ানোর জন্য ক্ষেত্রের মানটি অদূর ভবিষ্যতের তারিখের সময়ও সেট করা যেতে পারে। |
monetizationDetails.cuepointSchedule. scheduleStrategy | string এই মানটি ইউটিউবের সময়সূচী কিউপয়েন্টগুলির জন্য অনুসরণ করা উচিত এমন কৌশলটি নির্দিষ্ট করে। বৈধ মান হল:
|
monetizationDetails.cuepointSchedule. repeatIntervalSecs | unsigned integer এই মানটি সম্প্রচারের সময় স্বয়ংক্রিয় বিজ্ঞাপন সন্নিবেশের মধ্যে সেকেন্ডে অন্তর অন্তর নির্দিষ্ট করে। উদাহরণস্বরূপ, যদি মানটি 300 হয় তবে ইউটিউব পাঁচ মিনিটের ব্যবধানে মিডরোল বিজ্ঞাপন কিউপয়েন্টগুলি সন্নিবেশ করতে পারে।নোট করুন যে মানটি ক্রমাগত কিউপয়েন্টগুলির শুরুতে সময় নির্দিষ্ট করে। অর্থাৎ, অন্তরটি একটি কিউপয়েন্টের শেষ থেকে পরবর্তী শুরুতে পরিমাপ করা হয় না। |