IFrame player API আপনাকে আপনার ওয়েবসাইটে একটি YouTube ভিডিও প্লেয়ার এম্বেড করতে এবং JavaScript ব্যবহার করে প্লেয়ারটিকে নিয়ন্ত্রণ করতে দেয়।
API এর জাভাস্ক্রিপ্ট ফাংশন ব্যবহার করে, আপনি প্লেব্যাকের জন্য ভিডিওগুলি সারিবদ্ধ করতে পারেন; সেই ভিডিওগুলি চালান, বিরতি দিন বা বন্ধ করুন; প্লেয়ার ভলিউম সামঞ্জস্য করুন; অথবা ভিডিও চালানোর বিষয়ে তথ্য পুনরুদ্ধার করুন। আপনি ইভেন্ট শ্রোতাদেরও যোগ করতে পারেন যা প্লেয়ার স্টেট পরিবর্তনের মতো নির্দিষ্ট প্লেয়ার ইভেন্টের প্রতিক্রিয়া হিসাবে কার্যকর করবে।
এই নির্দেশিকা ব্যাখ্যা করে কিভাবে IFrame API ব্যবহার করতে হয়। এটি API পাঠাতে পারে এমন বিভিন্ন ধরণের ইভেন্ট সনাক্ত করে এবং সেই ইভেন্টগুলিতে প্রতিক্রিয়া জানাতে ইভেন্ট শ্রোতাদের কীভাবে লিখতে হয় তা ব্যাখ্যা করে। এটি বিভিন্ন জাভাস্ক্রিপ্ট ফাংশনগুলির বিবরণ দেয় যা আপনি ভিডিও প্লেয়ারকে নিয়ন্ত্রণ করতে কল করতে পারেন সেইসাথে প্লেয়ার প্যারামিটারগুলিকে আপনি প্লেয়ারকে আরও কাস্টমাইজ করতে ব্যবহার করতে পারেন৷
প্রয়োজনীয়তা
ব্যবহারকারীর ব্রাউজারকে অবশ্যই HTML5 postMessage
বৈশিষ্ট্য সমর্থন করতে হবে। বেশিরভাগ আধুনিক ব্রাউজার postMessage
সমর্থন করে।
Embedded players must have a viewport that is at least 200px by 200px. If the player displays controls, it must be large enough to fully display the controls without shrinking the viewport below the minimum size. We recommend 16:9 players be at least 480 pixels wide and 270 pixels tall.
IFrame API ব্যবহার করে এমন যেকোনো ওয়েব পেজকে অবশ্যই নিম্নলিখিত জাভাস্ক্রিপ্ট ফাংশন প্রয়োগ করতে হবে:
onYouTubeIframeAPIReady
– প্লেয়ার API-এর জন্য পৃষ্ঠাটি জাভাস্ক্রিপ্ট ডাউনলোড করা শেষ হলে API এই ফাংশনটিকে কল করবে, যা আপনাকে আপনার পৃষ্ঠায় API ব্যবহার করতে সক্ষম করে। সুতরাং, এই ফাংশনটি প্লেয়ার অবজেক্ট তৈরি করতে পারে যা আপনি পৃষ্ঠা লোড হওয়ার সময় প্রদর্শন করতে চান।
শুরু হচ্ছে
নীচের নমুনা HTML পৃষ্ঠাটি একটি এমবেডেড প্লেয়ার তৈরি করে যা একটি ভিডিও লোড করবে, এটি ছয় সেকেন্ডের জন্য চালাবে এবং তারপর প্লেব্যাক বন্ধ করবে৷ HTML-এ সংখ্যাযুক্ত মন্তব্যগুলি উদাহরণের নীচের তালিকায় ব্যাখ্যা করা হয়েছে।
<!DOCTYPE html> <html> <body> <!-- 1. The <iframe> (and video player) will replace this <div> tag. --> <div id="player"></div> <script> // 2. This code loads the IFrame Player API code asynchronously. var tag = document.createElement('script'); tag.src = "https://www.youtube.com/iframe_api"; var firstScriptTag = document.getElementsByTagName('script')[0]; firstScriptTag.parentNode.insertBefore(tag, firstScriptTag); // 3. This function creates an <iframe> (and YouTube player) // after the API code downloads. var player; function onYouTubeIframeAPIReady() { player = new YT.Player('player', { height: '390', width: '640', videoId: 'M7lc1UVf-VE', playerVars: { 'playsinline': 1 }, events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange } }); } // 4. The API will call this function when the video player is ready. function onPlayerReady(event) { event.target.playVideo(); } // 5. The API calls this function when the player's state changes. // The function indicates that when playing a video (state=1), // the player should play for six seconds and then stop. var done = false; function onPlayerStateChange(event) { if (event.data == YT.PlayerState.PLAYING && !done) { setTimeout(stopVideo, 6000); done = true; } } function stopVideo() { player.stopVideo(); } </script> </body> </html>
নিম্নলিখিত তালিকাটি উপরের নমুনা সম্পর্কে আরও বিশদ প্রদান করে:
এই বিভাগে
<div>
ট্যাগটি পৃষ্ঠার অবস্থান চিহ্নিত করে যেখানে IFrame API ভিডিও প্লেয়ার রাখবে। প্লেয়ার অবজেক্টের কনস্ট্রাক্টর, যা একটি ভিডিও প্লেয়ার লোড করা বিভাগে বর্ণিত হয়েছে, সেটিরid
দ্বারা<div>
ট্যাগ সনাক্ত করে যাতে API সঠিক অবস্থানে<iframe>
স্থাপন করে। বিশেষভাবে, IFrame API<div>
ট্যাগকে<iframe>
ট্যাগের সাথে প্রতিস্থাপন করবে।একটি বিকল্প হিসাবে, আপনি
<iframe>
উপাদানটি সরাসরি পৃষ্ঠায় রাখতে পারেন। একটি ভিডিও প্লেয়ার লোড করা বিভাগটি ব্যাখ্যা করে কিভাবে এটি করতে হয়।এই বিভাগের কোডটি IFrame Player API JavaScript কোড লোড করে। কোডটি অ্যাসিঙ্ক্রোনাসভাবে পুনরুদ্ধার করা হয়েছে তা নিশ্চিত করতে উদাহরণটি API কোড ডাউনলোড করতে DOM পরিবর্তন ব্যবহার করে। (
<script>
ট্যাগেরasync
অ্যাট্রিবিউট, যা অ্যাসিঙ্ক্রোনাস ডাউনলোডগুলিও সক্ষম করে, এই স্ট্যাক ওভারফ্লো উত্তরে আলোচনা করা সমস্ত আধুনিক ব্রাউজারে এখনও সমর্থিত নয়।প্লেয়ার API কোড ডাউনলোড হওয়ার সাথে সাথে
onYouTubeIframeAPIReady
ফাংশনটি কার্যকর হবে। কোডের এই অংশটি একটি গ্লোবাল ভেরিয়েবল,player
সংজ্ঞায়িত করে, যা আপনি যে ভিডিও প্লেয়ারটি এম্বেড করছেন তা বোঝায় এবং ফাংশনটি তারপর ভিডিও প্লেয়ার অবজেক্ট তৈরি করে।onPlayerReady
ফাংশনটি কার্যকর হবে যখনonReady
ইভেন্টটি চালু হবে। এই উদাহরণে, ফাংশনটি নির্দেশ করে যে ভিডিও প্লেয়ার প্রস্তুত হলে, এটি চালানো শুরু করা উচিত।প্লেয়ারের অবস্থা পরিবর্তিত হলে API
onPlayerStateChange
ফাংশনকে কল করবে, যা ইঙ্গিত করতে পারে যে প্লেয়ারটি খেলছে, বিরতি দিয়েছে, শেষ হয়েছে ইত্যাদি। ফাংশনটি নির্দেশ করে যে প্লেয়ার স্টেট1
(বাজানো) হলে, প্লেয়ারটিকে ছয় সেকেন্ডের জন্য খেলতে হবে এবং তারপর ভিডিও বন্ধ করতেstopVideo
ফাংশনটি কল করতে হবে।
একটি ভিডিও প্লেয়ার লোড হচ্ছে
API-এর JavaScript কোড লোড হওয়ার পরে, API onYouTubeIframeAPIReady
ফাংশনকে কল করবে, যেখানে আপনি আপনার পৃষ্ঠায় একটি ভিডিও প্লেয়ার সন্নিবেশ করার জন্য একটি YT.Player
অবজেক্ট তৈরি করতে পারেন। নীচের HTML অংশটি উপরের উদাহরণ থেকে onYouTubeIframeAPIReady
ফাংশন দেখায়:
var player; function onYouTubeIframeAPIReady() { player = new YT.Player('player', { height: '390', width: '640', videoId: 'M7lc1UVf-VE', playerVars: { 'playsinline': 1 }, events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange } }); }
ভিডিও প্লেয়ারের কনস্ট্রাক্টর নিম্নলিখিত পরামিতিগুলি নির্দিষ্ট করে:
প্রথম প্যারামিটারটি হয় DOM উপাদান বা HTML উপাদানের
id
নির্দিষ্ট করে যেখানে API প্লেয়ার ধারণকারী<iframe>
ট্যাগ সন্নিবেশ করবে।IFrame API নির্দিষ্ট উপাদানটিকে প্লেয়ার ধারণকারী
<iframe>
উপাদান দিয়ে প্রতিস্থাপন করবে। এটি আপনার পৃষ্ঠার লেআউটকে প্রভাবিত করতে পারে যদি প্রতিস্থাপিত উপাদানটির সন্নিবেশ করা<iframe>
উপাদানের চেয়ে ভিন্ন প্রদর্শন শৈলী থাকে। ডিফল্টরূপে, একটি<iframe>
একটিinline-block
উপাদান হিসাবে প্রদর্শিত হয়।- দ্বিতীয় প্যারামিটারটি এমন একটি বস্তু যা প্লেয়ারের বিকল্পগুলি নির্দিষ্ট করে। বস্তুটিতে নিম্নলিখিত বৈশিষ্ট্য রয়েছে:
-
width
(সংখ্যা) - ভিডিও প্লেয়ারের প্রস্থ। ডিফল্ট মান হল640
। -
height
(সংখ্যা) - ভিডিও প্লেয়ারের উচ্চতা। ডিফল্ট মান হল390
। -
videoId
(স্ট্রিং) - YouTube ভিডিও আইডি যা প্লেয়ারটি লোড করা ভিডিওটি সনাক্ত করে। -
playerVars
(অবজেক্ট) - অবজেক্টের বৈশিষ্ট্যগুলি প্লেয়ার প্যারামিটারগুলি সনাক্ত করে যা প্লেয়ারকে কাস্টমাইজ করতে ব্যবহার করা যেতে পারে। -
events
(অবজেক্ট) - বস্তুর বৈশিষ্ট্যগুলি সেই ইভেন্টগুলি সনাক্ত করে যেগুলি API ফায়ার করে এবং ফাংশনগুলি (ইভেন্ট লিসেনার) যেগুলিকে এপিআই কল করবে যখন সেই ঘটনাগুলি ঘটে। উদাহরণে, কনস্ট্রাক্টর নির্দেশ করে যেonPlayerReady
ফাংশনটি কার্যকর হবে যখনonReady
ইভেন্ট ফায়ার হবে এবংonPlayerStateChange
ফাংশনটি কার্যকর হবে যখনonStateChange
ইভেন্ট ফায়ার হবে।
-
শুরু করা বিভাগে উল্লিখিত হিসাবে, আপনার পৃষ্ঠায় একটি খালি <div>
উপাদান লেখার পরিবর্তে, যা প্লেয়ার API-এর জাভাস্ক্রিপ্ট কোড তারপর একটি <iframe>
উপাদান দিয়ে প্রতিস্থাপন করবে, আপনি নিজেই <iframe>
ট্যাগ তৈরি করতে পারেন। উদাহরণ বিভাগে প্রথম উদাহরণটি দেখায় কিভাবে এটি করতে হয়।
<iframe id="player" type="text/html" width="640" height="390" src="http://www.youtube.com/embed/M7lc1UVf-VE?enablejsapi=1&origin=http://example.com" frameborder="0"></iframe>
মনে রাখবেন যে আপনি যদি <iframe>
ট্যাগটি লেখেন, তাহলে আপনি YT.Player
অবজেক্ট তৈরি করার সময়, আপনাকে width
এবং height
মান নির্দিষ্ট করতে হবে না, যেগুলি <iframe>
ট্যাগ বা videoId
এর বৈশিষ্ট্য হিসাবে নির্দিষ্ট করা হয়েছে। এবং প্লেয়ার প্যারামিটার, যা src
URL-এ নির্দিষ্ট করা আছে। অতিরিক্ত নিরাপত্তা পরিমাপ হিসাবে, আপনাকে URL-এ origin
প্যারামিটার অন্তর্ভুক্ত করতে হবে, URL স্কিম ( http://
বা https://
) এবং প্যারামিটার মান হিসাবে আপনার হোস্ট পৃষ্ঠার সম্পূর্ণ ডোমেন নির্দিষ্ট করে৷ যদিও origin
ঐচ্ছিক, এটি সহ এটি ক্ষতিকারক তৃতীয় পক্ষের জাভাস্ক্রিপ্ট আপনার পৃষ্ঠায় ইনজেক্ট করা এবং আপনার YouTube প্লেয়ারের নিয়ন্ত্রণ হাইজ্যাক করা থেকে রক্ষা করে৷
উদাহরণ বিভাগটি ভিডিও প্লেয়ার অবজেক্ট তৈরির জন্য আরও কয়েকটি উদাহরণ দেখায়।
অপারেশন
প্লেয়ার এপিআই পদ্ধতিতে কল করার জন্য, আপনাকে প্রথমে প্লেয়ার অবজেক্টের একটি রেফারেন্স পেতে হবে যা আপনি নিয়ন্ত্রণ করতে চান। এই ডকুমেন্টের শুরু করা এবং একটি ভিডিও প্লেয়ার লোড করা বিভাগে আলোচনা করা হিসাবে আপনি একটি YT.Player
অবজেক্ট তৈরি করে রেফারেন্স পাবেন৷
ফাংশন
সারিবদ্ধ ফাংশন
সারিবদ্ধ ফাংশনগুলি আপনাকে একটি ভিডিও, একটি প্লেলিস্ট বা ভিডিওগুলির অন্য একটি তালিকা লোড এবং প্লে করতে দেয়৷ আপনি যদি এই ফাংশনগুলিকে কল করার জন্য নীচে বর্ণিত অবজেক্ট সিনট্যাক্স ব্যবহার করেন, তাহলে আপনি ব্যবহারকারীর আপলোড করা ভিডিওগুলির একটি তালিকা সারিতে বা লোড করতে পারেন৷
API সারিবদ্ধ ফাংশন কল করার জন্য দুটি ভিন্ন বাক্য গঠন সমর্থন করে।
আর্গুমেন্ট সিনট্যাক্সের জন্য ফাংশন আর্গুমেন্ট একটি নির্ধারিত ক্রমে তালিকাভুক্ত করা প্রয়োজন।
অবজেক্ট সিনট্যাক্স আপনাকে একটি বস্তুকে একক প্যারামিটার হিসাবে পাস করতে দেয় এবং আপনি যে ফাংশন আর্গুমেন্ট সেট করতে চান তার জন্য অবজেক্টের বৈশিষ্ট্য নির্ধারণ করতে দেয়। উপরন্তু, API অতিরিক্ত কার্যকারিতা সমর্থন করতে পারে যা আর্গুমেন্ট সিনট্যাক্স সমর্থন করে না।
উদাহরণস্বরূপ, loadVideoById
ফাংশনটি নিম্নলিখিত যে কোনও উপায়ে কল করা যেতে পারে। মনে রাখবেন যে অবজেক্ট সিনট্যাক্স endSeconds
বৈশিষ্ট্য সমর্থন করে, যা আর্গুমেন্ট সিনট্যাক্স সমর্থন করে না।
আর্গুমেন্ট সিনট্যাক্স
loadVideoById("bHQqvYy5KYo", 5, "large")
অবজেক্ট সিনট্যাক্স
loadVideoById({'videoId': 'bHQqvYy5KYo', 'startSeconds': 5, 'endSeconds': 60});
ভিডিওর জন্য সারিবদ্ধ ফাংশন
-
cueVideoById
আর্গুমেন্ট সিনট্যাক্স
player.cueVideoById(videoId:String, startSeconds:Number):Void
অবজেক্ট সিনট্যাক্স
player.cueVideoById({videoId:String, startSeconds:Number, endSeconds:Number}):Void
এই ফাংশনটি নির্দিষ্ট ভিডিওর থাম্বনেইল লোড করে এবং প্লেয়ারকে ভিডিও চালানোর জন্য প্রস্তুত করে।
playVideo()
বাseekTo()
কল না করা পর্যন্ত প্লেয়ার FLV-এর অনুরোধ করে না।- প্রয়োজনীয়
videoId
প্যারামিটারটি প্লে করা ভিডিওটির YouTube ভিডিও আইডি নির্দিষ্ট করে৷ YouTube Data API-এ, একটিvideo
রিসোর্সেরid
প্রপার্টি আইডি নির্দিষ্ট করে। - ঐচ্ছিক
startSeconds
প্যারামিটার একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবংplayVideo()
কল করার সময় ভিডিওটি যে সময় থেকে প্লে শুরু হবে তা নির্দিষ্ট করে। আপনি যদি একটিstartSeconds
মান নির্দিষ্ট করেন এবং তারপরseekTo()
কল করেন, তাহলে প্লেয়ারটিseekTo()
কলে নির্দিষ্ট সময় থেকে খেলবে। যখন ভিডিও cued এবং প্লে করার জন্য প্রস্তুত, প্লেয়ার একটিvideo cued
ঘটনা সম্প্রচার করবে (5
)। - ঐচ্ছিক
endSeconds
প্যারামিটার, যা শুধুমাত্র অবজেক্ট সিনট্যাক্সে সমর্থিত, একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবংplayVideo()
কল করার সময় ভিডিওটি কখন চালানো বন্ধ করা উচিত তা নির্দিষ্ট করে। যদি আপনি একটিendSeconds
মান নির্দিষ্ট করেন এবং তারপরseekTo()
কল করেন, তাহলেendSeconds
মান আর কার্যকর হবে না।
loadVideoById
আর্গুমেন্ট সিনট্যাক্স
player.loadVideoById(videoId:String, startSeconds:Number):Void
অবজেক্ট সিনট্যাক্স
player.loadVideoById({videoId:String, startSeconds:Number, endSeconds:Number}):Void
এই ফাংশনটি নির্দিষ্ট ভিডিও লোড করে এবং প্লে করে।
- প্রয়োজনীয়
videoId
প্যারামিটারটি প্লে করা ভিডিওটির YouTube ভিডিও আইডি নির্দিষ্ট করে৷ YouTube Data API-এ, একটিvideo
রিসোর্সেরid
প্রপার্টি আইডি নির্দিষ্ট করে। - ঐচ্ছিক
startSeconds
প্যারামিটার একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে। যদি এটি নির্দিষ্ট করা হয়, তাহলে ভিডিওটি নিকটতম কীফ্রেম থেকে নির্দিষ্ট সময়ে শুরু হবে। - ঐচ্ছিক
endSeconds
প্যারামিটার একটি float/integer গ্রহণ করে। যদি এটি নির্দিষ্ট করা হয়, তাহলে ভিডিওটি নির্দিষ্ট সময়ে চালানো বন্ধ হয়ে যাবে।
cueVideoByUrl
আর্গুমেন্ট সিনট্যাক্স
player.cueVideoByUrl(mediaContentUrl:String, startSeconds:Number):Void
অবজেক্ট সিনট্যাক্স
player.cueVideoByUrl({mediaContentUrl:String, startSeconds:Number, endSeconds:Number}):Void
এই ফাংশনটি নির্দিষ্ট ভিডিওর থাম্বনেইল লোড করে এবং প্লেয়ারকে ভিডিও চালানোর জন্য প্রস্তুত করে।
playVideo()
বাseekTo()
কল না করা পর্যন্ত প্লেয়ার FLV-এর অনুরোধ করে না।- প্রয়োজনীয়
mediaContentUrl
প্যারামিটারhttp://www.youtube.com/v/VIDEO_ID?version=3
ফর্ম্যাটে একটি সম্পূর্ণ যোগ্য YouTube প্লেয়ার URL নির্দিষ্ট করে। - ঐচ্ছিক
startSeconds
প্যারামিটার একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবংplayVideo()
কল করার সময় ভিডিওটি যে সময় থেকে প্লে শুরু হবে তা নির্দিষ্ট করে। যদি আপনিstartSeconds
নির্দিষ্ট করেন এবং তারপরseekTo()
কল করেন, তাহলে প্লেয়ারটিseekTo()
কলে নির্দিষ্ট সময় থেকে খেলবে। যখন ভিডিও cued এবং প্লে করার জন্য প্রস্তুত, প্লেয়ার একটিvideo cued
ইভেন্ট (5) সম্প্রচার করবে। - ঐচ্ছিক
endSeconds
প্যারামিটার, যা শুধুমাত্র অবজেক্ট সিনট্যাক্সে সমর্থিত, একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবংplayVideo()
কল করার সময় ভিডিওটি কখন চালানো বন্ধ করা উচিত তা নির্দিষ্ট করে। যদি আপনি একটিendSeconds
মান নির্দিষ্ট করেন এবং তারপরseekTo()
কল করেন, তাহলেendSeconds
মান আর কার্যকর হবে না।
loadVideoByUrl
আর্গুমেন্ট সিনট্যাক্স
player.loadVideoByUrl(mediaContentUrl:String, startSeconds:Number):Void
অবজেক্ট সিনট্যাক্স
player.loadVideoByUrl({mediaContentUrl:String, startSeconds:Number, endSeconds:Number}):Void
এই ফাংশনটি নির্দিষ্ট ভিডিও লোড করে এবং প্লে করে।
- প্রয়োজনীয়
mediaContentUrl
প্যারামিটারhttp://www.youtube.com/v/VIDEO_ID?version=3
ফর্ম্যাটে একটি সম্পূর্ণ যোগ্য YouTube প্লেয়ার URL নির্দিষ্ট করে। - ঐচ্ছিক
startSeconds
প্যারামিটার একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবং যে সময় থেকে ভিডিওটি চালানো শুরু করা উচিত তা নির্দিষ্ট করে৷ যদিstartSeconds
(সংখ্যা একটি ফ্লোট হতে পারে) নির্দিষ্ট করা হয়, তাহলে ভিডিওটি নিকটতম কীফ্রেম থেকে নির্দিষ্ট সময়ে শুরু হবে। - ঐচ্ছিক
endSeconds
প্যারামিটার, যা শুধুমাত্র অবজেক্ট সিনট্যাক্সে সমর্থিত, একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবং ভিডিওটি কখন চালানো বন্ধ করা উচিত তা নির্দিষ্ট করে।
তালিকার জন্য সারিবদ্ধ ফাংশন
cuePlaylist
এবং loadPlaylist
ফাংশনগুলি আপনাকে একটি প্লেলিস্ট লোড এবং প্লে করার অনুমতি দেয়। আপনি যদি এই ফাংশনগুলিকে কল করার জন্য অবজেক্ট সিনট্যাক্স ব্যবহার করেন তবে আপনি ব্যবহারকারীর আপলোড করা ভিডিওগুলির একটি তালিকা সারিবদ্ধ (বা লোড) করতে পারেন৷
যেহেতু ফাংশনগুলি আর্গুমেন্ট সিনট্যাক্স বা অবজেক্ট সিনট্যাক্স ব্যবহার করে কল করা হয়েছে তার উপর নির্ভর করে ভিন্নভাবে কাজ করে, উভয় কলিং পদ্ধতি নীচে নথিভুক্ত করা হয়েছে।
-
cuePlaylist
আর্গুমেন্ট সিনট্যাক্স
player.cuePlaylist(playlist:String|Array, index:Number, startSeconds:Number):Void
নির্দিষ্ট প্লেলিস্ট সারিবদ্ধ করে। যখন প্লেলিস্ট cued এবং প্লে করার জন্য প্রস্তুত, প্লেয়ার একটিvideo cued
ঘটনা সম্প্রচার করবে (5
)।প্রয়োজনীয়
playlist
প্যারামিটার YouTube ভিডিও আইডিগুলির একটি অ্যারে নির্দিষ্ট করে৷ YouTube Data API-এ,video
রিসোর্সেরid
প্রপার্টি সেই ভিডিওটির আইডি শনাক্ত করে।ঐচ্ছিক
index
প্যারামিটার প্লেলিস্টের প্রথম ভিডিওর সূচী নির্দিষ্ট করে যা প্লে হবে। প্যারামিটারটি একটি শূন্য-ভিত্তিক সূচক ব্যবহার করে এবং ডিফল্ট প্যারামিটার মান হল0
, তাই ডিফল্ট আচরণ হল প্লেলিস্টের প্রথম ভিডিও লোড করা এবং প্লে করা৷ঐচ্ছিক
startSeconds
প্যারামিটারটি একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবংplayVideo()
ফাংশনটি কল করার সময় প্লেলিস্টের প্রথম ভিডিওটি প্লে শুরু করার সময় নির্দিষ্ট করে৷ আপনি যদি একটিstartSeconds
মান নির্দিষ্ট করেন এবং তারপরseekTo()
কল করেন, তাহলে প্লেয়ারটিseekTo()
কলে নির্দিষ্ট সময় থেকে খেলবে। আপনি যদি একটি প্লেলিস্ট কিউ করেন এবং তারপরplayVideoAt()
ফাংশনটি কল করেন, প্লেয়ারটি নির্দিষ্ট ভিডিওর শুরুতে বাজানো শুরু করবে।
অবজেক্ট সিনট্যাক্স
player.cuePlaylist({listType:String, list:String, index:Number, startSeconds:Number}):Void
ভিডিওর নির্দিষ্ট তালিকা সারিবদ্ধ করে। তালিকাটি একটি প্লেলিস্ট বা ব্যবহারকারীর আপলোড করা ভিডিও ফিড হতে পারে৷ সার্চ ফলাফলের একটি তালিকা সারিবদ্ধ করার ক্ষমতা বাতিল করা হয়েছে এবং15 নভেম্বর 2020 থেকে আর সমর্থিত হবে না।যখন তালিকা cued এবং খেলার জন্য প্রস্তুত, প্লেয়ার একটি
video cued
ঘটনা সম্প্রচার করবে (5
)।ঐচ্ছিক
listType
সম্পত্তি আপনি যে ধরনের ফলাফল ফিড পুনরুদ্ধার করছেন তা নির্দিষ্ট করে। বৈধ মান হলplaylist
এবংuser_uploads
।15 নভেম্বর 2020 থেকে একটি অবচয়িত মান,search
আর সমর্থিত হবে না। ডিফল্ট মান হলplaylist
।প্রয়োজনীয়
list
বৈশিষ্ট্যে একটি কী রয়েছে যা YouTube-এর ফেরত দেওয়া ভিডিওগুলির নির্দিষ্ট তালিকা চিহ্নিত করে৷- যদি
listType
সম্পত্তির মানplaylist
হয়, তাহলেlist
বৈশিষ্ট্য প্লেলিস্ট আইডি বা ভিডিও আইডিগুলির একটি অ্যারে নির্দিষ্ট করে৷ YouTube ডেটা এপিআই-এ,playlist
রিসোর্সেরid
প্রপার্টি একটি প্লেলিস্টের আইডি শনাক্ত করে এবংvideo
রিসোর্সেরid
প্রোপার্টি একটি ভিডিও আইডি নির্দিষ্ট করে। - যদি
listType
সম্পত্তির মানuser_uploads
হয়, তাহলেlist
বৈশিষ্ট্য সেই ব্যবহারকারীকে চিহ্নিত করে যার আপলোড করা ভিডিওগুলি ফেরত দেওয়া হবে। - যদি
listType
সম্পত্তির মানsearch
হয়, তাহলেlist
বৈশিষ্ট্য অনুসন্ধান ক্যোয়ারী নির্দিষ্ট করে। দ্রষ্টব্য: এই কার্যকারিতা বাতিল করা হয়েছে এবং15 নভেম্বর 2020 থেকে আর সমর্থিত হবে না।
- যদি
ঐচ্ছিক
index
বৈশিষ্ট্য তালিকার প্রথম ভিডিওর সূচী নির্দিষ্ট করে যা প্লে হবে। প্যারামিটারটি একটি শূন্য-ভিত্তিক সূচক ব্যবহার করে এবং ডিফল্ট প্যারামিটারের মান হল0
, তাই ডিফল্ট আচরণ হল তালিকার প্রথম ভিডিওটি লোড করা এবং প্লে করা৷ঐচ্ছিক
startSeconds
বৈশিষ্ট্যটি একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবংplayVideo()
ফাংশনটি কল করার সময় তালিকার প্রথম ভিডিওটি প্লে শুরু করার সময় নির্দিষ্ট করে৷ আপনি যদি একটিstartSeconds
মান নির্দিষ্ট করেন এবং তারপরseekTo()
কল করেন, তাহলে প্লেয়ারটিseekTo()
কলে নির্দিষ্ট সময় থেকে খেলবে। আপনি যদি একটি তালিকা কিউ করেন এবং তারপরplayVideoAt()
ফাংশনটি কল করেন, প্লেয়ারটি নির্দিষ্ট ভিডিওর শুরুতে বাজানো শুরু করবে।
-
loadPlaylist
আর্গুমেন্ট সিনট্যাক্স
player.loadPlaylist(playlist:String|Array, index:Number, startSeconds:Number):Void
এই ফাংশনটি নির্দিষ্ট প্লেলিস্ট লোড করে এবং এটি চালায়।প্রয়োজনীয়
playlist
প্যারামিটার YouTube ভিডিও আইডিগুলির একটি অ্যারে নির্দিষ্ট করে৷ YouTube Data API-এ,video
রিসোর্সেরid
প্রপার্টি একটি ভিডিও আইডি নির্দিষ্ট করে।ঐচ্ছিক
index
প্যারামিটার প্লেলিস্টের প্রথম ভিডিওর সূচী নির্দিষ্ট করে যা প্লে হবে। প্যারামিটারটি একটি শূন্য-ভিত্তিক সূচক ব্যবহার করে এবং ডিফল্ট প্যারামিটার মান হল0
, তাই ডিফল্ট আচরণ হল প্লেলিস্টের প্রথম ভিডিও লোড করা এবং প্লে করা৷ঐচ্ছিক
startSeconds
প্যারামিটার একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবং প্লেলিস্টের প্রথম ভিডিওটি যে সময় থেকে প্লে শুরু হবে তা নির্দিষ্ট করে৷
অবজেক্ট সিনট্যাক্স
player.loadPlaylist({list:String, listType:String, index:Number, startSeconds:Number}):Void
এই ফাংশনটি নির্দিষ্ট তালিকা লোড করে এবং এটি চালায়। তালিকাটি একটি প্লেলিস্ট বা ব্যবহারকারীর আপলোড করা ভিডিও ফিড হতে পারে৷ সার্চ ফলাফলের একটি তালিকা লোড করার ক্ষমতা বাতিল করা হয়েছে এবং15 নভেম্বর 2020 থেকে আর সমর্থিত হবে না।ঐচ্ছিক
listType
সম্পত্তি আপনি যে ধরনের ফলাফল ফিড পুনরুদ্ধার করছেন তা নির্দিষ্ট করে। বৈধ মান হলplaylist
এবংuser_uploads
।15 নভেম্বর 2020 থেকে একটি অবচয়িত মান,search
আর সমর্থিত হবে না। ডিফল্ট মান হলplaylist
।প্রয়োজনীয়
list
বৈশিষ্ট্যে একটি কী রয়েছে যা YouTube-এর ফেরত দেওয়া ভিডিওগুলির নির্দিষ্ট তালিকা চিহ্নিত করে৷- যদি
listType
সম্পত্তির মানplaylist
হয়, তাহলেlist
বৈশিষ্ট্য একটি প্লেলিস্ট আইডি বা ভিডিও আইডিগুলির একটি অ্যারে নির্দিষ্ট করে৷ YouTube ডেটা এপিআই-এ,playlist
রিসোর্সেরid
প্রপার্টি একটি প্লেলিস্টের আইডি নির্দিষ্ট করে এবংvideo
রিসোর্সেরid
প্রোপার্টি একটি ভিডিও আইডি নির্দিষ্ট করে। - যদি
listType
সম্পত্তির মানuser_uploads
হয়, তাহলেlist
বৈশিষ্ট্য সেই ব্যবহারকারীকে চিহ্নিত করে যার আপলোড করা ভিডিওগুলি ফেরত দেওয়া হবে। - যদি
listType
সম্পত্তির মানsearch
হয়, তাহলেlist
বৈশিষ্ট্য অনুসন্ধান ক্যোয়ারী নির্দিষ্ট করে। দ্রষ্টব্য: এই কার্যকারিতা বাতিল করা হয়েছে এবং15 নভেম্বর 2020 থেকে আর সমর্থিত হবে না।
- যদি
ঐচ্ছিক
index
বৈশিষ্ট্য তালিকার প্রথম ভিডিওর সূচী নির্দিষ্ট করে যা প্লে হবে। প্যারামিটারটি একটি শূন্য-ভিত্তিক সূচক ব্যবহার করে এবং ডিফল্ট প্যারামিটারের মান হল0
, তাই ডিফল্ট আচরণ হল তালিকার প্রথম ভিডিওটি লোড করা এবং প্লে করা৷ঐচ্ছিক
startSeconds
বৈশিষ্ট্য একটি ফ্লোট/পূর্ণসংখ্যা গ্রহণ করে এবং তালিকার প্রথম ভিডিওটি যে সময় থেকে প্লে শুরু হবে তা নির্দিষ্ট করে।
প্লেব্যাক নিয়ন্ত্রণ এবং প্লেয়ার সেটিংস
একটি ভিডিও চালানো হচ্ছে
-
player. playVideo ():Void
- বর্তমানে cued/লোড করা ভিডিও চালায়। এই ফাংশনটি চালানোর পরে চূড়ান্ত প্লেয়ার স্টেট
playing
করা হবে (1)।
দ্রষ্টব্য: একটি প্লেব্যাক শুধুমাত্র একটি ভিডিওর অফিসিয়াল ভিউ গণনার দিকে গণনা করা হয় যদি এটি প্লেয়ারে একটি নেটিভ প্লে বোতামের মাধ্যমে শুরু করা হয়।
-
player. pauseVideo ():Void
- বর্তমানে বাজানো ভিডিও পজ করে। এই ফাংশনটি চালানোর পরে চূড়ান্ত প্লেয়ার স্টেটটি
paused
করা হবে (2
) যদি না প্লেয়ারended
(0
) অবস্থায় থাকে যখন ফাংশনটি কল করা হয়, এই ক্ষেত্রে প্লেয়ার স্টেট পরিবর্তন হবে না।
-
player. stopVideo ():Void
- বর্তমান ভিডিও লোড করা বন্ধ করে এবং বাতিল করে। এই ফাংশনটি বিরল পরিস্থিতিতে সংরক্ষিত হওয়া উচিত যখন আপনি জানেন যে ব্যবহারকারী প্লেয়ারে অতিরিক্ত ভিডিও দেখবে না। আপনার উদ্দেশ্য যদি ভিডিওটি পজ করা হয়, তাহলে আপনাকে শুধুমাত্র
pauseVideo
ফাংশনটি কল করতে হবে। আপনি যদি প্লেয়ারটি যে ভিডিওটি চালাচ্ছে তা পরিবর্তন করতে চান, আপনি প্রথমেstopVideo
কল না করে সারিবদ্ধ ফাংশনগুলির একটিতে কল করতে পারেন৷
গুরুত্বপূর্ণ:pauseVideo
ফাংশনের বিপরীতে, যা প্লেয়ারকেpaused
(2
) অবস্থায় রেখে যায়,stopVideo
ফাংশন প্লেয়ারটিকেended
(0
),paused
(2
),video cued
(5
) সহ যেকোনও না-বাজানো অবস্থায় রাখতে পারেunstarted
(-1
)।
-
player. seekTo (seconds:Number, allowSeekAhead:Boolean):Void
- ভিডিওতে একটি নির্দিষ্ট সময় চেয়েছেন। ফাংশনটি কল করার সময় প্লেয়ারকে বিরতি দেওয়া হলে, এটি বিরতিযুক্ত থাকবে। যদি ফাংশনটি অন্য রাজ্য থেকে কল করা হয় (
playing
,video cued
, ইত্যাদি), প্লেয়ার ভিডিওটি চালাবে।seconds
প্যারামিটারটি খেলোয়াড়ের অগ্রসর হওয়ার সময় চিহ্নিত করে।প্লেয়ারটি সেই সময়ের আগে নিকটতম কীফ্রেমে অগ্রসর হবে যদি না প্লেয়ারটি ইতিমধ্যেই ভিডিওর অংশটি ডাউনলোড করে থাকে যা ব্যবহারকারী খুঁজছেন৷
seconds
প্যারামিটারটি বর্তমানে বাফার করা ভিডিও ডেটার বাইরে একটি সময় নির্দিষ্ট করলে প্লেয়ার সার্ভারে একটি নতুন অনুরোধ করবে কিনা তাallowSeekAhead
প্যারামিটার নির্ধারণ করে।আমরা সুপারিশ করি যে আপনি এই প্যারামিটারটিকে
false
সেট করুন যখন ব্যবহারকারী একটি ভিডিও অগ্রগতি দণ্ড বরাবর মাউস টেনে আনুন এবং তারপর ব্যবহারকারী মাউস ছেড়ে দিলে এটিtrue
সেট করুন৷ এই পদ্ধতিটি ব্যবহারকারীকে ভিডিওতে অতীতের আনবাফার পয়েন্টগুলি স্ক্রোল করে নতুন ভিডিও স্ট্রিমের অনুরোধ না করে একটি ভিডিওর বিভিন্ন পয়েন্টে স্ক্রোল করতে দেয়। যখন ব্যবহারকারী মাউস বোতামটি ছেড়ে দেয়, প্লেয়ারটি ভিডিওতে পছন্দসই পয়েন্টে অগ্রসর হয় এবং প্রয়োজনে একটি নতুন ভিডিও স্ট্রিমের অনুরোধ করে।
360° ভিডিওর প্লেব্যাক নিয়ন্ত্রণ করা
দ্রষ্টব্য: 360° ভিডিও প্লেব্যাকের অভিজ্ঞতা মোবাইল ডিভাইসে সীমিত সমর্থন করে। অসমর্থিত ডিভাইসগুলিতে, 360° ভিডিওগুলি বিকৃত দেখায় এবং API এর মাধ্যমে, ওরিয়েন্টেশন সেন্সর ব্যবহার করে বা ডিভাইসের স্ক্রিনে টাচ/ড্র্যাগ অ্যাকশনের প্রতিক্রিয়া সহ দেখার দৃষ্টিভঙ্গি পরিবর্তন করার কোনও সমর্থিত উপায় নেই৷
-
player. getSphericalProperties ():Object
- একটি ভিডিও প্লেব্যাকের জন্য দর্শকের বর্তমান দৃষ্টিভঙ্গি বা ভিউ বর্ণনা করে এমন বৈশিষ্ট্যগুলি পুনরুদ্ধার করে৷ এছাড়াও:
- এই বস্তুটি শুধুমাত্র 360° ভিডিওর জন্য জনবহুল, যাকে গোলাকার ভিডিওও বলা হয়।
- যদি বর্তমান ভিডিওটি একটি 360° ভিডিও না হয় বা যদি একটি অ-সমর্থিত ডিভাইস থেকে ফাংশনটি কল করা হয়, তাহলে ফাংশনটি একটি খালি বস্তু প্রদান করে।
- সমর্থিত মোবাইল ডিভাইসে, যদি
enableOrientationSensor
প্রপার্টিtrue
তে সেট করা থাকে, তাহলে এই ফাংশনটি এমন একটি অবজেক্ট রিটার্ন করে যেখানেfov
প্রপার্টি সঠিক মান ধারণ করে এবং অন্যান্য প্রপার্টি0
এ সেট করা থাকে।
বৈশিষ্ট্য yaw
পরিসরে একটি সংখ্যা [0, 360) যেটি ডিগ্রীতে দৃশ্যের অনুভূমিক কোণকে প্রতিনিধিত্ব করে, যা ব্যবহারকারী কতটা বাম বা ডান দিকে মুখ করতে ভিউকে ঘুরিয়ে দেয় তা প্রতিফলিত করে। নিরপেক্ষ অবস্থান, ভিডিওর কেন্দ্রের দিকে মুখ করে এর ইকুরেক্টাঙ্গুলার প্রজেকশনে, 0° প্রতিনিধিত্ব করে এবং দর্শক বাম দিকে ঘুরলে এই মান বৃদ্ধি পায়। pitch
পরিসরে একটি সংখ্যা [-90, 90] যা ডিগ্রীতে দৃশ্যের উল্লম্ব কোণকে প্রতিনিধিত্ব করে, যা ব্যবহারকারী কতটা উপরে বা নিচে দেখতে ভিউটিকে সামঞ্জস্য করে তা প্রতিফলিত করে। নিরপেক্ষ অবস্থান, ভিডিওর কেন্দ্রের দিকে মুখ করে এর নিরক্ষভুজাকার অভিক্ষেপ, 0° প্রতিনিধিত্ব করে, এবং দর্শকের দিকে তাকালে এই মান বৃদ্ধি পায়। roll
পরিসরের একটি সংখ্যা [-180, 180] যা ডিগ্রীতে দৃশ্যের ঘড়ির কাঁটার বা বিপরীত দিকে ঘূর্ণন কোণকে উপস্থাপন করে। নিরপেক্ষ অবস্থান, সমভুজাকার অভিক্ষেপে অনুভূমিক অক্ষটি দৃশ্যের অনুভূমিক অক্ষের সমান্তরাল, 0° প্রতিনিধিত্ব করে। ভিউ ঘড়ির কাঁটার দিকে ঘোরার সাথে সাথে মান বৃদ্ধি পায় এবং ভিউ ঘড়ির কাঁটার বিপরীতে ঘোরার সাথে সাথে হ্রাস পায়।
মনে রাখবেন যে এমবেড করা প্লেয়ারটি দৃশ্যের রোল সামঞ্জস্য করার জন্য একটি ব্যবহারকারী ইন্টারফেস উপস্থাপন করে না। এই পারস্পরিক একচেটিয়া উপায়ে রোলটি সামঞ্জস্য করা যেতে পারে:- দৃশ্যের জন্য রোল প্রদান করতে একটি মোবাইল ব্রাউজারে ওরিয়েন্টেশন সেন্সর ব্যবহার করুন। যদি ওরিয়েন্টেশন সেন্সর সক্রিয় থাকে, তাহলে
getSphericalProperties
ফাংশন সর্বদাroll
সম্পত্তির মান হিসাবে0
প্রদান করে। - যদি ওরিয়েন্টেশন সেন্সর অক্ষম থাকে, তাহলে এই API ব্যবহার করে রোলটিকে একটি অশূন্য মানতে সেট করুন।
fov
পরিসরের একটি সংখ্যা [30, 120] যা ভিউপোর্টের দীর্ঘ প্রান্ত বরাবর পরিমাপ করা ডিগ্রীতে দৃশ্যের ক্ষেত্র-অফ-ভিউকে উপস্থাপন করে। সংক্ষিপ্ত প্রান্তটি স্বয়ংক্রিয়ভাবে দৃশ্যের আকৃতির অনুপাতের সমানুপাতিক হতে সমন্বয় করা হয়।
ডিফল্ট মান হল 100 ডিগ্রী। মান হ্রাস করা ভিডিও সামগ্রীতে জুম করার মতো, এবং মান বৃদ্ধি করা জুম আউট করার মতো। এই মানটি API ব্যবহার করে বা ভিডিওটি ফুলস্ক্রিন মোডে থাকাকালীন মাউসহুইল ব্যবহার করে সামঞ্জস্য করা যেতে পারে।
-
player. setSphericalProperties (properties:Object):Void
- একটি 360° ভিডিও প্লেব্যাকের জন্য ভিডিও অভিযোজন সেট করে। (যদি বর্তমান ভিডিওটি গোলাকার না হয়, তবে ইনপুট নির্বিশেষে পদ্ধতিটি একটি নো-অপ।)
প্লেয়ার ভিউproperties
অবজেক্টে যেকোন পরিচিত বৈশিষ্ট্যের মানগুলিকে প্রতিফলিত করার জন্য আপডেট করে এই পদ্ধতিতে কলগুলিতে সাড়া দেয়। দৃশ্যটি সেই বস্তুতে অন্তর্ভুক্ত নয় এমন অন্য কোনো পরিচিত বৈশিষ্ট্যের মান বজায় রাখে।
এছাড়াও:- বস্তুতে অজানা এবং/অথবা অপ্রত্যাশিত বৈশিষ্ট্য থাকলে, প্লেয়ার তাদের উপেক্ষা করে।
- এই বিভাগের শুরুতে উল্লেখ করা হয়েছে, 360° ভিডিও প্লেব্যাক অভিজ্ঞতা সমস্ত মোবাইল ডিভাইসে সমর্থিত নয়।
- ডিফল্টরূপে, সমর্থিত মোবাইল ডিভাইসগুলিতে, এই ফাংশনটি শুধুমাত্র
fov
বৈশিষ্ট্য সেট করে এবং 360° ভিডিও প্লেব্যাকের জন্যyaw
,pitch
এবংroll
বৈশিষ্ট্যগুলিকে প্রভাবিত করে না। আরও বিস্তারিত জানার জন্য নীচেরenableOrientationSensor
সম্পত্তি দেখুন।
properties
বস্তুতে নিম্নলিখিত বৈশিষ্ট্য রয়েছে:বৈশিষ্ট্য yaw
উপরে সংজ্ঞা দেখুন. pitch
উপরে সংজ্ঞা দেখুন. roll
উপরে সংজ্ঞা দেখুন. fov
উপরে সংজ্ঞা দেখুন. enableOrientationSensor
দ্রষ্টব্য: এই বৈশিষ্ট্যটি শুধুমাত্র সমর্থিত ডিভাইসগুলিতে 360° দেখার অভিজ্ঞতাকে প্রভাবিত করে। একটি বুলিয়ান মান যা নির্দেশ করে যে IFrame এম্বেড ইভেন্টগুলিতে সাড়া দেবে কিনা যা একটি সমর্থিত ডিভাইসের অভিযোজনে পরিবর্তনের সংকেত দেয়, যেমন একটি মোবাইল ব্রাউজারের DeviceOrientationEvent
। ডিফল্ট প্যারামিটার মানtrue
।
সমর্থিত মোবাইল ডিভাইস- মানটি
true
হলে, একটি এমবেডেড প্লেয়ার 360 ° ভিডিও প্লেব্যাকের জন্যyaw
,pitch
এবংroll
বৈশিষ্ট্যগুলি সামঞ্জস্য করতে ডিভাইসের গতিবিধির উপর নির্ভর করে। যাইহোক, এখনও API এর মাধ্যমেfov
সম্পত্তি পরিবর্তন করা যেতে পারে, এবং API হল, বাস্তবে, একটি মোবাইল ডিভাইসেfov
সম্পত্তি পরিবর্তন করার একমাত্র উপায়। এটাই স্বাভাবিক ব্যবহার। - যখন মানটি
false
হয়, তখন ডিভাইসের গতিবিধি 360° দেখার অভিজ্ঞতাকে প্রভাবিত করে না, এবংyaw
,pitch
,roll
এবংfov
বৈশিষ্ট্যগুলিকে অবশ্যই API এর মাধ্যমে সেট করতে হবে।
অসমর্থিত মোবাইল ডিভাইস
enableOrientationSensor
সম্পত্তির মান প্লেব্যাকের অভিজ্ঞতার উপর কোন প্রভাব ফেলে না।
একটি প্লেলিস্টে একটি ভিডিও চালানো হচ্ছে
-
player. nextVideo ():Void
- এই ফাংশনটি প্লেলিস্টের পরবর্তী ভিডিও লোড করে এবং প্লে করে।
যদি প্লেলিস্টের শেষ ভিডিওটি দেখার সময়
player.nextVideo()
কল করা হয় এবং প্লেলিস্টটি ক্রমাগত প্লে করার জন্য সেট করা হয় (loop
), তাহলে প্লেয়ারটি তালিকার প্রথম ভিডিওটি লোড করবে এবং প্লে করবে৷যদি প্লেলিস্টের শেষ ভিডিওটি দেখার সময়
player.nextVideo()
কল করা হয় এবং প্লেলিস্টটি ক্রমাগত প্লে করার জন্য সেট করা না থাকে, তাহলে প্লেব্যাক শেষ হয়ে যাবে।
-
player. previousVideo ():Void
- এই ফাংশনটি প্লেলিস্টে আগের ভিডিও লোড করে এবং প্লে করে।
যদি প্লেলিস্টের প্রথম ভিডিওটি দেখার সময়
player.previousVideo()
কল করা হয় এবং প্লেলিস্টটি ক্রমাগত প্লে করার জন্য সেট করা থাকে (loop
), তাহলে প্লেয়ারটি তালিকার শেষ ভিডিওটি লোড করবে এবং প্লে করবে।প্লেলিস্টের প্রথম ভিডিওটি দেখার সময় যদি
player.previousVideo()
কল করা হয় এবং প্লেলিস্টটি ক্রমাগত প্লে করার জন্য সেট করা না থাকে, তাহলে প্লেয়ার প্রথম প্লেলিস্ট ভিডিওটি শুরু থেকে রিস্টার্ট করবে।
-
player. playVideoAt (index:Number):Void
- এই ফাংশনটি প্লেলিস্টে নির্দিষ্ট ভিডিও লোড করে এবং প্লে করে।
প্রয়োজনীয়
index
প্যারামিটারটি ভিডিওটির সূচী নির্দিষ্ট করে যা আপনি প্লেলিস্টে চালাতে চান। প্যারামিটারটি একটি শূন্য-ভিত্তিক সূচক ব্যবহার করে, তাই0
এর মান তালিকার প্রথম ভিডিওটিকে চিহ্নিত করে৷ আপনি যদি প্লেলিস্টটি এলোমেলো করে থাকেন, তাহলে এই ফাংশনটি এলোমেলো প্লেলিস্টের নির্দিষ্ট অবস্থানে ভিডিও চালাবে।
প্লেয়ার ভলিউম পরিবর্তন
-
player. mute ():Void
- প্লেয়ারকে নিঃশব্দ করে।
-
player. unMute ():Void
- প্লেয়ারকে আনমিউট করে।
-
player. isMuted ():Boolean
- প্লেয়ার নিঃশব্দ হলে
true
, না হলেfalse
ফেরত দেয়।
-
player. setVolume (volume:Number):Void
- ভলিউম সেট করে।
0
এবং100
এর মধ্যে একটি পূর্ণসংখ্যা গ্রহণ করে।
-
player. getVolume ():Number
- প্লেয়ারের বর্তমান ভলিউম,
0
এবং100
মধ্যে একটি পূর্ণসংখ্যা প্রদান করে। মনে রাখবেন যে প্লেয়ারটি নিঃশব্দ থাকলেওgetVolume()
ভলিউম ফিরিয়ে দেবে।
প্লেয়ারের আকার সেট করা হচ্ছে
-
player.setSize(width:Number, height:Number):Object
- প্লেয়ার ধারণ করে
<iframe>
এর পিক্সেলের আকার সেট করে।
প্লেব্যাক রেট সেট করা হচ্ছে
-
player. getPlaybackRate ():Number
- এই ফাংশনটি বর্তমানে বাজানো ভিডিওর প্লেব্যাক রেট পুনরুদ্ধার করে। ডিফল্ট প্লেব্যাক রেট হল
1
, যা নির্দেশ করে যে ভিডিওটি স্বাভাবিক গতিতে চলছে৷ প্লেব্যাক রেট0.25
,0.5
,1
,1.5
, এবং2
এর মত মান অন্তর্ভুক্ত করতে পারে৷
-
player. setPlaybackRate (suggestedRate:Number):Void
- এই ফাংশনটি বর্তমান ভিডিওর জন্য প্রস্তাবিত প্লেব্যাক রেট সেট করে। প্লেব্যাকের হার পরিবর্তিত হলে, এটি শুধুমাত্র সেই ভিডিওর জন্য পরিবর্তিত হবে যা ইতিমধ্যেই কিউ করা হয়েছে বা চালানো হচ্ছে৷ আপনি যদি একটি cued ভিডিওর জন্য প্লেব্যাক রেট সেট করেন, তাহলে
playVideo
ফাংশন কল করা হলে বা প্লেয়ার কন্ট্রোলের মাধ্যমে ব্যবহারকারী সরাসরি প্লেব্যাক শুরু করলে সেই হার কার্যকর থাকবে৷ উপরন্তু, ভিডিও বা প্লেলিস্ট (cueVideoById
,loadVideoById
, ইত্যাদি) কিউ বা লোড করার ফাংশন কলিং প্লেব্যাক রেট1
এ রিসেট করবে।
এই ফাংশনটি কল করা গ্যারান্টি দেয় না যে প্লেব্যাকের হার আসলেই পরিবর্তিত হবে৷ যাইহোক, যদি প্লেব্যাক রেট পরিবর্তিত হয়, তাহলেonPlaybackRateChange
ইভেন্টটি ফায়ার হবে এবং আপনার কোডটি ইভেন্টে সাড়া দেওয়া উচিত নয় বরং এটিকেsetPlaybackRate
ফাংশন বলে।
getAvailablePlaybackRates
পদ্ধতিটি বর্তমানে প্লেব্যাক করা ভিডিওর সম্ভাব্য প্লেব্যাকের হার ফিরিয়ে দেবে। যাইহোক, যদি আপনিsuggestedRate
প্যারামিটারটিকে একটি অ-সমর্থিত পূর্ণসংখ্যা বা ফ্লোট মান সেট করেন, প্লেয়ার সেই মানটিকে1
এর দিক থেকে নিকটতম সমর্থিত মানের দিকে বৃত্তাকার করবে।
-
player. getAvailablePlaybackRates ():Array
- এই ফাংশনটি প্লেব্যাক রেটগুলির সেট প্রদান করে যেখানে বর্তমান ভিডিও উপলব্ধ। ডিফল্ট মান হল
1
, যা নির্দেশ করে যে ভিডিওটি স্বাভাবিক গতিতে চলছে৷
ফাংশনটি ধীর থেকে দ্রুততম প্লেব্যাক গতিতে অর্ডার করা সংখ্যার একটি অ্যারে প্রদান করে। প্লেয়ার পরিবর্তনশীল প্লেব্যাক গতি সমর্থন না করলেও, অ্যারেতে সর্বদা কমপক্ষে একটি মান (1
) থাকা উচিত।
প্লেলিস্টের জন্য প্লেব্যাক আচরণ সেট করা
-
player. setLoop (loopPlaylists:Boolean):Void
এই ফাংশনটি নির্দেশ করে যে ভিডিও প্লেয়ারটি ক্রমাগত একটি প্লেলিস্ট চালাবে বা প্লেলিস্টের শেষ ভিডিওটি শেষ হওয়ার পরে এটি চালানো বন্ধ করা উচিত কিনা। ডিফল্ট আচরণ হল যে প্লেলিস্ট লুপ হয় না।
আপনি একটি ভিন্ন প্লেলিস্ট লোড করলে বা কিউ করলেও এই সেটিংটি টিকে থাকবে, যার মানে হল যে আপনি যদি একটি প্লেলিস্ট লোড করেন,
setLoop
ফাংশনটিকেtrue
এর মান সহ কল করুন এবং তারপরে একটি দ্বিতীয় প্লেলিস্ট লোড করুন, দ্বিতীয় প্লেলিস্টটিও লুপ হবে৷প্রয়োজনীয়
loopPlaylists
প্যারামিটার লুপিং আচরণ সনাক্ত করে।যদি পরামিতি মান
true
হয়, তাহলে ভিডিও প্লেয়ার ক্রমাগত প্লেলিস্ট চালাবে। একটি প্লেলিস্টে শেষ ভিডিওটি প্লে করার পরে, ভিডিও প্লেয়ারটি প্লেলিস্টের শুরুতে ফিরে যাবে এবং এটি আবার প্লে করবে।যদি প্যারামিটার মান
false
হয়, তাহলে ভিডিও প্লেয়ার একটি প্লেলিস্টে শেষ ভিডিওটি প্লে করার পরে প্লেব্যাকগুলি শেষ হবে৷
-
player. setShuffle (shufflePlaylist:Boolean):Void
এই ফাংশনটি নির্দেশ করে যে একটি প্লেলিস্টের ভিডিওগুলিকে এলোমেলো করা উচিত যাতে সেগুলি প্লেলিস্ট নির্মাতার দ্বারা মনোনীত একটি থেকে ভিন্ন ক্রমে প্লে হয়৷ আপনি যদি একটি প্লেলিস্ট ইতিমধ্যেই বাজানো শুরু করার পরে এটিকে এলোমেলো করেন, তাহলে যে ভিডিওটি প্লে হচ্ছে সেটি চলতে থাকাকালীন তালিকাটি পুনরায় সাজানো হবে৷ পরবর্তী ভিডিও যেটি প্লে হবে তা পুনরায় সাজানো তালিকার উপর ভিত্তি করে নির্বাচন করা হবে।
আপনি যদি একটি ভিন্ন প্লেলিস্ট লোড করেন বা কিউ করেন তাহলে এই সেটিংটি টিকে থাকবে না, যার মানে হল আপনি যদি একটি প্লেলিস্ট লোড করেন,
setShuffle
ফাংশনটি কল করেন এবং তারপরে একটি দ্বিতীয় প্লেলিস্ট লোড করেন, তাহলে দ্বিতীয় প্লেলিস্টটি এলোমেলো করা হবে না৷প্রয়োজনীয়
shufflePlaylist
প্যারামিটারটি নির্দেশ করে যে YouTube প্লেলিস্ট এলোমেলো করবে কিনা।যদি প্যারামিটার মান
true
হয়, তাহলে YouTube প্লেলিস্টের ক্রম পরিবর্তন করবে। যদি আপনি ফাংশনটিকে এমন একটি প্লেলিস্ট শাফেল করার নির্দেশ দেন যা ইতিমধ্যেই শাফেল করা হয়েছে, তাহলে YouTube আবার অর্ডারটি এলোমেলো করবে৷যদি প্যারামিটারের মান
false
হয়, তাহলে YouTube প্লেলিস্টের ক্রমটিকে তার আসল ক্রমে পরিবর্তন করবে৷
প্লেব্যাক অবস্থা
-
player. getVideoLoadedFraction ():Float
-
0
এবং1
এর মধ্যে একটি সংখ্যা প্রদান করে যা ভিডিওটির শতাংশ নির্দিষ্ট করে যা প্লেয়ারটি বাফার হিসাবে দেখায়৷ এই পদ্ধতিটি এখন-বঞ্চিতgetVideoBytesLoaded
এবংgetVideoBytesTotal
পদ্ধতির চেয়ে আরও নির্ভরযোগ্য সংখ্যা প্রদান করে।
-
player.getPlayerState():Number
- খেলোয়াড়ের অবস্থা ফেরত দেয়। সম্ভাব্য মান হল:
-
-1
- চালু করা হয়নি -
0
- শেষ -
1
- খেলা -
2
- বিরতি দেওয়া হয়েছে -
3
- বাফারিং -
5
- ভিডিও cued
-
-
player. getCurrentTime ():Number
- ভিডিও চালানো শুরু হওয়ার পর থেকে সেকেন্ডে অতিবাহিত সময় ফেরত দেয়।
-
player. getVideoStartBytes ():Number
- 31 অক্টোবর, 2012 থেকে অবচয় । (এই পদ্ধতিটি এখন সর্বদা
0
এর মান প্রদান করে।) উদাহরণ দৃশ্যকল্প: ব্যবহারকারী এমন একটি বিন্দুর দিকে এগিয়ে যায় যা এখনও লোড হয়নি, এবং প্লেয়ার ভিডিওটির একটি অংশ চালানোর জন্য একটি নতুন অনুরোধ করে যা এখনও লোড হয়নি।
-
player. getVideoBytesLoaded ():Number
- 18 জুলাই, 2012-এ অবমুক্ত করা হয়েছে৷ পরিবর্তে, বাফার হওয়া ভিডিওটির শতাংশ নির্ধারণ করতে
getVideoLoadedFraction
পদ্ধতি ব্যবহার করুন৷
এই পদ্ধতিটি0
এবং1000
মধ্যে একটি মান প্রদান করে যা লোড করা ভিডিওর পরিমাণ আনুমানিক করে।getVideoBytesLoaded
মানটিকেgetVideoBytesTotal
মান দিয়ে ভাগ করে লোড করা ভিডিওটির ভগ্নাংশ আপনি গণনা করতে পারেন।
-
player. getVideoBytesTotal ():Number
- 18 জুলাই, 2012-এ অবমুক্ত করা হয়েছে৷ পরিবর্তে, বাফার হওয়া ভিডিওটির শতাংশ নির্ধারণ করতে
getVideoLoadedFraction
পদ্ধতি ব্যবহার করুন৷
বর্তমানে লোড হওয়া/প্লে করা ভিডিওর বাইটের আকার বা ভিডিওর আকারের আনুমানিক আকার প্রদান করে।
এই পদ্ধতিটি সর্বদা1000
এর মান প্রদান করে।getVideoBytesLoaded
মানটিকেgetVideoBytesTotal
মান দিয়ে ভাগ করে লোড করা ভিডিওটির ভগ্নাংশ আপনি গণনা করতে পারেন।
ভিডিও তথ্য পুনরুদ্ধার করা হচ্ছে
-
player. getDuration ():Number
- বর্তমানে প্লে করা ভিডিওর সেকেন্ডের মধ্যে সময়কাল ফেরত দেয়। নোট করুন যে ভিডিওর মেটাডেটা লোড না হওয়া পর্যন্ত
getDuration()
0
রিটার্ন করবে, যা সাধারণত ভিডিও প্লে শুরু হওয়ার পরই ঘটে।
যদি বর্তমানে প্লে করা ভিডিওটি একটি লাইভ ইভেন্ট হয়,getDuration()
ফাংশন লাইভ ভিডিও স্ট্রিম শুরু হওয়ার পর থেকে অতিবাহিত সময় ফিরিয়ে দেবে। বিশেষত, এটি রিসেট বা বাধা ছাড়াই ভিডিওটি স্ট্রিম করা সময়ের পরিমাণ। উপরন্তু, এই সময়কাল সাধারণত ইভেন্টের প্রকৃত সময়ের চেয়ে বেশি হয় কারণ ইভেন্টের শুরুর সময়ের আগে স্ট্রিমিং শুরু হতে পারে।
-
player. getVideoUrl ():String
- বর্তমানে লোড করা/চালানো ভিডিওর জন্য YouTube.com URL প্রদান করে।
-
player. getVideoEmbedCode ():String
- বর্তমানে লোড হওয়া/প্লে করা ভিডিওর জন্য এম্বেড কোড প্রদান করে।
প্লেলিস্ট তথ্য পুনরুদ্ধার করা হচ্ছে
-
player. getPlaylist ():Array
- এই ফাংশনটি প্লেলিস্টে ভিডিও আইডিগুলির একটি অ্যারে প্রদান করে যেমন সেগুলি বর্তমানে অর্ডার করা হয়েছে৷ ডিফল্টরূপে, এই ফাংশনটি প্লেলিস্টের মালিকের দ্বারা মনোনীত ক্রমে ভিডিও আইডি ফিরিয়ে দেবে৷ যাইহোক, যদি আপনি প্লেলিস্টের ক্রম এলোমেলো করার জন্য
setShuffle
ফাংশনকে কল করেন, তাহলেgetPlaylist()
ফাংশনের রিটার্ন মান পরিবর্তন করা ক্রমকে প্রতিফলিত করবে।
-
player. getPlaylistIndex ():Number
- এই ফাংশনটি বর্তমানে প্লেলিস্ট ভিডিওর সূচী প্রদান করে।
আপনি যদি প্লেলিস্টটি বদলে না থাকেন তবে রিটার্ন মানটি প্লেলিস্ট স্রষ্টা ভিডিওটি যেখানে রেখেছিল সেই অবস্থানটি সনাক্ত করবে। রিটার্ন মানটি একটি শূন্য-ভিত্তিক সূচক ব্যবহার করে, সুতরাং
0
এর একটি মান প্লেলিস্টে প্রথম ভিডিওটি সনাক্ত করে।আপনি যদি প্লেলিস্টটি বদল করে থাকেন তবে রিটার্ন মানটি বদলে যাওয়া প্লেলিস্টের মধ্যে ভিডিওর ক্রমটি সনাক্ত করবে।
কোনও ইভেন্ট শ্রোতা যুক্ত বা অপসারণ
-
player. addEventListener (event:String, listener:String):Void
- নির্দিষ্ট
event
জন্য শ্রোতার ফাংশন যুক্ত করে। নীচের ইভেন্টগুলি বিভাগটি প্লেয়ারকে গুলি চালাতে পারে এমন বিভিন্ন ঘটনা চিহ্নিত করে। শ্রোতা এমন একটি স্ট্রিং যা ফাংশনটি নির্দিষ্ট করে যা নির্দিষ্ট ইভেন্টটি আগুন লাগলে কার্যকর হবে।
-
player. removeEventListener (event:String, listener:String):Void
- নির্দিষ্ট
event
জন্য শ্রোতার ফাংশন সরিয়ে দেয়।listener
এমন একটি স্ট্রিং যা ফাংশনটি চিহ্নিত করে যা নির্দিষ্ট ইভেন্টটি আগুন লাগলে আর কার্যকর হবে না।
ডিওএম নোড অ্যাক্সেস এবং সংশোধন করা
-
player. getIframe ():Object
- এই পদ্ধতিটি এম্বেডড
<iframe>
এর জন্য ডোম নোডটি ফেরত দেয়।
-
player. destroy ():Void
- প্লেয়ারযুক্ত
<iframe>
সরিয়ে দেয়।
ঘটনা
এম্বেড থাকা প্লেয়ারে আপনার পরিবর্তনের প্রয়োগকে অবহিত করতে এপিআই ইভেন্টগুলিকে আগুন দেয়। পূর্ববর্তী বিভাগে উল্লিখিত হিসাবে, আপনি YT.Player
অবজেক্টটি তৈরি করার সময় কোনও ইভেন্ট শ্রোতা যুক্ত করে ইভেন্টগুলিতে সাবস্ক্রাইব করতে পারেন এবং আপনি addEventListener
ফাংশনটিও ব্যবহার করতে পারেন।
এপিআই সেই প্রতিটি ফাংশনগুলির একমাত্র যুক্তি হিসাবে কোনও ইভেন্ট অবজেক্টটি পাস করবে। ইভেন্ট অবজেক্টের নিম্নলিখিত বৈশিষ্ট্য রয়েছে:
- ইভেন্টের
target
ভিডিও প্লেয়ারটিকে চিহ্নিত করে যা ইভেন্টের সাথে মিলে যায়। - ইভেন্টের
data
ইভেন্টের সাথে প্রাসঙ্গিক একটি মান নির্দিষ্ট করে। নোট করুন যেonReady
এবংonAutoplayBlocked
ইভেন্টগুলি কোনওdata
সম্পত্তি নির্দিষ্ট করে না।
নিম্নলিখিত তালিকাটি এপিআই আগুনের ঘটনাগুলি সংজ্ঞায়িত করে:
-
onReady
- এই ইভেন্টটি আগুন লাগে যখনই কোনও খেলোয়াড় লোডিং শেষ করে এবং এপিআই কলগুলি গ্রহণ শুরু করতে প্রস্তুত। প্লেয়ার প্রস্তুত হওয়ার সাথে সাথে আপনি যদি ভিডিওটি বাজানো বা ভিডিও সম্পর্কে তথ্য প্রদর্শন করার মতো নির্দিষ্ট ক্রিয়াকলাপগুলি স্বয়ংক্রিয়ভাবে সম্পাদন করতে চান তবে আপনার অ্যাপ্লিকেশনটি এই ফাংশনটি বাস্তবায়ন করা উচিত।
নীচের উদাহরণটি এই ইভেন্টটি পরিচালনা করার জন্য একটি নমুনা ফাংশন দেখায়। এপিআই ফাংশনে পাস করা ইভেন্ট অবজেক্টটিতে একটিtarget
সম্পত্তি রয়েছে, যা প্লেয়ারকে চিহ্নিত করে। ফাংশনটি বর্তমানে লোড হওয়া ভিডিওর জন্য এম্বেড কোডটি পুনরুদ্ধার করে, ভিডিওটি বাজাতে শুরু করে এবংembed-code
id
মান রয়েছে এমন পৃষ্ঠা উপাদানটিতে এম্বেড কোডটি প্রদর্শন করে।function onPlayerReady(event) { var embedCode = event.target.getVideoEmbedCode(); event.target.playVideo(); if (document.getElementById('embed-code')) { document.getElementById('embed-code').innerHTML = embedCode; } }
-
onStateChange
- এই ইভেন্টটি যখনই প্লেয়ারের রাষ্ট্র পরিবর্তন করে। ইভেন্ট অবজেক্টের
data
সম্পত্তি যা আপনার ইভেন্ট শ্রোতার ফাংশনে এপিআই পাস করে তা একটি পূর্ণসংখ্যা নির্দিষ্ট করবে যা নতুন প্লেয়ার অবস্থার সাথে মিলে যায়। সম্ভাব্য মান হল:-
-1
(আনস্টার্টেড) -
0
(শেষ) -
1
(বাজানো) -
2
(বিরতি) -
3
(বাফারিং) -
5
(ভিডিও উদ্ধৃত)।
unstarted
(-1
) ইভেন্টটি সম্প্রচার করবে। যখন কোনও ভিডিও উদ্ধৃত হয় এবং খেলতে প্রস্তুত হয়, তখন প্লেয়ার একটিvideo cued
(5
) ইভেন্টটি সম্প্রচার করবে। আপনার কোডে, আপনি পূর্ণসংখ্যার মানগুলি নির্দিষ্ট করতে পারেন বা আপনি নিম্নলিখিত নেমস্পেসড ভেরিয়েবলগুলির একটি ব্যবহার করতে পারেন:-
YT.PlayerState.ENDED
-
YT.PlayerState.PLAYING
-
YT.PlayerState.PAUSED
-
YT.PlayerState.BUFFERING
-
YT.PlayerState.CUED
-
-
onPlaybackQualityChange
- এই ইভেন্টটি যখনই ভিডিও প্লেব্যাকের মানের পরিবর্তন হয়। এটি দর্শকের প্লেব্যাক পরিবেশে পরিবর্তনের ইঙ্গিত দিতে পারে। প্লেব্যাকের অবস্থাকে প্রভাবিত করে এমন কারণগুলি সম্পর্কে আরও তথ্যের জন্য ইউটিউব সহায়তা কেন্দ্রটি দেখুন বা এটি ঘটনাকে আগুনের কারণ হতে পারে।
ইভেন্ট অবজেক্টেরdata
সম্পত্তি মান যা এপিআই ইভেন্ট শ্রোতার ফাংশনে পাস করে এমন একটি স্ট্রিং হবে যা নতুন প্লেব্যাকের গুণমান চিহ্নিত করে। সম্ভাব্য মান হল:-
small
-
medium
-
large
-
hd720
-
hd1080
-
highres
-
-
onPlaybackRateChange
- এই ইভেন্টটি যখনই ভিডিও প্লেব্যাক রেট পরিবর্তন করে তখন আগুন লাগে। উদাহরণস্বরূপ, আপনি যদি
setPlaybackRate(suggestedRate)
ফাংশনটি কল করেন তবে প্লেব্যাকের হার আসলে পরিবর্তিত হলে এই ইভেন্টটি গুলি চালাবে। আপনার অ্যাপ্লিকেশনটিতে ইভেন্টটির প্রতিক্রিয়া জানানো উচিত এবং এটি ধরে নেওয়া উচিত নয় যেsetPlaybackRate(suggestedRate)
ফাংশনটি বলা হয় তখন প্লেব্যাক রেট স্বয়ংক্রিয়ভাবে পরিবর্তিত হবে। একইভাবে, আপনার কোডটি ধরে নেওয়া উচিত নয় যে ভিডিও প্লেব্যাকের হার কেবলsetPlaybackRate
একটি সুস্পষ্ট কলের ফলস্বরূপ পরিবর্তিত হবে।
ইভেন্ট অবজেক্টেরdata
সম্পত্তি মান যা এপিআই ইভেন্ট শ্রোতার ফাংশনে পাস করে এমন একটি সংখ্যা হবে যা নতুন প্লেব্যাকের হার চিহ্নিত করে।getAvailablePlaybackRates
পদ্ধতিটি বর্তমানে উদ্ধৃত বা প্লে ভিডিওর জন্য বৈধ প্লেব্যাক হারের একটি তালিকা ফেরত দেয়।
-
onError
- প্লেয়ারে কোনও ত্রুটি দেখা দিলে এই ইভেন্টটি আগুন লাগে। এপিআই ইভেন্ট শ্রোতার ফাংশনে কোনও
event
অবজেক্টটি পাস করবে। এই অবজেক্টেরdata
সম্পত্তি একটি পূর্ণসংখ্যা নির্দিষ্ট করবে যা ঘটেছিল ত্রুটির ধরণ চিহ্নিত করে। সম্ভাব্য মান হল:-
2
- অনুরোধে একটি অবৈধ প্যারামিটার মান রয়েছে। উদাহরণস্বরূপ, এই ত্রুটিটি ঘটে যদি আপনি কোনও ভিডিও আইডি নির্দিষ্ট করেন যার মধ্যে 11 টি অক্ষর নেই, বা ভিডিও আইডিতে যদি অবৈধ অক্ষর থাকে যেমন বিস্ময়কর পয়েন্ট বা তারকাচিহ্নগুলি থাকে। -
5
- অনুরোধ করা সামগ্রীটি এইচটিএমএল 5 প্লেয়ারে প্লে করা যাবে না বা এইচটিএমএল 5 প্লেয়ারের সাথে সম্পর্কিত অন্য কোনও ত্রুটি ঘটেছে। -
100
- অনুরোধ করা ভিডিওটি পাওয়া যায় নি। এই ত্রুটিটি ঘটে যখন কোনও ভিডিও সরানো হয়েছে (কোনও কারণে) বা ব্যক্তিগত হিসাবে চিহ্নিত করা হয়েছে। -
101
- অনুরোধ করা ভিডিওর মালিক এটি এম্বেড থাকা খেলোয়াড়দের মধ্যে খেলতে দেয় না। -
150
- এই ত্রুটিটি101
এর মতোই। ছদ্মবেশে এটি কেবল একটি101
ত্রুটি!
-
-
onApiChange
- প্লেয়ারটি উন্মুক্ত এপিআই পদ্ধতি সহ একটি মডিউল লোড করেছে (বা আনলোড করা হয়েছে) তা নির্দেশ করার জন্য এই ইভেন্টটি বরখাস্ত করা হয়েছে। আপনার অ্যাপ্লিকেশনটি এই ইভেন্টটির জন্য শুনতে পারে এবং তারপরে সম্প্রতি লোড হওয়া মডিউলটির জন্য কোন বিকল্পগুলি উন্মুক্ত করা হয়েছে তা নির্ধারণ করতে প্লেয়ারকে পোল করতে পারে। আপনার অ্যাপ্লিকেশনটি তখন সেই বিকল্পগুলির জন্য বিদ্যমান সেটিংস পুনরুদ্ধার বা আপডেট করতে পারে।
নিম্নলিখিত কমান্ডটি মডিউল নামগুলির একটি অ্যারে পুনরুদ্ধার করে যার জন্য আপনি প্লেয়ার বিকল্পগুলি সেট করতে পারেন:
player.getOptions();
বর্তমানে, কেবলমাত্র মডিউল যা আপনি বিকল্পগুলি সেট করতে পারেন তা হ'লcaptions
মডিউল, যা প্লেয়ারে বন্ধ ক্যাপশনিং পরিচালনা করে। একটিonApiChange
ইভেন্ট পাওয়ার পরে, আপনার অ্যাপ্লিকেশনটিcaptions
মডিউলটির জন্য কোন বিকল্পগুলি সেট করা যেতে পারে তা নির্ধারণ করতে নিম্নলিখিত কমান্ডটি ব্যবহার করতে পারে:
player.getOptions('captions');
এই কমান্ডটি দিয়ে প্লেয়ারকে পোলিং করে আপনি নিশ্চিত করতে পারেন যে আপনি যে বিকল্পগুলি অ্যাক্সেস করতে চান তা প্রকৃতপক্ষে অ্যাক্সেসযোগ্য। নিম্নলিখিত কমান্ডগুলি মডিউল বিকল্পগুলি পুনরুদ্ধার এবং আপডেট করুন:
Retrieving an option: player.getOption(module, option); Setting an option player.setOption(module, option, value);
নীচের টেবিলটি এপিআই সমর্থন করে এমন বিকল্পগুলি তালিকাভুক্ত করে:মডিউল অপশন বর্ণনা captions fontSize এই বিকল্পটি প্লেয়ারে প্রদর্শিত ক্যাপশনগুলির ফন্টের আকার সামঞ্জস্য করে।
বৈধ মানগুলি-1
,0
,1
,2
এবং3
হয়। ডিফল্ট আকার0
, এবং ক্ষুদ্রতম আকারটি-1
। এই বিকল্পটি-1
একটি পূর্ণসংখ্যার দিকে সেট করা সবচেয়ে ছোট ক্যাপশন আকারটি প্রদর্শন করতে পারে, যখন এই বিকল্পটি3
এর উপরে একটি পূর্ণসংখ্যায় সেট করা বৃহত্তম ক্যাপশন আকার প্রদর্শন করতে পারে।captions reload এই বিকল্পটি যে ভিডিওটি খেলছে তার জন্য বন্ধ ক্যাপশন ডেটা পুনরায় লোড করে। আপনি যদি বিকল্পের মানটি পুনরুদ্ধার করেন তবে মানটি null
হবে। বদ্ধ ক্যাপশন ডেটা পুনরায় লোড করতে মানটিtrue
সেট করুন।
-
onAutoplayBlocked
- এই ইভেন্টটি যে কোনও সময় ব্রাউজারটি অটোপ্লে বা স্ক্রিপ্টযুক্ত ভিডিও প্লেব্যাক বৈশিষ্ট্যগুলি ব্লক করে, সম্মিলিতভাবে "অটোপ্লে" হিসাবে উল্লেখ করা হয়। এর মধ্যে নিম্নলিখিত প্লেয়ার এপিআইগুলির সাথে প্লেব্যাক চেষ্টা করা অন্তর্ভুক্ত রয়েছে:
-
autoplay
প্যারামিটার -
loadPlaylist
ফাংশন -
loadVideoById
ফাংশন -
loadVideoByUrl
ফাংশন -
playVideo
ফাংশন
সম্পূর্ণ তথ্যের জন্য, ব্রাউজার-নির্দিষ্ট নীতিগুলি ( অ্যাপল সাফারি / ওয়েবকিট , গুগল ক্রোম , মোজিলা ফায়ারফক্স ) এবং মোজিলার অটোপ্লে গাইড দেখুন। -
উদাহরণ
YT.Player
অবজেক্ট তৈরি করা
উদাহরণ 1: বিদ্যমান <আইফ্রেম> সহ এপিআই ব্যবহার করুন
এই উদাহরণে, পৃষ্ঠায় একটি
<iframe>
উপাদান ইতিমধ্যে প্লেয়ারকে সংজ্ঞায়িত করে যার সাথে এপিআই ব্যবহৃত হবে। মনে রাখবেন যে উভয়ই প্লেয়ারেরsrc
ইউআরএল অবশ্যইenablejsapi
প্যারামিটারটি1
এ সেট করতে হবে বা<iframe>
এলিমেন্টেরenablejsapi
বৈশিষ্ট্যটি অবশ্যই সেট করতে হবেtrue
প্লেয়ার প্রস্তুত থাকাকালীন
onPlayerReady
ফাংশনটি প্লেয়ারের চারপাশের সীমান্তের রঙকে কমলাতে পরিবর্তন করে।onPlayerStateChange
ফাংশনটি তারপরে বর্তমান প্লেয়ারের স্থিতির উপর ভিত্তি করে প্লেয়ারের চারপাশের সীমান্তের রঙ পরিবর্তন করে। উদাহরণস্বরূপ, রঙটি সবুজ হয় যখন প্লেয়ারটি খেলছে, যখন লাল হয়ে গেছে তখন লাল, বাফার করার সময় নীল এবং আরও অনেক কিছু।এই উদাহরণটি নিম্নলিখিত কোডটি ব্যবহার করে:
<iframe id="existing-iframe-example" width="640" height="360" src="https://www.youtube.com/embed/M7lc1UVf-VE?enablejsapi=1" frameborder="0" style="border: solid 4px #37474F" ></iframe> <script type="text/javascript"> var tag = document.createElement('script'); tag.id = 'iframe-demo'; tag.src = 'https://www.youtube.com/iframe_api'; var firstScriptTag = document.getElementsByTagName('script')[0]; firstScriptTag.parentNode.insertBefore(tag, firstScriptTag); var player; function onYouTubeIframeAPIReady() { player = new YT.Player('existing-iframe-example', { events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange } }); } function onPlayerReady(event) { document.getElementById('existing-iframe-example').style.borderColor = '#FF6D00'; } function changeBorderColor(playerStatus) { var color; if (playerStatus == -1) { color = "#37474F"; // unstarted = gray } else if (playerStatus == 0) { color = "#FFFF00"; // ended = yellow } else if (playerStatus == 1) { color = "#33691E"; // playing = green } else if (playerStatus == 2) { color = "#DD2C00"; // paused = red } else if (playerStatus == 3) { color = "#AA00FF"; // buffering = purple } else if (playerStatus == 5) { color = "#FF6DOO"; // video cued = orange } if (color) { document.getElementById('existing-iframe-example').style.borderColor = color; } } function onPlayerStateChange(event) { changeBorderColor(event.data); } </script>
উদাহরণ 2: জোরে প্লেব্যাক
এই উদাহরণটি 720px ভিডিও প্লেয়ার দ্বারা একটি 1280px তৈরি করে।
onReady
ইভেন্টের জন্য ইভেন্ট শ্রোতা তারপরে ভলিউমটি সর্বোচ্চ সেটিংয়ের সাথে সামঞ্জস্য করতেsetVolume
ফাংশনটিকে কল করে।function onYouTubeIframeAPIReady() { var player; player = new YT.Player('player', { width: 1280, height: 720, videoId: 'M7lc1UVf-VE', events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange, 'onError': onPlayerError } }); } function onPlayerReady(event) { event.target.setVolume(100); event.target.playVideo(); }
উদাহরণ 3: এই উদাহরণটি ভিডিওটি যখন লোড হয় তখন স্বয়ংক্রিয়ভাবে খেলতে এবং ভিডিও প্লেয়ারের নিয়ন্ত্রণগুলি আড়াল করার জন্য প্লেয়ার পরামিতিগুলি সেট করে। এটি এপিআই সম্প্রচার করে এমন বেশ কয়েকটি ইভেন্টের জন্য ইভেন্ট শ্রোতাদেরও যুক্ত করে।
function onYouTubeIframeAPIReady() { var player; player = new YT.Player('player', { videoId: 'M7lc1UVf-VE', playerVars: { 'autoplay': 1, 'controls': 0 }, events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange, 'onError': onPlayerError } }); }
360 ° ভিডিও নিয়ন্ত্রণ করা
এই উদাহরণটি নিম্নলিখিত কোডটি ব্যবহার করে:
<style> .current-values { color: #666; font-size: 12px; } </style> <!-- The player is inserted in the following div element --> <div id="spherical-video-player"></div> <!-- Display spherical property values and enable user to update them. --> <table style="border: 0; width: 640px;"> <tr style="background: #fff;"> <td> <label for="yaw-property">yaw: </label> <input type="text" id="yaw-property" style="width: 80px"><br> <div id="yaw-current-value" class="current-values"> </div> </td> <td> <label for="pitch-property">pitch: </label> <input type="text" id="pitch-property" style="width: 80px"><br> <div id="pitch-current-value" class="current-values"> </div> </td> <td> <label for="roll-property">roll: </label> <input type="text" id="roll-property" style="width: 80px"><br> <div id="roll-current-value" class="current-values"> </div> </td> <td> <label for="fov-property">fov: </label> <input type="text" id="fov-property" style="width: 80px"><br> <div id="fov-current-value" class="current-values"> </div> </td> <td style="vertical-align: bottom;"> <button id="spherical-properties-button">Update properties</button> </td> </tr> </table> <script type="text/javascript"> var tag = document.createElement('script'); tag.id = 'iframe-demo'; tag.src = 'https://www.youtube.com/iframe_api'; var firstScriptTag = document.getElementsByTagName('script')[0]; firstScriptTag.parentNode.insertBefore(tag, firstScriptTag); var PROPERTIES = ['yaw', 'pitch', 'roll', 'fov']; var updateButton = document.getElementById('spherical-properties-button'); // Create the YouTube Player. var ytplayer; function onYouTubeIframeAPIReady() { ytplayer = new YT.Player('spherical-video-player', { height: '360', width: '640', videoId: 'FAtdv94yzp4', }); } // Don't display current spherical settings because there aren't any. function hideCurrentSettings() { for (var p = 0; p < PROPERTIES.length; p++) { document.getElementById(PROPERTIES[p] + '-current-value').innerHTML = ''; } } // Retrieve current spherical property values from the API and display them. function updateSetting() { if (!ytplayer || !ytplayer.getSphericalProperties) { hideCurrentSettings(); } else { let newSettings = ytplayer.getSphericalProperties(); if (Object.keys(newSettings).length === 0) { hideCurrentSettings(); } else { for (var p = 0; p < PROPERTIES.length; p++) { if (newSettings.hasOwnProperty(PROPERTIES[p])) { currentValueNode = document.getElementById(PROPERTIES[p] + '-current-value'); currentValueNode.innerHTML = ('current: ' + newSettings[PROPERTIES[p]].toFixed(4)); } } } } requestAnimationFrame(updateSetting); } updateSetting(); // Call the API to update spherical property values. updateButton.onclick = function() { var sphericalProperties = {}; for (var p = 0; p < PROPERTIES.length; p++) { var propertyInput = document.getElementById(PROPERTIES[p] + '-property'); sphericalProperties[PROPERTIES[p]] = parseFloat(propertyInput.value); } ytplayer.setSphericalProperties(sphericalProperties); } </script>
অ্যান্ড্রয়েড ওয়েবভিউ মিডিয়া ইন্টিগ্রিটি এপিআই ইন্টিগ্রেশন
ইউটিউব এম্বেডিং অ্যাপের সত্যতা যাচাই করতে অ্যান্ড্রয়েড অ্যাপ্লিকেশনগুলিতে ইউটিউব প্লেয়ার এম্বেড সহ এম্বেডড মিডিয়া প্লেয়ারগুলি সক্ষম করতে অ্যান্ড্রয়েড ওয়েবভিউ মিডিয়া ইন্টিগ্রিটি এপিআইকে প্রসারিত করেছে। এই পরিবর্তনের সাথে, এম্বেডিং অ্যাপ্লিকেশনগুলি স্বয়ংক্রিয়ভাবে ইউটিউবে একটি সত্যায়িত অ্যাপ্লিকেশন আইডি প্রেরণ করে। এই এপিআই ব্যবহারের মাধ্যমে সংগৃহীত ডেটা হ'ল অ্যাপ মেটাডেটা (প্যাকেজের নাম, সংস্করণ নম্বর, এবং স্বাক্ষর শংসাপত্র) এবং গুগল প্লে পরিষেবাদি দ্বারা উত্পাদিত একটি ডিভাইস প্রমাণীকরণ টোকেন।
অ্যাপ্লিকেশন এবং ডিভাইস অখণ্ডতা যাচাই করতে ডেটা ব্যবহৃত হয়। এটি এনক্রিপ্ট করা হয়, তৃতীয় পক্ষের সাথে ভাগ করা হয় না এবং একটি নির্দিষ্ট ধরে রাখার সময়কালের পরে মুছে ফেলা হয়। অ্যাপ্লিকেশন বিকাশকারীরা তাদের অ্যাপ্লিকেশন পরিচয়টি ওয়েবভিউ মিডিয়া ইন্টিগ্রিটি এপিআইতে কনফিগার করতে পারে। কনফিগারেশন একটি অপ্ট-আউট বিকল্প সমর্থন করে।
পরিবর্ধন ও পরিবর্তন তালিকা
June 24, 2024
The documentation has been updated to note that YouTube has extended the Android WebView Media Integrity API to enable embedded media players, including YouTube player embeds in Android applications, to verify the embedding app's authenticity. With this change, embedding apps automatically send an attested app ID to YouTube.
November 20, 2023
The new onAutoplayBlocked
event API is now available.
This event notifies your application if the browser blocks autoplay or scripted playback.
Verification of autoplay success or failure is an
established paradigm
for HTMLMediaElements, and the onAutoplayBlocked
event now provides similar
functionality for the IFrame Player API.
April 27, 2021
The Getting Started and Loading a Video Player sections have been updated to include examples of using a playerVars
object to customize the player.
October 13, 2020
Note: This is a deprecation announcement for the embedded player
functionality that lets you configure the player to load search results. This announcement affects
the IFrame Player API's queueing functions for lists ,
cuePlaylist
and
loadPlaylist
.
This change will become effective on or after cuePlaylist
or loadPlaylist
functions that set the listType
property to search
will generate a 4xx
response code, such as
404
( Not Found
) or 410
( Gone
). This change
also affects the list
property for those functions as that property no longer
supports the ability to specify a search query.
As an alternative, you can use the YouTube Data API's
search.list
method to retrieve search
results and then load selected videos in the player.
October 24, 2019
The documentation has been updated to reflect the fact that the API no longer supports functions for setting or retrieving playback quality. As explained in this YouTube Help Center article , to give you the best viewing experience, YouTube adjusts the quality of your video stream based on your viewing conditions.
The changes explained below have been in effect for more than one year. This update merely aligns the documentation with current functionality:
- The
getPlaybackQuality
,setPlaybackQuality
, andgetAvailableQualityLevels
functions are no longer supported. In particular, calls tosetPlaybackQuality
will be no-op functions, meaning they will not actually have any impact on the viewer's playback experience. - The queueing functions for videos and playlists --
cueVideoById
,loadVideoById
, etc. -- no longer support thesuggestedQuality
argument. Similarly, if you call those functions using object syntax, thesuggestedQuality
field is no longer supported. IfsuggestedQuality
is specified, it will be ignored when the request is handled. It will not generate any warnings or errors. - The
onPlaybackQualityChange
event is still supported and might signal a change in the viewer's playback environment. See the Help Center article referenced above for more information about factors that affect playback conditions or that might cause the event to fire.
May 16, 2018
The API now supports features that allow users (or embedders) to control the viewing perspective for 360° videos :
- The
getSphericalProperties
function retrieves the current orientation for the video playback. The orientation includes the following data:- yaw - represents the horizontal angle of the view in degrees, which reflects the extent to which the user turns the view to face further left or right
- pitch - represents the vertical angle of the view in degrees, which reflects the extent to which the user adjusts the view to look up or down
- roll - represents the rotational angle (clockwise or counterclockwise) of the view in degrees.
- fov - represents the field-of-view of the view in degrees, which reflects the extent to which the user zooms in or out on the video.
- The
setSphericalProperties
function modifies the view to match the submitted property values. In addition to the orientation values described above, this function supports a Boolean field that indicates whether the IFrame embed should respond toDeviceOrientationEvents
on supported mobile devices.
This example demonstrates and lets you test these new features.
June 19, 2017
This update contains the following changes:
-
Documentation for the YouTube Flash Player API and YouTube JavaScript Player API has been removed and redirected to this document. The deprecation announcement for the Flash and JavaScript players was made on January 27, 2015. If you haven't done so already, please migrate your applications to use IFrame embeds and the IFrame Player API.
August 11, 2016
This update contains the following changes:
-
The newly published YouTube API Services Terms of Service ("the Updated Terms"), discussed in detail on the YouTube Engineering and Developers Blog , provides a rich set of updates to the current Terms of Service. In addition to the Updated Terms , which will go into effect as of February 10, 2017, this update includes several supporting documents to help explain the policies that developers must follow.
The full set of new documents is described in the revision history for the Updated Terms . In addition, future changes to the Updated Terms or to those supporting documents will also be explained in that revision history. You can subscribe to an RSS feed listing changes in that revision history from a link in that document.
June 29, 2016
This update contains the following changes:
-
The documentation has been corrected to note that the
onApiChange
method provides access to thecaptions
module and not thecc
module.
June 24, 2016
The Examples section has been updated to include an example that demonstrates how to use the API with an existing <iframe>
element.
January 6, 2016
The clearVideo
function has been deprecated and removed from the documentation. The function no longer has any effect in the YouTube player.
December 18, 2015
European Union (EU) laws require that certain disclosures must be given to and consents obtained from end users in the EU. Therefore, for end users in the European Union, you must comply with the EU User Consent Policy . We have added a notice of this requirement in our YouTube API Terms of Service .
April 28, 2014
This update contains the following changes:
-
The new removeEventListener function lets you remove a listener for a specified event.
March 25, 2014
This update contains the following changes:
-
The Requirements section has been updated to note that embedded players must have a viewport that is at least 200px by 200px. If a player displays controls, it must be large enough to fully display the controls without shrinking the viewport below the minimum size. We recommend 16:9 players be at least 480 pixels wide and 270 pixels tall.
July 23, 2013
This update contains the following changes:
-
The Overview now includes a video of a 2011 Google I/O presentation that discusses the iframe player.
October 31, 2012
This update contains the following changes:
-
The Queueing functions section has been updated to explain that you can use either argument syntax or object syntax to call all of those functions. Note that the API may support additional functionality in object syntax that the argument syntax does not support.
In addition, the descriptions and examples for each of the video queueing functions have been updated to reflect the newly added support for object syntax. (The API's playlist queueing functions already supported object syntax.)
-
When called using object syntax, each of the video queueing functions supports an
endSeconds
property, which accepts a float/integer and specifies the time when the video should stop playing whenplayVideo()
is called. -
The
getVideoStartBytes
method has been deprecated. The method now always returns a value of0
.
August 22, 2012
This update contains the following changes:
-
The example in the Loading a video player section that demonstrates how to manually create the
<iframe>
tag has been updated to include a closing</iframe>
tag since theonYouTubeIframeAPIReady
function is only called if the closing</iframe>
element is present.
August 6, 2012
This update contains the following changes:
-
The Operations section has been expanded to list all of the supported API functions rather than linking to the JavaScript Player API Reference for that list.
-
The API supports several new functions and one new event that can be used to control the video playback speed:
-
Functions
getAvailablePlaybackRates
– Retrieve the supported playback rates for the cued or playing video. Note that variable playback rates are currently only supported in the HTML5 player.getPlaybackRate
– Retrieve the playback rate for the cued or playing video.setPlaybackRate
– Set the playback rate for the cued or playing video.
-
Events
onPlaybackRateChange
– This event fires when the video's playback rate changes.
-
July 19, 2012
This update contains the following changes:
-
The new
getVideoLoadedFraction
method replaces the now-deprecatedgetVideoBytesLoaded
andgetVideoBytesTotal
methods. The new method returns the percentage of the video that the player shows as buffered. -
The
onError
event may now return an error code of5
, which indicates that the requested content cannot be played in an HTML5 player or another error related to the HTML5 player has occurred. -
The Requirements section has been updated to indicate that any web page using the IFrame API must also implement the
onYouTubeIframeAPIReady
function. Previously, the section indicated that the required function was namedonYouTubePlayerAPIReady
. Code samples throughout the document have also been updated to use the new name.Note: To ensure that this change does not break existing implementations, both names will work. If, for some reason, your page has an onYouTubeIframeAPIReady
function and anonYouTubePlayerAPIReady
function, both functions will be called, and theonYouTubeIframeAPIReady
function will be called first. -
The code sample in the Getting started section has been updated to reflect that the URL for the IFrame Player API code has changed to
http://www.youtube.com/iframe_api
. To ensure that this change does not affect existing implementations, the old URL (http://www.youtube.com/player_api
) will continue to work.
July 16, 2012
This update contains the following changes:
-
The Operations section now explains that the API supports the
setSize()
anddestroy()
methods. ThesetSize()
method sets the size in pixels of the<iframe>
that contains the player and thedestroy()
method removes the<iframe>
.
June 6, 2012
This update contains the following changes:
-
We have removed the
experimental
status from the IFrame Player API. -
The Loading a video player section has been updated to point out that when inserting the
<iframe>
element that will contain the YouTube player, the IFrame API replaces the element specified in the constructor for the YouTube player. This documentation change does not reflect a change in the API and is intended solely to clarify existing behavior.In addition, that section now notes that the insertion of the
<iframe>
element could affect the layout of your page if the element being replaced has a different display style than the inserted<iframe>
element. By default, an<iframe>
displays as aninline-block
element.
March 30, 2012
This update contains the following changes:
-
The Operations section has been updated to explain that the IFrame API supports a new method,
getIframe()
, which returns the DOM node for the IFrame embed.
March 26, 2012
This update contains the following changes:
-
The Requirements section has been updated to note the minimum player size.