این سند نحوه جاسازی یک پخش کننده YouTube را در برنامه خود توضیح می دهد و همچنین پارامترهایی را که در پخش کننده تعبیه شده YouTube در دسترس هستند را تعریف می کند.
با افزودن پارامترها به URL IFrame، می توانید تجربه پخش را در برنامه خود سفارشی کنید. به عنوان مثال، میتوانید با استفاده از پارامتر autoplay
ویدیوها را به طور خودکار پخش کنید یا با استفاده از پارامتر loop
باعث پخش مکرر یک ویدیو شوید. همچنین میتوانید از پارامتر enablejsapi
برای فعال کردن پخشکننده از طریق API IFrame Player استفاده کنید.
این صفحه در حال حاضر تمام پارامترهای پشتیبانی شده در هر پخش کننده تعبیه شده YouTube را تعریف می کند. هر تعریف پارامتر، بازیکنانی را که از پارامتر مربوطه پشتیبانی می کنند، شناسایی می کند.
توجه: پخشکنندههای جاسازیشده باید دارای دیدی با ابعاد حداقل 200 پیکسل در 200 پیکسل باشند. اگر پخشکننده کنترلها را نمایش میدهد، باید به اندازهای بزرگ باشد که کنترلها را بهطور کامل نمایش دهد، بدون اینکه درگاه دید کمتر از حداقل اندازه باشد. ما توصیه می کنیم پخش کننده های 16:9 حداقل 480 پیکسل عرض و 270 پیکسل قد داشته باشند.
می توانید از یکی از روش های زیر برای جاسازی یک پخش کننده YouTube در برنامه خود و تعیین پارامترهای پخش کننده استفاده کنید. توجه داشته باشید که دستورالعملهای زیر نحوه جاسازی پخشکنندهای را نشان میدهد که یک ویدیو را بارگیری میکند. بخش زیر نحوه پیکربندی پخش کننده خود را برای بارگذاری لیست پخش یا ویدیوهای آپلود شده توسط کاربر توضیح می دهد.
<iframe>
یک پخش کننده را جاسازی کنید یک تگ <iframe>
را در برنامه خود تعریف کنید که در آن URL src
محتوایی را که پخش کننده بارگذاری می کند و همچنین سایر پارامترهای پخش کننده را که می خواهید تنظیم کنید مشخص می کند. پارامترهای height
و width
تگ <iframe>
ابعاد پخش کننده را مشخص می کند.
اگر عنصر <iframe>
را خودتان ایجاد کنید (به جای استفاده از API IFrame Player برای ایجاد آن)، می توانید پارامترهای پخش کننده را مستقیماً به انتهای 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>
دستورالعمل های IFrame Player API را دنبال کنید تا پس از بارگیری کد جاوا اسکریپت Player API، یک پخش کننده ویدیو را در صفحه وب یا برنامه خود قرار دهید. دومین پارامتر در سازنده برای پخش کننده ویدئو، یک شی است که گزینه های پخش کننده را مشخص می کند. در داخل آن شی، ویژگی playerVars
پارامترهای بازیکن را شناسایی می کند.
کد HTML و جاوا اسکریپت زیر یک مثال ساده را نشان می دهد که یک پخش کننده YouTube را در عنصر صفحه قرار می دهد که دارای مقدار id
ytplayer
است. تابع onYouTubePlayerAPIReady()
که در اینجا مشخص شده است، هنگامی که کد API IFrame Player بارگیری می شود، به طور خودکار فراخوانی می شود. این کد هیچ پارامتر پخش کننده ای را تعریف نمی کند و همچنین کنترل کننده های رویداد دیگر را تعریف نمی کند.
<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>
می توانید پخش کننده جاسازی شده خود را برای بارگیری یک ویدیو، یک لیست پخش یا ویدیوهای آپلود شده توسط کاربر پیکربندی کنید.
لیست زیر این گزینه ها را توضیح می دهد:
در حال بارگیری یک ویدیو
برای جاسازی IFrame، شناسه ویدیوی YouTube برای ویدیویی که میخواهید بارگیری کنید در URL
src
IFrame مشخص شده است.https://www.youtube.com/embed/VIDEO_ID
اگر از YouTube Data API (v3) استفاده میکنید، میتوانید با بازیابی شناسههای ویدیو از نتایج جستجو ، منابع آیتمهای فهرست پخش ، منابع ویدیویی یا منابع دیگر، این نشانیهای اینترنتی را به صورت برنامهنویسی بسازید. پس از دریافت شناسه ویدیو، متن
VIDEO_ID
را در URL های بالا با آن مقدار جایگزین کنید تا URL پخش کننده ایجاد شود.در حال بارگیری یک لیست پخش
پارامتر
listType
player را رویplaylist
تنظیم کنید. علاوه بر این، پارامتر پخش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 (v3) استفاده میکنید، میتوانید با بازیابی شناسههای فهرست پخش از نتایج جستجو ، منابع کانال یا منابع فعالیت ، این نشانیهای اینترنتی را به صورت برنامهنویسی بسازید. پس از دریافت شناسه لیست پخش، متن
PLAYLIST_ID
در URL بالا را با آن مقدار جایگزین کنید.بارگیری ویدیوهای آپلود شده توسط کاربر
پارامتر
listType
player را رویuser_uploads
تنظیم کنید. علاوه بر این، پارامتر پخشlist
را روی نام کاربری YouTube که می خواهید ویدیوهای آپلود شده آن بارگیری کنید، تنظیم کنید.https://www.youtube.com/embed?listType=user_uploads&list=USERNAME
تمام پارامترهای زیر اختیاری هستند.
مولفه های | |
---|---|
autoplay | این پارامتر مشخص می کند که آیا ویدیوی اولیه به طور خودکار هنگام بارگیری پخش کننده شروع به پخش می کند یا خیر. مقادیر پشتیبانی شده 0 یا 1 هستند. مقدار پیش فرض 0 است.اگر پخش خودکار را فعال کنید، پخش بدون هیچ گونه تعامل کاربر با پخش کننده انجام می شود. بنابراین جمعآوری و اشتراکگذاری دادههای پخش پس از بارگیری صفحه انجام میشود. |
cc_lang_pref | این پارامتر زبان پیش فرضی را که پخش کننده برای نمایش شرح ها استفاده می کند، مشخص می کند. مقدار پارامتر را روی کد زبان دو حرفی ISO 639-1 تنظیم کنید. اگر از این پارامتر استفاده کنید و همچنین پارامتر cc_load_policy را روی 1 تنظیم کنید، پخش کننده هنگام بارگیری پخش کننده، شرح ها را به زبان مشخص شده نشان می دهد. اگر پارامتر cc_load_policy را نیز تنظیم نکنید، شرحها بهطور پیشفرض نمایش داده نمیشوند، اما در صورتی که کاربر روشن کردن زیرنویسها را انتخاب کند، به زبان مشخص نمایش داده میشوند. |
cc_load_policy | تنظیم مقدار پارامتر روی 1 باعث میشود که زیرنویسهای بسته بهطور پیشفرض نشان داده شوند، حتی اگر کاربر زیرنویسها را خاموش کرده باشد. رفتار پیش فرض بر اساس اولویت کاربر است. |
color | این پارامتر رنگی را مشخص می کند که در نوار پیشرفت ویدیوی پخش کننده برای برجسته کردن مقدار ویدیویی که بیننده قبلاً دیده است استفاده می شود. مقادیر پارامترهای معتبر red و white هستند و بهطور پیشفرض، پخشکننده از رنگ قرمز در نوار پیشرفت ویدیو استفاده میکند. برای اطلاعات بیشتر در مورد گزینه های رنگ به وبلاگ YouTube API مراجعه کنید. |
controls | این پارامتر نشان می دهد که آیا کنترل های پخش کننده ویدیو نمایش داده می شوند:
|
disablekb | تنظیم مقدار پارامتر روی 1 باعث می شود پخش کننده به کنترل های صفحه کلید پاسخ ندهد. مقدار پیش فرض 0 است، به این معنی که کنترل های صفحه کلید فعال هستند. کنترلهای صفحه کلیدی که در حال حاضر پشتیبانی میشوند عبارتند از:
|
enablejsapi | تنظیم مقدار پارامتر روی 1 پخش کننده را قادر می سازد از طریق تماس های API IFrame Player کنترل شود. مقدار پیش فرض 0 است، به این معنی که پخش کننده را نمی توان با استفاده از آن API کنترل کرد.برای اطلاعات بیشتر در مورد IFrame API و نحوه استفاده از آن، به مستندات IFrame API مراجعه کنید. |
end | این پارامتر زمانی را که پخش کننده باید پخش ویدیو را متوقف کند، بر حسب ثانیه از شروع ویدیو اندازه گیری می کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که زمان از ابتدای ویدیو اندازه گیری می شود و نه از مقدار پارامتر start پخش یا پارامتر startSeconds که در توابع YouTube Player API برای بارگیری یا صف بندی یک ویدیو استفاده می شود. |
fs | تنظیم این پارامتر روی 0 از نمایش دکمه تمام صفحه در پخش کننده جلوگیری می کند. مقدار پیش فرض 1 است که باعث می شود دکمه تمام صفحه نمایش داده شود. |
hl | زبان رابط پخش کننده را تنظیم می کند. مقدار پارامتر یک کد زبان دو حرفی ISO 639-1 یا یک منطقه کاملاً مشخص شده است. به عنوان مثال، fr و fr-ca هر دو مقادیر معتبر هستند. سایر کدهای ورودی زبان، مانند برچسب های زبان IETF (BCP 47) نیز ممکن است به درستی مدیریت شوند.زبان رابط برای نکات ابزار در پخش کننده استفاده می شود و همچنین بر روی تراک عنوان پیش فرض تأثیر می گذارد. توجه داشته باشید که YouTube ممکن است بر اساس ترجیحات زبان فردی کاربر و در دسترس بودن تراکهای شرح، زبان آهنگ زیرنویس متفاوتی را برای یک کاربر خاص انتخاب کند. |
iv_load_policy | تنظیم مقدار پارامتر روی 1 باعث می شود حاشیه نویسی ویدیو به طور پیش فرض نشان داده شود، در حالی که تنظیم روی 3 باعث می شود حاشیه نویسی ویدیو به طور پیش فرض نشان داده نشود. مقدار پیش فرض 1 است. |
list | پارامتر list ، در ارتباط با پارامتر listType ، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند.
list و listType مشخص کنید، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد. |
listType | پارامتر listType ، در ارتباط با پارامتر list ، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند. مقادیر پارامتر معتبر عبارتند از playlist و user_uploads .اگر مقادیری را برای پارامترهای list و listType مشخص کنید، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.توجه: مقدار پارامتر سوم، search ، منسوخ شده است و از |
loop | در مورد یک پخش کننده ویدیو، تنظیم 1 باعث می شود که پخش کننده ویدیوی اولیه را بارها و بارها پخش کند. در مورد پخش کننده لیست پخش (یا پخش کننده سفارشی)، پخش کننده کل لیست پخش را پخش می کند و سپس در اولین ویدیو دوباره شروع می کند.مقادیر پشتیبانی شده 0 و 1 و مقدار پیش فرض 0 است.توجه: این پارامتر در تعبیههای IFrame پشتیبانی محدودی دارد. برای حلقه زدن یک ویدیو، مقدار پارامتر loop را روی 1 تنظیم کنید و مقدار پارامتر playlist را روی همان شناسه ویدیویی که قبلاً در URL API Player مشخص شده است تنظیم کنید:https://www.youtube.com/embed/VIDEO_ID?playlist=VIDEO_ID&loop=1 |
modestbranding | توجه: این پارامتر منسوخ شده است و تاثیری ندارد. برای اطلاعات بیشتر به اطلاعیه انصراف مراجعه کنید. |
origin | این پارامتر یک معیار امنیتی اضافی برای API IFrame فراهم می کند و فقط برای جاسازی های IFrame پشتیبانی می شود. اگر از IFrame API استفاده می کنید، به این معنی که مقدار پارامتر enablejsapi را روی 1 تنظیم می کنید، همیشه باید دامنه خود را به عنوان مقدار پارامتر origin مشخص کنید. |
playlist | این پارامتر فهرستی از شناسههای ویدیویی جدا شده با کاما را برای پخش مشخص میکند. اگر مقداری را مشخص کنید، اولین ویدیویی که پخش میشود VIDEO_ID مشخصشده در مسیر URL خواهد بود و ویدیوهای مشخصشده در پارامتر playlist پس از آن پخش خواهند شد. |
playsinline | این پارامتر کنترل میکند که ویدیوها به صورت درون خطی یا تمام صفحه در iOS پخش شوند. مقادیر معتبر عبارتند از:
|
rel | توجه: این پارامتر در تاریخ 25 سپتامبر 2018 یا پس از آن در حال تغییر است. قبل از تغییر، این پارامتر نشان میدهد که آیا پخشکننده باید ویدیوهای مرتبط را هنگام پایان پخش ویدیوی اولیه نشان دهد یا خیر.
rel روی 0 تنظیم شده باشد، ویدیوهای مرتبط از همان کانال ویدیویی که به تازگی پخش شده است می آیند. |
start | این پارامتر باعث می شود که پخش کننده شروع به پخش ویدیو در تعداد ثانیه معین از شروع ویدیو کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که مشابه تابع seekTo ، پخش کننده به دنبال نزدیکترین فریم کلیدی به زمانی که شما تعیین کرده اید می گردد. این بدان معنی است که گاهی اوقات ممکن است هد پخش درست قبل از زمان درخواستی، معمولاً بیش از دو ثانیه به دنبال آن باشد. |
widget_referrer | این پارامتر نشانی اینترنتی را که پخش کننده در آن جاسازی شده است مشخص می کند. هنگامی که پخش کننده YouTube در یک ویجت جاسازی شده است، این مقدار در گزارش YouTube Analytics استفاده می شود، و سپس آن ویجت در یک صفحه وب یا برنامه جاسازی می شود. در آن سناریو، پارامتر origin دامنه ارائهدهنده ابزارک را شناسایی میکند، اما YouTube Analytics نباید ارائهدهنده ویجت را به عنوان منبع ترافیک واقعی شناسایی کند. در عوض، YouTube Analytics از مقدار پارامتر widget_referrer برای شناسایی دامنه مرتبط با منبع ترافیک استفاده می کند. |
این سند نحوه جاسازی یک پخش کننده YouTube را در برنامه خود توضیح می دهد و همچنین پارامترهایی را که در پخش کننده تعبیه شده YouTube در دسترس هستند را تعریف می کند.
با افزودن پارامترها به URL IFrame، می توانید تجربه پخش را در برنامه خود سفارشی کنید. به عنوان مثال، میتوانید با استفاده از پارامتر autoplay
ویدیوها را به طور خودکار پخش کنید یا با استفاده از پارامتر loop
باعث پخش مکرر یک ویدیو شوید. همچنین میتوانید از پارامتر enablejsapi
برای فعال کردن پخشکننده از طریق API IFrame Player استفاده کنید.
این صفحه در حال حاضر تمام پارامترهای پشتیبانی شده در هر پخش کننده تعبیه شده YouTube را تعریف می کند. هر تعریف پارامتر، بازیکنانی را که از پارامتر مربوطه پشتیبانی می کنند، شناسایی می کند.
توجه: پخشکنندههای جاسازیشده باید دارای دیدی با ابعاد حداقل 200 پیکسل در 200 پیکسل باشند. اگر پخشکننده کنترلها را نمایش میدهد، باید به اندازهای بزرگ باشد که کنترلها را بهطور کامل نمایش دهد، بدون اینکه درگاه دید کمتر از حداقل اندازه باشد. ما توصیه می کنیم پخش کننده های 16:9 حداقل 480 پیکسل عرض و 270 پیکسل قد داشته باشند.
می توانید از یکی از روش های زیر برای جاسازی یک پخش کننده YouTube در برنامه خود و تعیین پارامترهای پخش کننده استفاده کنید. توجه داشته باشید که دستورالعملهای زیر نحوه جاسازی پخشکنندهای را نشان میدهد که یک ویدیو را بارگیری میکند. بخش زیر نحوه پیکربندی پخش کننده خود را برای بارگذاری لیست پخش یا ویدیوهای آپلود شده توسط کاربر توضیح می دهد.
<iframe>
یک پخش کننده را جاسازی کنید یک تگ <iframe>
را در برنامه خود تعریف کنید که در آن URL src
محتوایی را که پخش کننده بارگذاری می کند و همچنین سایر پارامترهای پخش کننده را که می خواهید تنظیم کنید مشخص می کند. پارامترهای height
و width
تگ <iframe>
ابعاد پخش کننده را مشخص می کند.
اگر عنصر <iframe>
را خودتان ایجاد کنید (به جای استفاده از API IFrame Player برای ایجاد آن)، می توانید پارامترهای پخش کننده را مستقیماً به انتهای 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>
دستورالعمل های IFrame Player API را دنبال کنید تا پس از بارگیری کد جاوا اسکریپت Player API، یک پخش کننده ویدیو را در صفحه وب یا برنامه خود قرار دهید. دومین پارامتر در سازنده برای پخش کننده ویدئو، یک شی است که گزینه های پخش کننده را مشخص می کند. در داخل آن شی، ویژگی playerVars
پارامترهای بازیکن را شناسایی می کند.
کد HTML و جاوا اسکریپت زیر یک مثال ساده را نشان می دهد که یک پخش کننده YouTube را در عنصر صفحه قرار می دهد که دارای مقدار id
ytplayer
است. تابع onYouTubePlayerAPIReady()
که در اینجا مشخص شده است، هنگامی که کد API IFrame Player بارگیری می شود، به طور خودکار فراخوانی می شود. این کد هیچ پارامتر پخش کننده ای را تعریف نمی کند و همچنین کنترل کننده های رویداد دیگر را تعریف نمی کند.
<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>
می توانید پخش کننده جاسازی شده خود را برای بارگیری یک ویدیو، یک لیست پخش یا ویدیوهای آپلود شده توسط کاربر پیکربندی کنید.
لیست زیر این گزینه ها را توضیح می دهد:
در حال بارگیری یک ویدیو
برای جاسازی IFrame، شناسه ویدیوی YouTube برای ویدیویی که میخواهید بارگیری کنید در URL
src
IFrame مشخص شده است.https://www.youtube.com/embed/VIDEO_ID
اگر از YouTube Data API (v3) استفاده میکنید، میتوانید با بازیابی شناسههای ویدیو از نتایج جستجو ، منابع آیتمهای فهرست پخش ، منابع ویدیویی یا منابع دیگر، این نشانیهای اینترنتی را به صورت برنامهنویسی بسازید. پس از دریافت شناسه ویدیو، متن
VIDEO_ID
را در URL های بالا با آن مقدار جایگزین کنید تا URL پخش کننده ایجاد شود.در حال بارگیری یک لیست پخش
پارامتر
listType
player را رویplaylist
تنظیم کنید. علاوه بر این، پارامتر پخش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 (v3) استفاده میکنید، میتوانید با بازیابی شناسههای فهرست پخش از نتایج جستجو ، منابع کانال یا منابع فعالیت ، این نشانیهای اینترنتی را به صورت برنامهنویسی بسازید. پس از دریافت شناسه لیست پخش، متن
PLAYLIST_ID
در URL بالا را با آن مقدار جایگزین کنید.بارگیری ویدیوهای آپلود شده توسط کاربر
پارامتر
listType
player را رویuser_uploads
تنظیم کنید. علاوه بر این، پارامتر پخشlist
را روی نام کاربری YouTube که می خواهید ویدیوهای آپلود شده آن بارگیری کنید، تنظیم کنید.https://www.youtube.com/embed?listType=user_uploads&list=USERNAME
تمام پارامترهای زیر اختیاری هستند.
مولفه های | |
---|---|
autoplay | این پارامتر مشخص می کند که آیا ویدیوی اولیه به طور خودکار هنگام بارگیری پخش کننده شروع به پخش می کند یا خیر. مقادیر پشتیبانی شده 0 یا 1 هستند. مقدار پیش فرض 0 است.اگر پخش خودکار را فعال کنید، پخش بدون هیچ گونه تعامل کاربر با پخش کننده انجام می شود. بنابراین جمعآوری و اشتراکگذاری دادههای پخش پس از بارگیری صفحه انجام میشود. |
cc_lang_pref | این پارامتر زبان پیش فرضی را که پخش کننده برای نمایش شرح ها استفاده می کند، مشخص می کند. مقدار پارامتر را روی کد زبان دو حرفی ISO 639-1 تنظیم کنید. اگر از این پارامتر استفاده کنید و همچنین پارامتر cc_load_policy را روی 1 تنظیم کنید، پخش کننده هنگام بارگیری پخش کننده، شرح ها را به زبان مشخص شده نشان می دهد. اگر پارامتر cc_load_policy را نیز تنظیم نکنید، شرحها بهطور پیشفرض نمایش داده نمیشوند، اما در صورتی که کاربر روشن کردن زیرنویسها را انتخاب کند، به زبان مشخص نمایش داده میشوند. |
cc_load_policy | تنظیم مقدار پارامتر روی 1 باعث میشود که زیرنویسهای بسته بهطور پیشفرض نشان داده شوند، حتی اگر کاربر زیرنویسها را خاموش کرده باشد. رفتار پیش فرض بر اساس اولویت کاربر است. |
color | این پارامتر رنگی را مشخص می کند که در نوار پیشرفت ویدیوی پخش کننده برای برجسته کردن مقدار ویدیویی که بیننده قبلاً دیده است استفاده می شود. مقادیر پارامترهای معتبر red و white هستند و بهطور پیشفرض، پخشکننده از رنگ قرمز در نوار پیشرفت ویدیو استفاده میکند. برای اطلاعات بیشتر در مورد گزینه های رنگ به وبلاگ YouTube API مراجعه کنید. |
controls | این پارامتر نشان می دهد که آیا کنترل های پخش کننده ویدیو نمایش داده می شوند:
|
disablekb | تنظیم مقدار پارامتر روی 1 باعث می شود پخش کننده به کنترل های صفحه کلید پاسخ ندهد. مقدار پیش فرض 0 است، به این معنی که کنترل های صفحه کلید فعال هستند. کنترلهای صفحه کلیدی که در حال حاضر پشتیبانی میشوند عبارتند از:
|
enablejsapi | تنظیم مقدار پارامتر روی 1 پخش کننده را قادر می سازد از طریق تماس های API IFrame Player کنترل شود. مقدار پیش فرض 0 است، به این معنی که پخش کننده را نمی توان با استفاده از آن API کنترل کرد.برای اطلاعات بیشتر در مورد IFrame API و نحوه استفاده از آن، به مستندات IFrame API مراجعه کنید. |
end | این پارامتر زمانی را که پخش کننده باید پخش ویدیو را متوقف کند، بر حسب ثانیه از شروع ویدیو اندازه گیری می کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که زمان از ابتدای ویدیو اندازه گیری می شود و نه از مقدار پارامتر start پخش یا پارامتر startSeconds که در توابع YouTube Player API برای بارگیری یا صف بندی یک ویدیو استفاده می شود. |
fs | تنظیم این پارامتر روی 0 از نمایش دکمه تمام صفحه در پخش کننده جلوگیری می کند. مقدار پیش فرض 1 است که باعث می شود دکمه تمام صفحه نمایش داده شود. |
hl | زبان رابط پخش کننده را تنظیم می کند. مقدار پارامتر یک کد زبان دو حرفی ISO 639-1 یا یک منطقه کاملاً مشخص شده است. به عنوان مثال، fr و fr-ca هر دو مقادیر معتبر هستند. سایر کدهای ورودی زبان، مانند برچسب های زبان IETF (BCP 47) نیز ممکن است به درستی مدیریت شوند.زبان رابط برای نکات ابزار در پخش کننده استفاده می شود و همچنین بر روی تراک عنوان پیش فرض تأثیر می گذارد. توجه داشته باشید که YouTube ممکن است بر اساس ترجیحات زبان فردی کاربر و در دسترس بودن تراکهای شرح، زبان آهنگ زیرنویس متفاوتی را برای یک کاربر خاص انتخاب کند. |
iv_load_policy | تنظیم مقدار پارامتر روی 1 باعث می شود حاشیه نویسی ویدیو به طور پیش فرض نشان داده شود، در حالی که تنظیم روی 3 باعث می شود حاشیه نویسی ویدیو به طور پیش فرض نشان داده نشود. مقدار پیش فرض 1 است. |
list | پارامتر list ، در ارتباط با پارامتر listType ، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند.
list و listType مشخص کنید، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد. |
listType | پارامتر listType ، در ارتباط با پارامتر list ، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند. مقادیر پارامتر معتبر عبارتند از playlist و user_uploads .اگر مقادیری را برای پارامترهای list و listType مشخص کنید، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.توجه: مقدار پارامتر سوم، search ، منسوخ شده است و از |
loop | در مورد یک پخش کننده ویدیو، تنظیم 1 باعث می شود که پخش کننده ویدیوی اولیه را بارها و بارها پخش کند. در مورد پخش کننده لیست پخش (یا پخش کننده سفارشی)، پخش کننده کل لیست پخش را پخش می کند و سپس در اولین ویدیو دوباره شروع می کند.مقادیر پشتیبانی شده 0 و 1 و مقدار پیش فرض 0 است.توجه: این پارامتر در تعبیههای IFrame پشتیبانی محدودی دارد. برای حلقه زدن یک ویدیو، مقدار پارامتر loop را روی 1 تنظیم کنید و مقدار پارامتر playlist را روی همان شناسه ویدیویی که قبلاً در URL API Player مشخص شده است تنظیم کنید:https://www.youtube.com/embed/VIDEO_ID?playlist=VIDEO_ID&loop=1 |
modestbranding | توجه: این پارامتر منسوخ شده است و تاثیری ندارد. برای اطلاعات بیشتر به اطلاعیه انصراف مراجعه کنید. |
origin | این پارامتر یک معیار امنیتی اضافی برای API IFrame فراهم می کند و فقط برای جاسازی های IFrame پشتیبانی می شود. اگر از IFrame API استفاده می کنید، به این معنی که مقدار پارامتر enablejsapi را روی 1 تنظیم می کنید، همیشه باید دامنه خود را به عنوان مقدار پارامتر origin مشخص کنید. |
playlist | این پارامتر فهرستی از شناسههای ویدیویی جدا شده با کاما را برای پخش مشخص میکند. اگر مقداری را مشخص کنید، اولین ویدیویی که پخش میشود VIDEO_ID مشخصشده در مسیر URL خواهد بود و ویدیوهای مشخصشده در پارامتر playlist پس از آن پخش خواهند شد. |
playsinline | این پارامتر کنترل میکند که ویدیوها به صورت درون خطی یا تمام صفحه در iOS پخش شوند. مقادیر معتبر عبارتند از:
|
rel | توجه: این پارامتر در تاریخ 25 سپتامبر 2018 یا پس از آن در حال تغییر است. قبل از تغییر، این پارامتر نشان میدهد که آیا پخشکننده باید ویدیوهای مرتبط را هنگام پایان پخش ویدیوی اولیه نشان دهد یا خیر.
rel روی 0 تنظیم شده باشد، ویدیوهای مرتبط از همان کانال ویدیویی که به تازگی پخش شده است می آیند. |
start | این پارامتر باعث می شود که پخش کننده شروع به پخش ویدیو در تعداد ثانیه معین از شروع ویدیو کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که مشابه تابع seekTo ، پخش کننده به دنبال نزدیکترین فریم کلیدی به زمانی که شما تعیین کرده اید می گردد. این بدان معنی است که گاهی اوقات ممکن است هد پخش درست قبل از زمان درخواستی، معمولاً بیش از دو ثانیه به دنبال آن باشد. |
widget_referrer | این پارامتر نشانی اینترنتی را که پخش کننده در آن جاسازی شده است مشخص می کند. هنگامی که پخش کننده YouTube در یک ویجت جاسازی شده است، این مقدار در گزارش YouTube Analytics استفاده می شود و سپس آن ویجت در یک صفحه وب یا برنامه جاسازی می شود. در آن سناریو، پارامتر origin دامنه ارائهدهنده ابزارک را شناسایی میکند، اما YouTube Analytics نباید ارائهدهنده ویجت را به عنوان منبع ترافیک واقعی شناسایی کند. در عوض، YouTube Analytics از مقدار پارامتر widget_referrer برای شناسایی دامنه مرتبط با منبع ترافیک استفاده می کند. |