پارامترهای پخش کنندهYouTube

مولفه های

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همانطور که در مثال زیر نشان داده شده است.

https://www.youtube.com/embed?
listType=playlist
&list=PLC77007E23FF423C6
اگر listTypeمقدار پارامتر است search، سپس listمقدار پارامتر عبارت جستجو را مشخص می کند. توجه: این عملکرد منسوخ شده است و از آن زمان دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 .

توجه: اگر مقادیری را برای 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مقدار پارامتر برای شناسایی دامنه مرتبط با منبع ترافیک.

مولفه های
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همانطور که در مثال زیر نشان داده شده است.
https://www.youtube.com/embed? listType=playlist &list=PLC77007E23FF423C6 اگر listTypeمقدار پارامتر است search، سپس listمقدار پارامتر عبارت جستجو را مشخص می کند. توجه: این عملکرد منسوخ شده است و از آن زمان دیگر پشتیبانی نخواهد شد 15 نوامبر 2020 . توجه: اگر مقادیری را برای 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مقدار پارامتر برای شناسایی دامنه مرتبط با منبع ترافیک.