YouTube параметры

ОБНОВЛЕНО 06.03.2019

(Все YouTube параметры чуть ниже) Действующих параметров на данное время всего 20 — как это видно на страницах © Google Developers. Естественно, не все их все используют, и, кстати, не все параметры могут работать друг с другом.

Чуть ниже я привел несколько примеров с параметрами. Выбрал самые нужные и часто используемые. А еще ниже показал на примере совмещение параметров для определенных случаев.

Минимальный размер окна просмотра для проигрывателей формата 16:9 составляет 480 х 270 пикселей.

1. ПАРАМЕТРЫ



1: modestbranding=1 [HTML5, AS3]:

Хотите убрать логотип YouTube в нижней панели? Это возможно! Просто используйте этот параметр. «1» означает что логотип в нижней панели будет скрыт. Вообще убрать логотип при помощи параметров нельзя.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?modestbranding=1;"frameborder="0" allowfullscreen></iframe>

по умолчанию

modestbranding=1


2: autoplay=1 + mute=1 [HTML5, AS3]:

С 2018 года для данного параметра установлено ограничение. Возможно, Вы заметите, что он не работает, но это не так, он работает, Вам просто нужно добавить к параметру дополнение (выключить звук): autoplay=1&mute=1.
Больше информации тут: Autoplay Policy Changes

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?autoplay=1&mute=1;"frameborder="0" allowfullscreen></iframe>


3 и 4: color=(red/white) и theme=(dark,light) [HTML5, AS3]:

color=(red,white)
Этот параметр определяет цвет, которым выделяется просмотренная часть видео на индикаторе воспроизведения. Допустимые значения: «red» и «white». По умолчанию используется красный цвет.
Примечание. Если для параметра color установлено значение «white», параметр «modestbranding» отключается.

theme=(dark,light)
Этот параметр определяет, будут ли отображаться элементы управления встроенным проигрывателем, такие как кнопка воспроизведения или регулятор громкости, на темной или светлой панели управления. Допустимые значения: dark и light. По умолчанию в проигрывателе отображается темная панель управления (dark).

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?color=white;theme=light;"frameborder="0" allowfullscreen></iframe>

по умолчанию

color=white;theme=light


5: iv_load_policy=(1/3) [HTML5, AS3]:

Значения: 1 или 3. Значение по умолчанию: 1. При значении 1 аннотации видео по умолчанию будут отображаться, а при значении 3 – по умолчанию будут скрыты.

Примечание. Проще говоря, все подсказки (ссылки) в видео будут скрыты.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?iv_load_policy=3;"frameborder="0" allowfullscreen></iframe>

iv_load_policy=1 (по умолчанию)

iv_load_policy=3


6: controls=(0/½) [HTML5, AS3]:

Значения: 0, 1 или 2. Значение по умолчанию: 1. Этот параметр определяет, будут ли отображаться элементы управления проигрывателем. При встраивании IFrame с загрузкой проигрывателя Flash он также определяет, когда элементы управления отображаются в проигрывателе и когда загружается проигрыватель:
controls=0 – элементы управления не отображаются в проигрывателе. При встраивании IFrame проигрыватель Flash загружается немедленно.
controls=1 – элементы управления отображаются в проигрывателе. При встраивании IFrame элементы управления отображаются немедленно и сразу же загружается проигрыватель Flash.
controls=2 – элементы управления отображаются в проигрывателе. При встраивании IFrame отображаются элементы управления, а проигрыватель Flash загружается после того, как пользователь начнет воспроизведение видео.

Примечание. Значения параметра 1 и 2 одинаково работают с точки зрения пользователя, однако значение controls=2 обеспечивает увеличение производительности по сравнению со значением controls=1 при встраивании IFrame. В настоящее время эти два значения все еще имеют некоторые визуальные различия в проигрывателе, такие как размер шрифта заголовка видео. Однако если разница между двумя значениями станет очевидной для пользователя, значение параметра по умолчанию может измениться с 1 на 2.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?controls=0;"frameborder="0" allowfullscreen></iframe>

controls=0

controls=2


7: showinfo=(0/1) [HTML5, AS3]:

Значения: 0 или 1. Значение по умолчанию: 1. При значении 0 проигрыватель перед началом воспроизведения не выводит информацию о видео, такую как название и автор видео.

Если вы устанавливаете значение 1, после загрузки плейлиста в проигрывателе отображаются значки всех видео в списке. Эта функция поддерживается только в проигрывателе AS3, который позволяет загружать плейлисты.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?showinfo=0;"frameborder="0" allowfullscreen></iframe>

showinfo=1 (по умолчанию)

showinfo=0


8: rel=(0/1) [HTML5, AS3]:

Значения: 0 или 1. Значение по умолчанию: 1. Этот параметр определяет, будут ли воспроизводиться похожие видео после завершения показа исходного видео.

Примечание. Ниже в одном из примеров поставьте ползунок на конец просмотра и посмотрите на результат.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?rel=0;"frameborder="0" allowfullscreen></iframe>

rel=1 (по умолчанию)

rel=0


9: autohide=(0/½) [HTML5, AS3]:

Значения: 2 (по умолчанию), 1 и 0. Определяет, будут ли элементы управления видео автоматически скрываться после начала воспроизведения.
По умолчанию (autohide=2) индикатор воспроизведения видео постепенно исчезает, а элементы управления (воспроизведение, регулировка громкости и т. д.) остаются видимыми.
Если параметр имеет значение 1, то индикатор воспроизведения видео и элементы управления скрываются после начала воспроизведения видео. Они появляются, только если пользователь наводит курсор на проигрыватель или нажимает клавишу на клавиатуре.
Если параметр имеет значение 0, индикатор воспроизведения видео и элементы управления будут видны на протяжении воспроизведения всего видео и в полноэкранном режиме.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?autohide=0;"frameborder="0" allowfullscreen></iframe>

* Данный параметр внедрен в настоящий плеер. Т.е. он бесполезен.


10 и 11: start=(180) и end=(280) [HTML5, AS3]:

start=(180)
Значение: положительное целое число. Если этот параметр определен, то проигрыватель начинает воспроизведение видео с указанной секунды. Обратите внимание, что, как и для функции seekTo, проигрыватель начинает воспроизведение с ключевого кадра, ближайшего к указанному значению. Это означает, что в некоторых случаях воспроизведение начнется в момент, предшествующий заданному времени (обычно не более чем на 2 секунды).

end=(280)
Значение: положительное целое число. Этот параметр определяет время, измеряемое в секундах от начала видео, когда проигрыватель должен остановить воспроизведение видео. Обратите внимание на то, что время измеряется с начала видео, а не со значения параметра start или startSeconds, который используется в YouTube Player API для загрузки видео или его добавления в очередь воспроизведения.

Примечание. Эти параметры можно использовать вместе. Даже иногда нужно, чтобы точно выделить момент в определенном видео. Числа определяются в секундах, т.е. 180 = 3 мин.

ПРИМЕР:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?start=135;end=145;"frameborder="0" allowfullscreen></iframe>

start=135

start=135;end=145


12: playsinline=(½) [HTML5, AS3]:

Этот параметр определяет воспроизведение видео на странице или в полноэкранном режиме в проигрывателе HTML5 для iOS. Допустимые значения:

0: воспроизведение в полноэкранном режиме. В настоящее время это значение по умолчанию, впоследствии оно может быть изменено.
1: воспроизведение на странице для параметра UIWebViews, созданного с помощью свойства allowsInlineMediaPlayback со значением TRUE.


13: loop=(0/1) [HTML5, AS3]:

Значения: 0 или 1. Значение по умолчанию: 0. Если значение равно 1, то одиночный проигрыватель будет воспроизводить видео по кругу, в бесконечном цикле. Проигрыватель плейлистов (или пользовательский проигрыватель) воспроизводит по кругу содержимое плейлиста.

Примечание. Этот параметр имеет ограниченную поддержку в проигрывателе AS3 и при встраивании IFrame для загрузки проигрывателя AS3 или HTML5. В настоящее время параметр loop работает только в проигрывателе AS3, если он используется в сочетании с параметром playlist. Чтобы закольцевать одно видео, установите для параметра loop значение 1, а для параметра playlist укажите тот же идентификатор видео, что и в URL Player API:

https://www.youtube.com/v/VIDEO_ID?version=3&loop=1&playlist=VIDEO_ID


14: cc_load_policy=1 [HTML5, AS3]:

Значения: 1. Значение по умолчанию определяется настройками пользователя. Значение 1 вызывает отображение закрытых титров по умолчанию даже в том случае, если пользователь отключил титры.


15: fs=(0/1) [HTML5, AS3]:

Значения: 0 или 1. Значение по умолчанию 1 отображает кнопку полноэкранного режима. Значение 0 скрывает кнопку полноэкранного режима.


16: disablekb=(0/1) [HTML5, AS3]:

Значения: 0 или 1. Значение по умолчанию: 0. Значение 1 отключает клавиши управления проигрывателем. Предусмотрены следующие клавиши управления.
Пробел: воспроизведение/пауза
Стрелка влево: вернуться на 10% в текущем видео
Стрелка вправо: перейти на 10% вперед в текущем видео
Стрелка вверх: увеличить громкость
Стрелка вниз: уменьшить громкость


17: enablejsapi=(0/1) [HTML5, AS3]:

Значения: 0 или 1. Значение по умолчанию: 0. Значение 1 включает API Javascript. Дополнительные сведения об API Javascript и его использовании см. в документации по API JavaScript.


18: hl=ru [HTML5, AS3]:

Определяет язык интерфейса проигрывателя. Для этого параметра используется (loc.gov/standards/iso639-2/php/code_list.php) — двухбуквенный код ISO 639-1, хотя такие коды языков, как теги IETF (BCP 47), также могут обрабатываться корректно.

Язык интерфейса используется для всплывающих подсказок в проигрывателе, а также влияет выбор языка субтитров по умолчанию. YouTube может выбрать другой язык субтитров для конкретного пользователя на основе его индивидуальных предпочтений и при наличии субтитров на этом языке.


19: list=(PLAYLIST_ID/USERNAME) [HTML5, AS3]:

Параметр list в сочетании с параметром listType определяет загружаемый в проигрыватель контент.
Если параметр listType имеет значение search, то значение параметра list определяет поисковый запрос.
Если параметр listType имеет значение user_uploads, то значение параметра list определяет канал YouTube, из которого будут загружаться видео.
Если параметр listType имеет значение playlist, то значение параметра list определяет идентификатор плейлиста YouTube. В начале идентификатора плейлиста должны стоять буквы PL, как показано ниже.

https://www.youtube.com/embed?listType=playlist&list=PLNzjF6FaYe0JPIP_5MieaphX3Okqgeyb5

Примечание. Если вы задаете значения параметров list и listType, в URL для встраивания IFrame не нужно указывать идентификатор видео.


20: listType=(playlist/search/user_uploads) [HTML5, AS3]:

Параметр listType в сочетании с параметром list определяет загружаемый в проигрыватель контент. Допустимые значения: playlist, search и user_uploads.

Если вы задаете значения параметров list и listType, в URL для встраивания IFrame не нужно указывать идентификатор видео.


21: origin=https://ВашДомен.ru [HTML5, AS3]:

Этот параметр обеспечивает дополнительные меры безопасности для IFrame API и поддерживается только при встраивании IFrame. Если вы используете IFrame API, т. е. устанавливаете для параметра enablejsapi значение 1, обязательно укажите свой домен как значение параметра origin.


22: playlist=VIDEO_ID [HTML5, AS3]:

Значение представляет собой разделенный запятыми список идентификаторов видео для воспроизведения. Если вы указываете значение, сначала воспроизводится видео, указанное как VIDEO_ID в URL, а затем видео, указанные в параметре playlist.


2. ПРАКТИКА


Идеальный вариант для видеопродажников:

Скрываем нижнюю панель + когда видео закончится, похожие видео не будут показываться, чтобы не отвлекать. Также скрываем подсказки, если они есть. Если хотите запустить видео автоматически, то используйте этот параметр autoplay=1&mute=1, но в таком случае, ЗВУК БУДЕТ ВЫКЛЮЧЕН(включить можно). Убрать эту идиотскую панель с предлагаемыми видео НЕВОЗМОЖНО пока (монополист делает что хочет 🙂 )

Примечание. В таком случае, скрыть логотип YouTube Вы не сможете.

<iframe src="https://www.youtube.com/embed/XINsLSka_es?modestbranding=1;rel=0;controls=0;showinfo=0;autoplay=1&mute=1;iv_load_policy=3;" width="560" height="315" frameborder="0" allowfullscreen></iframe>
Идеальный вариант для блога:

Скрываем логотип внизу и обе панели (управления и инфо) пропадают, если убрать курсор с области видеоплеера.

<iframe src="https://www.youtube.com/embed/XINsLSka_es?modestbranding=1;rel=0;controls=1;" width="560" height="315" frameborder="0" allowfullscreen></iframe>
Как загрузить плейлист:

Задайте параметру listType значение playlist, а для list установите идентификатор плейлиста, который вы хотите загрузить.

Обратите внимание на то, что в начале идентификатора должны стоять буквы PL, как показано ниже:

<iframe src="https://www.youtube.com/embed/XINsLSka_es?listType=playlist&list=PLC77007E23FF423C6;" frameborder="0" allowfullscreen></iframe>
Как загрузить добавленные пользователем видео:

Задайте параметру listType значение user_uploads, а list – имя пользователя YouTube, добавленные видео которого вы хотите загрузить.

<iframe src="https://www.youtube.com/embed/XINsLSka_es?listType=user_uploads&list=USERNAME;" frameborder="0" allowfullscreen></iframe>

Поделиться или сохранить: