mino
11-30-2021, 10:52 PM
این سند نحوه جاسازی یک پخش کننده YouTube را در برنامه خود توضیح می دهد و همچنین پارامترهایی را که در پخش کننده تعبیه شده YouTube در دسترس هستند را تعریف می کند.
با افزودن پارامترها به URL IFrame، می توانید تجربه پخش در برنامه خود را سفارشی کنید. به عنوان مثال، می توانید به طور خودکار ویدیوها را با استفاده از autoplay (https://developers.google.com/youtube/player_parameters#autoplay)پارامتر یا باعث پخش مکرر یک ویدیو با استفاده از loop (https://developers.google.com/youtube/player_parameters#loop)پارامتر. شما همچنین می توانید استفاده کنید enablejsapi (https://developers.google.com/youtube/player_parameters#enablejsapi)پارامتری که پخش کننده را قادر می سازد از طریق کنترل شود API IFrame Player (https://developers.google.com/youtube/iframe_api_reference).
این صفحه در حال حاضر تمام پارامترهای پشتیبانی شده در را تعریف می کند هر پخش کننده تعبیه شده YouTube . هر تعریف پارامتر، بازیکنانی را که از پارامتر مربوطه پشتیبانی می کنند، شناسایی می کند.
توجه: پخش‌کننده‌های جاسازی‌شده باید دارای دیدی با ابعاد حداقل 200 پیکسل در 200 پیکسل باشند. اگر پخش‌کننده کنترل‌ها را نمایش می‌دهد، باید به اندازه‌ای بزرگ باشد که کنترل‌ها را به‌طور کامل نمایش دهد بدون اینکه درگاه دید کمتر از حداقل اندازه باشد. ما توصیه می کنیم پخش کننده های 16:9 حداقل 480 پیکسل عرض و 270 پیکسل قد داشته باشند.
Embed a YouTube playerمی توانید از یکی از روش های زیر برای جاسازی یک پخش کننده YouTube در برنامه خود و تعیین پارامترهای پخش کننده استفاده کنید. توجه داشته باشید که دستورالعمل‌های زیر نحوه جاسازی پخش‌کننده‌ای را نشان می‌دهد که یک ویدیو را بارگیری می‌کند. بخش زیر نحوه پیکربندی پخش کننده خود را برای بارگذاری لیست پخش یا ویدیوهای آپلود شده توسط کاربر توضیح می دهد.
Embed a player using an <iframe> tagیک را تعریف کنید <iframe>در برنامه خود تگ کنید که در آن srcURL محتوایی را که پخش کننده بارگیری می کند و همچنین سایر پارامترهای پخش کننده را که می خواهید تنظیم کنید مشخص می کند. در <iframe>روزها heightو widthپارامترها ابعاد پخش کننده را مشخص می کنند.
اگر شما ایجاد کنید <iframe>عنصر خود را (به جای استفاده از IFrame Player API برای ایجاد آن)، می توانید پارامترهای پخش کننده را مستقیماً به انتهای URL اضافه کنید. URL دارای فرمت زیر است:
https://www.youtube.com/embed/VIDEO_ID در <iframe>برچسب زیر یک پخش کننده 640x360px را بارگیری می کند که ویدیوی YouTube را پخش می کند M7lc1UVf-VE. از آنجایی که URL تعیین می کند autoplayپارامتر به 1، پس از بارگیری پخش کننده، ویدیو به طور خودکار پخش می شود.
<iframe id="ytplayer" type="text/html" width="640" height="360"
src="https://www.youtube.com/embed/M7lc1UVf-VE?autoplay=1&origin=http://example.com"
frameborder="0"></iframe>
Embed a player using the IFrame Player APIدنبال کنید تا دستورالعمل های IFrame Player API را (https://developers.google.com/youtube/iframe_api_reference#Loading_a_Video_Player)پس از بارگیری کد جاوا اسکریپت Player API، یک پخش کننده ویدیو را در صفحه وب یا برنامه خود وارد کنید. دومین پارامتر در سازنده برای پخش کننده ویدیو، یک شی است که گزینه های پخش کننده را مشخص می کند. در داخل آن شی، playerVarsویژگی پارامترهای بازیکن را شناسایی می کند.
کد HTML و جاوا اسکریپت زیر یک مثال ساده را نشان می دهد که یک پخش کننده YouTube را در عنصر صفحه قرار می دهد که دارای یک idارزش ytplayer. در onYouTubePlayerAPIReady()وقتی کد IFrame Player API بارگیری شد، عملکرد مشخص شده در اینجا به طور خودکار فراخوانی می شود. این کد هیچ پارامتر پخش کننده ای را تعریف نمی کند و همچنین کنترل کننده های رویداد دیگر را تعریف نمی کند.
<div id="ytplayer"></div>
<script>
// Load the IFrame Player API code asynchronously.
var tag = document.createElement('script');
tag.src = "https://www.youtube.com/player_api";
var firstScriptTag = document.getElementsByTagName('script')[0];
firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);
// Replace the 'ytplayer' element with an <iframe> and
// YouTube player after the API code downloads.
var player;
function onYouTubePlayerAPIReady() {
player = new YT.Player('ytplayer', {
height: '360',
width: '640',
videoId: 'M7lc1UVf-VE'
});
}
</script>
Select content to playمی توانید پخش کننده جاسازی شده خود را برای بارگیری یک ویدیو، یک لیست پخش یا ویدیوهای آپلود شده توسط کاربر پیکربندی کنید.
لیست زیر این گزینه ها را توضیح می دهد:
در حال بارگیری یک ویدیو
برای جاسازی IFrame، شناسه ویدیوی YouTube برای ویدیویی که می‌خواهید بارگیری کنید در IFrame مشخص شده است. srcURL.
https://www.youtube.com/embed/VIDEO_ID اگر از YouTube Data API (v3) استفاده می‌کنید، می‌توانید با بازیابی شناسه‌های ویدیو از این URLها را به‌صورت برنامه‌نویسی بسازید نتایج جستجو (https://developers.google.com/youtube/v3/docs/search#resource)، منابع آیتم‌های فهرست پخش (https://developers.google.com/youtube/v3/docs/playlistItems#resource)، منابع ویدیویی (https://developers.google.com/youtube/v3/docs/videos#resource)یا منابع دیگر، . پس از دریافت شناسه ویدیویی، آن را جایگزین کنید VIDEO_IDبرای ایجاد URL پخش کننده، در URL های بالا با آن مقدار بنویسید.
در حال بارگیری یک لیست پخش
تنظیم کنید listType (https://developers.google.com/youtube/player_parameters#listType)پارامتر پخش به playlist. علاوه بر این، تنظیم کنید list (https://developers.google.com/youtube/player_parameters#list)پارامتر پخش کننده به شناسه لیست پخش YouTube که می خواهید بارگیری کنید.
https://www.youtube.com/embed?listType=playlist&list=PLAYLIST_ID توجه داشته باشید که باید شناسه لیست پخش را با حروف اضافه کنید PLهمانطور که در مثال زیر نشان داده شده است:
https://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6 اگر از YouTube Data API (نسخه 3) استفاده می‌کنید، می‌توانید با بازیابی شناسه‌های فهرست پخش از این نشانی‌های اینترنتی را به‌صورت برنامه‌نویسی بسازید نتایج جستجو (https://developers.google.com/youtube/v3/docs/search#resource)، منابع کانال (https://developers.google.com/youtube/v3/docs/channels#contentDetails.relatedPlaylists)یا ، منابع فعالیت (https://developers.google.com/youtube/v3/docs/activities#resource). پس از دریافت شناسه لیست پخش، آن را جایگزین کنید PLAYLIST_IDمتن در URL بالا با آن مقدار.
بارگیری ویدیوهای آپلود شده توسط کاربر
تنظیم کنید listType (https://developers.google.com/youtube/player_parameters#listType)پارامتر پخش به user_uploads. علاوه بر این، تنظیم کنید list (https://developers.google.com/youtube/player_parameters#list)پارامتر پخش کننده به نام کاربری YouTube که می خواهید ویدیوهای آپلود شده آن را بارگیری کنید.
https://www.youtube.com/embed?listType=user_uploads&list=USERNAME
تمام پارامترهای زیر اختیاری هستند.
مولفه های
autoplay
این پارامتر مشخص می کند که آیا ویدیوی اولیه به طور خودکار هنگام بارگیری پخش کننده شروع به پخش می کند یا خیر. مقادیر پشتیبانی شده هستند 0یا 1. مقدار پیش فرض است 0.
اگر پخش خودکار را فعال کنید، پخش بدون هیچ گونه تعامل کاربر با پخش کننده انجام می شود. بنابراین، پس از بارگیری صفحه، جمع آوری و اشتراک داده های پخش انجام می شود.
cc_lang_pref
این پارامتر زبان پیش فرضی را که پخش کننده برای نمایش زیرنویس ها استفاده می کند، مشخص می کند. مقدار پارامتر را روی تنظیم کنید کد زبان دو حرفی ISO 639-1 (http://www.loc.gov/standards/iso639-2/php/code_list.php).
در صورت استفاده از این پارامتر و همچنین تنظیم cc_load_policy (https://developers.google.com/youtube/player_parameters#cc_load_policy)پارامتر به 1، پس از بارگیری پخش کننده، زیرنویس ها را به زبان مشخص شده نشان می دهد. اگر شما نیز تنظیم کنید cc_load_policy (https://developers.google.com/youtube/player_parameters#cc_load_policy)پارامتر، سپس شرح‌ها به‌طور پیش‌فرض نمایش داده نمی‌شوند، اما اگر کاربر روشن کردن زیرنویس‌ها را انتخاب کند، به زبان مشخص نمایش داده می‌شوند.
cc_load_policy
تنظیم مقدار پارامتر به 1باعث می‌شود زیرنویس‌های بسته به‌طور پیش‌فرض نشان داده شوند، حتی اگر کاربر زیرنویس‌ها را خاموش کرده باشد. رفتار پیش فرض بر اساس اولویت کاربر است.
color
این پارامتر رنگی را مشخص می کند که در نوار پیشرفت ویدیوی پخش کننده برای برجسته کردن مقدار ویدیویی که بیننده قبلاً دیده است استفاده می شود. مقادیر پارامتر معتبر هستند redو white، و به طور پیش فرض، پخش کننده از رنگ قرمز در نوار پیشرفت ویدیو استفاده می کند. مراجعه کنید وبلاگ YouTube API (http://youtube-eng.blogspot.com/2011/08/coming-soon-dark-player-for-embeds_5.html)برای اطلاعات بیشتر در مورد گزینه های رنگ به .
توجه: تنظیم colorپارامتر به whiteرا غیرفعال خواهد کرد modestbranding (https://developers.google.com/youtube/player_parameters#modestbranding)گزینه.
controls
این پارامتر نشان می دهد که آیا کنترل های پخش کننده ویدیو نمایش داده می شوند یا خیر:
controls=0– کنترل های پخش کننده در پخش کننده نمایش داده نمی شوند.
controls=1(پیش‌فرض) - پخش کننده نمایش را در پخش کننده کنترل می‌کند.
disablekb
تنظیم مقدار پارامتر به 1باعث می شود پخش کننده به کنترل های صفحه کلید پاسخ ندهد. مقدار پیش فرض است 0، به این معنی که کنترل های صفحه کلید فعال هستند. کنترل‌های صفحه کلیدی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
فاصله یا [k]: پخش / مکث
پیکان چپ: در ویدیوی فعلی 5 ثانیه به عقب پرش کنید
پیکان راست: در ویدیوی فعلی ۵ ثانیه جلوتر بپرید
فلش بالا: افزایش صدا
فلش پایین: کاهش صدا
[f]: نمایش تمام صفحه را تغییر دهید
[j]: در ویدیوی فعلی 10 ثانیه به عقب پرش کنید
[l]: در ویدیوی فعلی 10 ثانیه به جلو بپرید
[m]: ویدیو را بی صدا یا باصدا کنید
[0-9]: پرش به نقطه ای در ویدیو. 0به ابتدای ویدیو می پرد، 1به نقطه 10٪ در ویدیو می پرد، 2به نقطه 20٪ در ویدیو می پرد و غیره.
enablejsapi
تنظیم مقدار پارامتر به 1پخش کننده را قادر می سازد از طریق تماس های کنترل شود IFrame (https://developers.google.com/youtube/iframe_api_reference)Player API . مقدار پیش فرض است 0، به این معنی که پخش کننده را نمی توان با استفاده از آن API کنترل کرد.
برای اطلاعات بیشتر در مورد IFrame API و نحوه استفاده از آن، به مستندات IFrame API مراجعه کنید (https://developers.google.com/youtube/iframe_api_reference).
end
این پارامتر زمانی را که پخش کننده باید پخش ویدیو را متوقف کند، بر حسب ثانیه از شروع ویدیو اندازه گیری می کند. مقدار پارامتر یک عدد صحیح مثبت است.
توجه داشته باشید که زمان از ابتدای ویدیو اندازه گیری می شود و نه از ارزش هر یک startپارامتر پخش کننده یا startSecondsپارامتری که در توابع YouTube Player API برای بارگیری یا صف بندی یک ویدیو استفاده می شود.
fs
تنظیم این پارامتر روی 0از نمایش دکمه تمام صفحه در پخش کننده جلوگیری می کند. مقدار پیش فرض است 1، که باعث نمایش دکمه تمام صفحه می شود.
hl
زبان رابط پخش کننده را تنظیم می کند. مقدار پارامتر یک کد زبان دو حرفی ISO 639-1 (http://www.loc.gov/standards/iso639-2/php/code_list.php)یا یک منطقه کاملاً مشخص شده است. مثلا، frو fr-caهر دو مقدار معتبر هستند. سایر کدهای ورودی زبان، مانند برچسب های زبان IETF (BCP 47) نیز ممکن است به درستی مدیریت شوند.
زبان رابط برای نکات ابزار در پخش کننده استفاده می شود و همچنین بر روی تراک شرح پیش فرض تأثیر می گذارد. توجه داشته باشید که YouTube ممکن است بر اساس ترجیحات زبان فردی کاربر و در دسترس بودن تراک‌های شرح، زبان آهنگ زیرنویس متفاوتی را برای یک کاربر خاص انتخاب کند.
iv_load_policy
تنظیم مقدار پارامتر به 1باعث می شود حاشیه نویسی های ویدئویی به طور پیش فرض نشان داده شوند، در حالی که روی را تنظیم کنید 3باعث می شود حاشیه نویسی ویدیو به طور پیش فرض نشان داده نشود. مقدار پیش فرض است 1.
list
در listپارامتر، در ارتباط با listType (https://developers.google.com/youtube/player_parameters#listType)پارامتر، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند.
اگر listType (https://developers.google.com/youtube/player_parameters#listType)مقدار پارامتر است user_uploads، سپس listمقدار پارامتر کانال YouTube را مشخص می کند که ویدیوهای آپلود شده آن بارگذاری می شوند.
اگر listType (https://developers.google.com/youtube/player_parameters#listType)مقدار پارامتر است playlist، سپس listمقدار پارامتر یک شناسه لیست پخش YouTube را مشخص می کند. در مقدار پارامتر، باید شناسه لیست پخش را با حروف اضافه کنید PLهمانطور که در مثال زیر نشان داده شده است.
https://www.youtube.com/embed?
listType=playlist
&list=PLC77007E23FF423C6
اگر listType (https://developers.google.com/youtube/player_parameters#listType)مقدار پارامتر است search، سپس listمقدار پارامتر عبارت جستجو را مشخص می کند. توجه: این عملکرد منسوخ شده است (https://developers.google.com/youtube/player_parameters#release_notes_10_13_2020)و از آن زمان دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 .
توجه: اگر مقادیری را برای listو listTypeپارامترها، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.
listType
در listTypeپارامتر، در ارتباط با list (https://developers.google.com/youtube/player_parameters#list)پارامتر، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند. مقادیر پارامتر معتبر هستند playlistو user_uploads.
اگر مقادیری را برای list (https://developers.google.com/youtube/player_parameters#list)و listTypeپارامترها، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.
توجه: یک مقدار پارامتر سوم، search، شده منسوخ است (https://developers.google.com/youtube/player_parameters#release_notes_10_13_2020)و از این تاریخ دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 .
loop
در مورد یک پخش کننده ویدئو، یک تنظیم از 1باعث می شود که پخش کننده بارها و بارها فیلم اولیه را پخش کند. در مورد لیست پخش پخش کننده (یا پخش کننده سفارشی)، پخش کننده کل لیست پخش را پخش می کند و سپس دوباره شروع می کند اولین ویدیو
مقادیر پشتیبانی شده هستند 0و 1، و مقدار پیش فرض است 0.
توجه: این پارامتر محدود است پشتیبانی در تعبیه‌های IFrame برای حلقه کردن یک ویدیو، آن را تنظیم کنید loopمقدار پارامتر به 1 و تنظیم کنید playlist (https://developers.google.com/youtube/player_parameters#playlist)پارامتر مقدار همان شناسه ویدیویی که قبلاً در URL API Player مشخص شده است:
https://www.youtube.com/embed/VIDEO_ID?playlist=VIDEO_ID&loop=1
modestbranding
این پارامتر به شما امکان می‌دهد از پخش‌کننده YouTube استفاده کنید که نشان‌واره YouTube را نشان نمی‌دهد. مقدار پارامتر را روی 1برای جلوگیری از نمایش لوگوی YouTube در نوار کنترل. توجه داشته باشید که کوچک YouTubeهنگامی که نشانگر ماوس کاربر روی پخش‌کننده قرار می‌گیرد، برچسب متن همچنان در گوشه سمت راست بالای یک ویدیوی مکث شده نمایش داده می‌شود.
origin
این پارامتر یک معیار امنیتی اضافی برای API IFrame فراهم می کند و فقط برای جاسازی های IFrame پشتیبانی می شود. اگر از IFrame API استفاده می کنید، به این معنی است که در حال تنظیم آن هستید enablejsapi (https://developers.google.com/youtube/player_parameters#enablejsapi)مقدار پارامتر به 1، همیشه باید دامنه خود را به عنوان علامت مشخص کنید originمقدار پارامتر
playlist
این پارامتر فهرستی از شناسه‌های ویدیویی جدا شده با کاما را برای پخش مشخص می‌کند. اگر مقداری را مشخص کنید، اولین ویدیویی که پخش می‌شود همان خواهد بود VIDEO_IDمشخص شده در مسیر URL، و ویدیوهای مشخص شده در playlistپارامتر پس از آن پخش می شود.
playsinline
این پارامتر کنترل می‌کند که ویدیوها به صورت درون خطی یا تمام صفحه در iOS پخش شوند. مقادیر معتبر عبارتند از:
0: نتایج در پخش تمام صفحه. این در حال حاضر مقدار پیش‌فرض است، اگرچه پیش‌فرض ممکن است تغییر کند.
1: نتایج پخش درون خطی برای مرورگرهای موبایل و برای WebViewsایجاد شده با allowsInlineMediaPlayback (https://developer.apple.com/documentation/webkit/wkwebviewconfiguration/1614793-allowsinlinemediaplayback?language=objc)ویژگی تنظیم شده است YES.
rel
توجه: این پارامتر است حال تغییر (https://developers.google.com/youtube/player_parameters#release_notes_08_23_2018)در تاریخ 25 سپتامبر 2018 یا پس از آن در .
قبل از تغییر، این پارامتر نشان می‌دهد که آیا پخش‌کننده باید ویدیوهای مرتبط را هنگام پایان پخش ویدیوی اولیه نشان دهد یا خیر.
اگر مقدار پارامتر روی 1، که مقدار پیش فرض است، پخش کننده ویدیوهای مرتبط را نشان می دهد.
اگر مقدار پارامتر روی 0، سپس پخش کننده ویدیوهای مرتبط را نشان نمی دهد.
پس از تغییر، نمی‌توانید ویدیوهای مرتبط را غیرفعال کنید. در عوض، اگر relپارامتر تنظیم شده است 0، ویدیوهای مرتبط از همان کانال ویدیویی که به تازگی پخش شده است می آیند.
start
این پارامتر باعث می شود که پخش کننده شروع به پخش ویدیو در تعداد ثانیه معین از شروع ویدیو کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که مشابه seekTo (https://developers.google.com/youtube/js_api_reference#seekTo)عملکرد، پخش کننده به دنبال نزدیک ترین فریم کلیدی به زمانی که شما مشخص کرده اید می گردد. این به این معنی است که گاهی اوقات ممکن است هد پخش درست قبل از زمان درخواستی، معمولاً بیش از دو ثانیه به دنبال آن باشد.
widget_referrer
این پارامتر URL جایی که پخش کننده در آن جاسازی شده است را مشخص می کند. هنگامی که پخش کننده YouTube در یک ویجت جاسازی شده است، این مقدار در گزارش YouTube Analytics استفاده می شود و سپس آن ویجت در یک صفحه وب یا برنامه جاسازی می شود. در آن سناریو، origin (https://developers.google.com/youtube/player_parameters#origin)پارامتر دامنه ارائه‌دهنده ویجت را مشخص می‌کند، اما YouTube Analytics نباید ارائه‌دهنده ویجت را به عنوان منبع ترافیک واقعی شناسایی کند. در عوض، YouTube Analytics از widget_referrerمقدار پارامتر برای شناسایی دامنه مرتبط با منبع ترافیک.
با افزودن پارامترها به URL IFrame، می توانید تجربه پخش در برنامه خود را سفارشی کنید. به عنوان مثال، می توانید به طور خودکار ویدیوها را با استفاده از autoplay (https://developers.google.com/youtube/player_parameters#autoplay)پارامتر یا باعث پخش مکرر یک ویدیو با استفاده از loop (https://developers.google.com/youtube/player_parameters#loop)پارامتر. شما همچنین می توانید استفاده کنید enablejsapi (https://developers.google.com/youtube/player_parameters#enablejsapi)پارامتری که پخش کننده را قادر می سازد از طریق کنترل شود API IFrame Player (https://developers.google.com/youtube/iframe_api_reference).
این صفحه در حال حاضر تمام پارامترهای پشتیبانی شده در را تعریف می کند هر پخش کننده تعبیه شده YouTube . هر تعریف پارامتر، بازیکنانی را که از پارامتر مربوطه پشتیبانی می کنند، شناسایی می کند.
توجه: پخش‌کننده‌های جاسازی‌شده باید دارای دیدی با ابعاد حداقل 200 پیکسل در 200 پیکسل باشند. اگر پخش‌کننده کنترل‌ها را نمایش می‌دهد، باید به اندازه‌ای بزرگ باشد که کنترل‌ها را به‌طور کامل نمایش دهد بدون اینکه درگاه دید کمتر از حداقل اندازه باشد. ما توصیه می کنیم پخش کننده های 16:9 حداقل 480 پیکسل عرض و 270 پیکسل قد داشته باشند.
Embed a YouTube playerمی توانید از یکی از روش های زیر برای جاسازی یک پخش کننده YouTube در برنامه خود و تعیین پارامترهای پخش کننده استفاده کنید. توجه داشته باشید که دستورالعمل‌های زیر نحوه جاسازی پخش‌کننده‌ای را نشان می‌دهد که یک ویدیو را بارگیری می‌کند. بخش زیر نحوه پیکربندی پخش کننده خود را برای بارگذاری لیست پخش یا ویدیوهای آپلود شده توسط کاربر توضیح می دهد.
Embed a player using an <iframe> tagیک را تعریف کنید <iframe>در برنامه خود تگ کنید که در آن srcURL محتوایی را که پخش کننده بارگیری می کند و همچنین سایر پارامترهای پخش کننده را که می خواهید تنظیم کنید مشخص می کند. در <iframe>روزها heightو widthپارامترها ابعاد پخش کننده را مشخص می کنند.
اگر شما ایجاد کنید <iframe>عنصر خود را (به جای استفاده از IFrame Player API برای ایجاد آن)، می توانید پارامترهای پخش کننده را مستقیماً به انتهای URL اضافه کنید. URL دارای فرمت زیر است:
https://www.youtube.com/embed/VIDEO_ID در <iframe>برچسب زیر یک پخش کننده 640x360px را بارگیری می کند که ویدیوی YouTube را پخش می کند M7lc1UVf-VE. از آنجایی که URL تعیین می کند autoplayپارامتر به 1، پس از بارگیری پخش کننده، ویدیو به طور خودکار پخش می شود.
<iframe id="ytplayer" type="text/html" width="640" height="360"
src="https://www.youtube.com/embed/M7lc1UVf-VE?autoplay=1&origin=http://example.com"
frameborder="0"></iframe>
Embed a player using the IFrame Player APIدنبال کنید تا دستورالعمل های IFrame Player API را (https://developers.google.com/youtube/iframe_api_reference#Loading_a_Video_Player)پس از بارگیری کد جاوا اسکریپت Player API، یک پخش کننده ویدیو را در صفحه وب یا برنامه خود وارد کنید. دومین پارامتر در سازنده برای پخش کننده ویدیو، یک شی است که گزینه های پخش کننده را مشخص می کند. در داخل آن شی، playerVarsویژگی پارامترهای بازیکن را شناسایی می کند.
کد HTML و جاوا اسکریپت زیر یک مثال ساده را نشان می دهد که یک پخش کننده YouTube را در عنصر صفحه قرار می دهد که دارای یک idارزش ytplayer. در onYouTubePlayerAPIReady()وقتی کد IFrame Player API بارگیری شد، عملکرد مشخص شده در اینجا به طور خودکار فراخوانی می شود. این کد هیچ پارامتر پخش کننده ای را تعریف نمی کند و همچنین کنترل کننده های رویداد دیگر را تعریف نمی کند.
<div id="ytplayer"></div>
<script>
// Load the IFrame Player API code asynchronously.
var tag = document.createElement('script');
tag.src = "https://www.youtube.com/player_api";
var firstScriptTag = document.getElementsByTagName('script')[0];
firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);
// Replace the 'ytplayer' element with an <iframe> and
// YouTube player after the API code downloads.
var player;
function onYouTubePlayerAPIReady() {
player = new YT.Player('ytplayer', {
height: '360',
width: '640',
videoId: 'M7lc1UVf-VE'
});
}
</script>
Select content to playمی توانید پخش کننده جاسازی شده خود را برای بارگیری یک ویدیو، یک لیست پخش یا ویدیوهای آپلود شده توسط کاربر پیکربندی کنید.
لیست زیر این گزینه ها را توضیح می دهد:
در حال بارگیری یک ویدیو
برای جاسازی IFrame، شناسه ویدیوی YouTube برای ویدیویی که می‌خواهید بارگیری کنید در IFrame مشخص شده است. srcURL.
https://www.youtube.com/embed/VIDEO_ID اگر از YouTube Data API (v3) استفاده می‌کنید، می‌توانید با بازیابی شناسه‌های ویدیو از این URLها را به‌صورت برنامه‌نویسی بسازید نتایج جستجو (https://developers.google.com/youtube/v3/docs/search#resource)، منابع آیتم‌های فهرست پخش (https://developers.google.com/youtube/v3/docs/playlistItems#resource)، منابع ویدیویی (https://developers.google.com/youtube/v3/docs/videos#resource)یا منابع دیگر، . پس از دریافت شناسه ویدیویی، آن را جایگزین کنید VIDEO_IDبرای ایجاد URL پخش کننده، در URL های بالا با آن مقدار بنویسید.
در حال بارگیری یک لیست پخش
تنظیم کنید listType (https://developers.google.com/youtube/player_parameters#listType)پارامتر پخش به playlist. علاوه بر این، تنظیم کنید list (https://developers.google.com/youtube/player_parameters#list)پارامتر پخش کننده به شناسه لیست پخش YouTube که می خواهید بارگیری کنید.
https://www.youtube.com/embed?listType=playlist&list=PLAYLIST_ID توجه داشته باشید که باید شناسه لیست پخش را با حروف اضافه کنید PLهمانطور که در مثال زیر نشان داده شده است:
https://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6 اگر از YouTube Data API (نسخه 3) استفاده می‌کنید، می‌توانید با بازیابی شناسه‌های فهرست پخش از این نشانی‌های اینترنتی را به‌صورت برنامه‌نویسی بسازید نتایج جستجو (https://developers.google.com/youtube/v3/docs/search#resource)، منابع کانال (https://developers.google.com/youtube/v3/docs/channels#contentDetails.relatedPlaylists)یا ، منابع فعالیت (https://developers.google.com/youtube/v3/docs/activities#resource). پس از دریافت شناسه لیست پخش، آن را جایگزین کنید PLAYLIST_IDمتن در URL بالا با آن مقدار.
بارگیری ویدیوهای آپلود شده توسط کاربر
تنظیم کنید listType (https://developers.google.com/youtube/player_parameters#listType)پارامتر پخش به user_uploads. علاوه بر این، تنظیم کنید list (https://developers.google.com/youtube/player_parameters#list)پارامتر پخش کننده به نام کاربری YouTube که می خواهید ویدیوهای آپلود شده آن را بارگیری کنید.
https://www.youtube.com/embed?listType=user_uploads&list=USERNAME
تمام پارامترهای زیر اختیاری هستند.
مولفه های
autoplay
این پارامتر مشخص می کند که آیا ویدیوی اولیه به طور خودکار هنگام بارگیری پخش کننده شروع به پخش می کند یا خیر. مقادیر پشتیبانی شده هستند 0یا 1. مقدار پیش فرض است 0.
اگر پخش خودکار را فعال کنید، پخش بدون هیچ گونه تعامل کاربر با پخش کننده انجام می شود. بنابراین، پس از بارگیری صفحه، جمع آوری و اشتراک داده های پخش انجام می شود.
cc_lang_pref
این پارامتر زبان پیش فرضی را که پخش کننده برای نمایش زیرنویس ها استفاده می کند، مشخص می کند. مقدار پارامتر را روی تنظیم کنید کد زبان دو حرفی ISO 639-1 (http://www.loc.gov/standards/iso639-2/php/code_list.php).
در صورت استفاده از این پارامتر و همچنین تنظیم cc_load_policy (https://developers.google.com/youtube/player_parameters#cc_load_policy)پارامتر به 1، پس از بارگیری پخش کننده، زیرنویس ها را به زبان مشخص شده نشان می دهد. اگر شما نیز تنظیم کنید cc_load_policy (https://developers.google.com/youtube/player_parameters#cc_load_policy)پارامتر، سپس شرح‌ها به‌طور پیش‌فرض نمایش داده نمی‌شوند، اما اگر کاربر روشن کردن زیرنویس‌ها را انتخاب کند، به زبان مشخص نمایش داده می‌شوند.
cc_load_policy
تنظیم مقدار پارامتر به 1باعث می‌شود زیرنویس‌های بسته به‌طور پیش‌فرض نشان داده شوند، حتی اگر کاربر زیرنویس‌ها را خاموش کرده باشد. رفتار پیش فرض بر اساس اولویت کاربر است.
color
این پارامتر رنگی را مشخص می کند که در نوار پیشرفت ویدیوی پخش کننده برای برجسته کردن مقدار ویدیویی که بیننده قبلاً دیده است استفاده می شود. مقادیر پارامتر معتبر هستند redو white، و به طور پیش فرض، پخش کننده از رنگ قرمز در نوار پیشرفت ویدیو استفاده می کند. مراجعه کنید وبلاگ YouTube API (http://youtube-eng.blogspot.com/2011/08/coming-soon-dark-player-for-embeds_5.html)برای اطلاعات بیشتر در مورد گزینه های رنگ به .
توجه: تنظیم colorپارامتر به whiteرا غیرفعال خواهد کرد modestbranding (https://developers.google.com/youtube/player_parameters#modestbranding)گزینه.
controls
این پارامتر نشان می دهد که آیا کنترل های پخش کننده ویدیو نمایش داده می شوند یا خیر:
controls=0– کنترل های پخش کننده در پخش کننده نمایش داده نمی شوند.
controls=1(پیش‌فرض) - پخش کننده نمایش را در پخش کننده کنترل می‌کند.
disablekb
تنظیم مقدار پارامتر به 1باعث می شود پخش کننده به کنترل های صفحه کلید پاسخ ندهد. مقدار پیش فرض است 0، به این معنی که کنترل های صفحه کلید فعال هستند. کنترل‌های صفحه کلیدی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
فاصله یا [k]: پخش / مکث
پیکان چپ: در ویدیوی فعلی 5 ثانیه به عقب پرش کنید
پیکان راست: در ویدیوی فعلی ۵ ثانیه جلوتر بپرید
فلش بالا: افزایش صدا
فلش پایین: کاهش صدا
[f]: نمایش تمام صفحه را تغییر دهید
[j]: در ویدیوی فعلی 10 ثانیه به عقب پرش کنید
[l]: در ویدیوی فعلی 10 ثانیه به جلو بپرید
[m]: ویدیو را بی صدا یا باصدا کنید
[0-9]: پرش به نقطه ای در ویدیو. 0به ابتدای ویدیو می پرد، 1به نقطه 10٪ در ویدیو می پرد، 2به نقطه 20٪ در ویدیو می پرد و غیره.
enablejsapi
تنظیم مقدار پارامتر به 1پخش کننده را قادر می سازد از طریق تماس های کنترل شود IFrame (https://developers.google.com/youtube/iframe_api_reference)Player API . مقدار پیش فرض است 0، به این معنی که پخش کننده را نمی توان با استفاده از آن API کنترل کرد.
برای اطلاعات بیشتر در مورد IFrame API و نحوه استفاده از آن، به مستندات IFrame API مراجعه کنید (https://developers.google.com/youtube/iframe_api_reference).
end
این پارامتر زمانی را که پخش کننده باید پخش ویدیو را متوقف کند، بر حسب ثانیه از شروع ویدیو اندازه گیری می کند. مقدار پارامتر یک عدد صحیح مثبت است.
توجه داشته باشید که زمان از ابتدای ویدیو اندازه گیری می شود و نه از ارزش هر یک startپارامتر پخش کننده یا startSecondsپارامتری که در توابع YouTube Player API برای بارگیری یا صف بندی یک ویدیو استفاده می شود.
fs
تنظیم این پارامتر روی 0از نمایش دکمه تمام صفحه در پخش کننده جلوگیری می کند. مقدار پیش فرض است 1، که باعث نمایش دکمه تمام صفحه می شود.
hl
زبان رابط پخش کننده را تنظیم می کند. مقدار پارامتر یک کد زبان دو حرفی ISO 639-1 (http://www.loc.gov/standards/iso639-2/php/code_list.php)یا یک منطقه کاملاً مشخص شده است. مثلا، frو fr-caهر دو مقدار معتبر هستند. سایر کدهای ورودی زبان، مانند برچسب های زبان IETF (BCP 47) نیز ممکن است به درستی مدیریت شوند.
زبان رابط برای نکات ابزار در پخش کننده استفاده می شود و همچنین بر روی تراک شرح پیش فرض تأثیر می گذارد. توجه داشته باشید که YouTube ممکن است بر اساس ترجیحات زبان فردی کاربر و در دسترس بودن تراک‌های شرح، زبان آهنگ زیرنویس متفاوتی را برای یک کاربر خاص انتخاب کند.
iv_load_policy
تنظیم مقدار پارامتر به 1باعث می شود حاشیه نویسی های ویدئویی به طور پیش فرض نشان داده شوند، در حالی که روی را تنظیم کنید 3باعث می شود حاشیه نویسی ویدیو به طور پیش فرض نشان داده نشود. مقدار پیش فرض است 1.
list
در listپارامتر، در ارتباط با listType (https://developers.google.com/youtube/player_parameters#listType)پارامتر، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند.
اگر listType (https://developers.google.com/youtube/player_parameters#listType)مقدار پارامتر است user_uploads، سپس listمقدار پارامتر کانال YouTube را مشخص می کند که ویدیوهای آپلود شده آن بارگذاری می شوند.
اگر listType (https://developers.google.com/youtube/player_parameters#listType)مقدار پارامتر است playlist، سپس listمقدار پارامتر یک شناسه لیست پخش YouTube را مشخص می کند. در مقدار پارامتر، باید شناسه لیست پخش را با حروف اضافه کنید PLهمانطور که در مثال زیر نشان داده شده است.
https://www.youtube.com/embed?
listType=playlist
&list=PLC77007E23FF423C6
اگر listType (https://developers.google.com/youtube/player_parameters#listType)مقدار پارامتر است search، سپس listمقدار پارامتر عبارت جستجو را مشخص می کند. توجه: این عملکرد منسوخ شده است (https://developers.google.com/youtube/player_parameters#release_notes_10_13_2020)و از آن زمان دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 .
توجه: اگر مقادیری را برای listو listTypeپارامترها، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.
listType
در listTypeپارامتر، در ارتباط با list (https://developers.google.com/youtube/player_parameters#list)پارامتر، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند. مقادیر پارامتر معتبر هستند playlistو user_uploads.
اگر مقادیری را برای list (https://developers.google.com/youtube/player_parameters#list)و listTypeپارامترها، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.
توجه: یک مقدار پارامتر سوم، search، شده منسوخ است (https://developers.google.com/youtube/player_parameters#release_notes_10_13_2020)و از این تاریخ دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 .
loop
در مورد یک پخش کننده ویدئو، یک تنظیم از 1باعث می شود که پخش کننده بارها و بارها فیلم اولیه را پخش کند. در مورد لیست پخش پخش کننده (یا پخش کننده سفارشی)، پخش کننده کل لیست پخش را پخش می کند و سپس دوباره شروع می کند اولین ویدیو
مقادیر پشتیبانی شده هستند 0و 1، و مقدار پیش فرض است 0.
توجه: این پارامتر محدود است پشتیبانی در تعبیه‌های IFrame برای حلقه کردن یک ویدیو، آن را تنظیم کنید loopمقدار پارامتر به 1 و تنظیم کنید playlist (https://developers.google.com/youtube/player_parameters#playlist)پارامتر مقدار همان شناسه ویدیویی که قبلاً در URL API Player مشخص شده است:
https://www.youtube.com/embed/VIDEO_ID?playlist=VIDEO_ID&loop=1
modestbranding
این پارامتر به شما امکان می‌دهد از پخش‌کننده YouTube استفاده کنید که نشان‌واره YouTube را نشان نمی‌دهد. مقدار پارامتر را روی 1برای جلوگیری از نمایش لوگوی YouTube در نوار کنترل. توجه داشته باشید که کوچک YouTubeهنگامی که نشانگر ماوس کاربر روی پخش‌کننده قرار می‌گیرد، برچسب متن همچنان در گوشه سمت راست بالای یک ویدیوی مکث شده نمایش داده می‌شود.
origin
این پارامتر یک معیار امنیتی اضافی برای API IFrame فراهم می کند و فقط برای جاسازی های IFrame پشتیبانی می شود. اگر از IFrame API استفاده می کنید، به این معنی است که در حال تنظیم آن هستید enablejsapi (https://developers.google.com/youtube/player_parameters#enablejsapi)مقدار پارامتر به 1، همیشه باید دامنه خود را به عنوان علامت مشخص کنید originمقدار پارامتر
playlist
این پارامتر فهرستی از شناسه‌های ویدیویی جدا شده با کاما را برای پخش مشخص می‌کند. اگر مقداری را مشخص کنید، اولین ویدیویی که پخش می‌شود همان خواهد بود VIDEO_IDمشخص شده در مسیر URL، و ویدیوهای مشخص شده در playlistپارامتر پس از آن پخش می شود.
playsinline
این پارامتر کنترل می‌کند که ویدیوها به صورت درون خطی یا تمام صفحه در iOS پخش شوند. مقادیر معتبر عبارتند از:
0: نتایج در پخش تمام صفحه. این در حال حاضر مقدار پیش‌فرض است، اگرچه پیش‌فرض ممکن است تغییر کند.
1: نتایج پخش درون خطی برای مرورگرهای موبایل و برای WebViewsایجاد شده با allowsInlineMediaPlayback (https://developer.apple.com/documentation/webkit/wkwebviewconfiguration/1614793-allowsinlinemediaplayback?language=objc)ویژگی تنظیم شده است YES.
rel
توجه: این پارامتر است حال تغییر (https://developers.google.com/youtube/player_parameters#release_notes_08_23_2018)در تاریخ 25 سپتامبر 2018 یا پس از آن در .
قبل از تغییر، این پارامتر نشان می‌دهد که آیا پخش‌کننده باید ویدیوهای مرتبط را هنگام پایان پخش ویدیوی اولیه نشان دهد یا خیر.
اگر مقدار پارامتر روی 1، که مقدار پیش فرض است، پخش کننده ویدیوهای مرتبط را نشان می دهد.
اگر مقدار پارامتر روی 0، سپس پخش کننده ویدیوهای مرتبط را نشان نمی دهد.
پس از تغییر، نمی‌توانید ویدیوهای مرتبط را غیرفعال کنید. در عوض، اگر relپارامتر تنظیم شده است 0، ویدیوهای مرتبط از همان کانال ویدیویی که به تازگی پخش شده است می آیند.
start
این پارامتر باعث می شود که پخش کننده شروع به پخش ویدیو در تعداد ثانیه معین از شروع ویدیو کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که مشابه seekTo (https://developers.google.com/youtube/js_api_reference#seekTo)عملکرد، پخش کننده به دنبال نزدیک ترین فریم کلیدی به زمانی که شما مشخص کرده اید می گردد. این به این معنی است که گاهی اوقات ممکن است هد پخش درست قبل از زمان درخواستی، معمولاً بیش از دو ثانیه به دنبال آن باشد.
widget_referrer
این پارامتر URL جایی که پخش کننده در آن جاسازی شده است را مشخص می کند. هنگامی که پخش کننده YouTube در یک ویجت جاسازی شده است، این مقدار در گزارش YouTube Analytics استفاده می شود و سپس آن ویجت در یک صفحه وب یا برنامه جاسازی می شود. در آن سناریو، origin (https://developers.google.com/youtube/player_parameters#origin)پارامتر دامنه ارائه‌دهنده ویجت را مشخص می‌کند، اما YouTube Analytics نباید ارائه‌دهنده ویجت را به عنوان منبع ترافیک واقعی شناسایی کند. در عوض، YouTube Analytics از widget_referrerمقدار پارامتر برای شناسایی دامنه مرتبط با منبع ترافیک.