مولفه های |
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 برای اطلاعات بیشتر در مورد گزینه های رنگ به .
توجه: تنظیم colorپارامتر به whiteرا غیرفعال خواهد کرد 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 Player API . مقدار پیش فرض است 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پارامتر، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند.
- اگر listTypeمقدار پارامتر است user_uploads، سپس listمقدار پارامتر کانال YouTube را مشخص می کند که ویدیوهای آپلود شده آن بارگذاری می شوند.
- اگر listTypeمقدار پارامتر است playlist، سپس listمقدار پارامتر یک شناسه لیست پخش YouTube را مشخص می کند. در مقدار پارامتر، باید شناسه لیست پخش را با حروف اضافه کنید PLهمانطور که در مثال زیر نشان داده شده است.
|
توجه: اگر مقادیری را برای listو listTypeپارامترها، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.
|
listType
|
در listTypeپارامتر، در ارتباط با listپارامتر، محتوایی را که در پخش کننده بارگذاری می شود، مشخص می کند. مقادیر پارامتر معتبر هستند playlistو user_uploads.
اگر مقادیری را برای listو listTypeپارامترها، URL جاسازی شده IFrame نیازی به تعیین شناسه ویدیو ندارد.
توجه: یک مقدار پارامتر سوم، search، شده منسوخ است و از این تاریخ دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 . |
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
|
این پارامتر به شما امکان میدهد از پخشکننده YouTube استفاده کنید که نشانواره YouTube را نشان نمیدهد. مقدار پارامتر را روی 1برای جلوگیری از نمایش لوگوی YouTube در نوار کنترل. توجه داشته باشید که کوچک YouTubeهنگامی که نشانگر ماوس کاربر روی پخشکننده قرار میگیرد، برچسب متن همچنان در گوشه سمت راست بالای یک ویدیوی مکث شده نمایش داده میشود. |
origin
|
این پارامتر یک معیار امنیتی اضافی برای API IFrame فراهم می کند و فقط برای جاسازی های IFrame پشتیبانی می شود. اگر از IFrame API استفاده می کنید، به این معنی است که در حال تنظیم آن هستید enablejsapiمقدار پارامتر به 1، همیشه باید دامنه خود را به عنوان علامت مشخص کنید originمقدار پارامتر |
playlist
|
این پارامتر فهرستی از شناسههای ویدیویی جدا شده با کاما را برای پخش مشخص میکند. اگر مقداری را مشخص کنید، اولین ویدیویی که پخش میشود همان خواهد بود VIDEO_IDمشخص شده در مسیر URL، و ویدیوهای مشخص شده در playlistپارامتر پس از آن پخش می شود. |
playsinline
|
این پارامتر کنترل میکند که ویدیوها به صورت درون خطی یا تمام صفحه در iOS پخش شوند. مقادیر معتبر عبارتند از:
- 0: نتایج در پخش تمام صفحه. این در حال حاضر مقدار پیشفرض است، اگرچه پیشفرض ممکن است تغییر کند.
- 1: نتایج پخش درون خطی برای مرورگرهای موبایل و برای WebViewsایجاد شده با allowsInlineMediaPlaybackویژگی تنظیم شده است YES.
|
rel
|
توجه: این پارامتر است حال تغییر در تاریخ 25 سپتامبر 2018 یا پس از آن در .
قبل از تغییر، این پارامتر نشان میدهد که آیا پخشکننده باید ویدیوهای مرتبط را هنگام پایان پخش ویدیوی اولیه نشان دهد یا خیر.
- اگر مقدار پارامتر روی 1، که مقدار پیش فرض است، پخش کننده ویدیوهای مرتبط را نشان می دهد.
- اگر مقدار پارامتر روی 0، سپس پخش کننده ویدیوهای مرتبط را نشان نمی دهد.
پس از تغییر، نمیتوانید ویدیوهای مرتبط را غیرفعال کنید. در عوض، اگر relپارامتر تنظیم شده است 0، ویدیوهای مرتبط از همان کانال ویدیویی که به تازگی پخش شده است می آیند. |
start
|
این پارامتر باعث می شود که پخش کننده شروع به پخش ویدیو در تعداد ثانیه معین از شروع ویدیو کند. مقدار پارامتر یک عدد صحیح مثبت است. توجه داشته باشید که مشابه seekToعملکرد، پخش کننده به دنبال نزدیک ترین فریم کلیدی به زمانی که شما مشخص کرده اید می گردد. این به این معنی است که گاهی اوقات ممکن است هد پخش درست قبل از زمان درخواستی، معمولاً بیش از دو ثانیه به دنبال آن باشد. |
widget_referrer
|
این پارامتر URL جایی که پخش کننده در آن جاسازی شده است را مشخص می کند. هنگامی که پخش کننده YouTube در یک ویجت جاسازی شده است، این مقدار در گزارش YouTube Analytics استفاده می شود و سپس آن ویجت در یک صفحه وب یا برنامه جاسازی می شود. در آن سناریو، originپارامتر دامنه ارائهدهنده ویجت را مشخص میکند، اما YouTube Analytics نباید ارائهدهنده ویجت را به عنوان منبع ترافیک واقعی شناسایی کند. در عوض، YouTube Analytics از widget_referrerمقدار پارامتر برای شناسایی دامنه مرتبط با منبع ترافیک. |