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প্যারামিটার একটি float/integer গ্রহণ করে। যদি এটি নির্দিষ্ট করা হয়, তাহলে ভিডিওটি নিকটতম কীফ্রেম থেকে নির্দিষ্ট সময়ে শুরু হবে। - ঐচ্ছিক
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):Voidvideo 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}):Void15 নভেম্বর 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}):Void15 নভেম্বর 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-codeidমান রয়েছে এমন পৃষ্ঠা উপাদানটিতে এম্বেড কোডটি প্রদর্শন করে।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'