Параметры YouTube проигрывателя

Из этой статьи вы узнаете, как встроить проигрыватель YouTube в приложение и какие параметры проигрывателя будут вам доступны.
Проигрыватель можно настроить с помощью различных параметров, которые добавляются в IFrame. Например, параметр autoplay используется, чтобы включить автоматическое воспроизведение видео, loop – для воспроизведения по кругу, а enablejsapi – чтобы включить JavaScript API. 

Ниже описаны все параметры, которые поддерживаются во встроенных проигрывателях YouTube.

Примечание: 

Окно просмотра встроенного проигрывателя должно быть не меньше 200 x 200 пикселей. Если в проигрывателе отображаются элементы управления, окно должно быть достаточно большим, чтобы полностью отобразить элементы управления, не сжимая окно просмотра меньше минимального размера. Минимальный размер окна просмотра для проигрывателей формата 16:9 составляет 480 х 270 пикселей.

Как встроить проигрыватель YouTube

Встраивание IFrame с помощью тегов <iframe>

Определите в приложении тег <iframe>, где URL src будет указывать контент, загружаемый проигрывателем, а также другие параметры. Параметры height и width тега <iframe> задают размеры проигрывателя.

Создавая элементы <iframe> самостоятельно – без помощи IFrame Player API, – вы можете добавить параметры проигрывателя непосредственно в конец URL:

http://www.youtube.com/embed/VIDEO_ID

Тег <iframe> ниже загружает проигрыватель размером 640x360 пикселей, который воспроизводит видео YouTube M7lc1UVf-VE. Так как в URL параметр autoplay имеет значение 1, воспроизведение видео начинается автоматически после загрузки проигрывателя.

<iframe id="ytplayer" type="text/html" width="640" height="360"
  src="http://www.youtube.com/embed/M7lc1UVf-VE?autoplay=1&origin=http://example.com"
  frameborder="0"/>

Встраивание IFrame с помощью IFrame Player API

Дождитесь загрузки кода JavaScript Player API, а затем следуйте инструкциям по использованию IFrame Player API. Настройки задаются вторым параметром в конструкторе проигрывателя (за них отвечает свойство playerVars).

Ниже приведен пример того, как при помощи HTML и JavaScript вставить проигрыватель 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>

Встроенный проигрыватель может загружать видеоролики, плейлисты, добавленный пользователем контент или результаты поиска по определенному запросу.

Подробное описание каждого из вариантов приведено ниже:

Как загрузить видео

При встраивании IFrame идентификатор видео на YouTube указывается в URL IFrame src.

http://www.youtube.com/embed/VIDEO_ID

Если вы используете YouTube Data API (v3), вы можете создать такие URL программными методами, извлекая идентификаторы из результатов поиска, плейлистов, видеоресурсов или других источников. Получив идентификатор, вставьте его вместо в URL выше VIDEO_ID.

Как загрузить плейлист

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

http://www.youtube.com/embed?listType=playlist&list=PLAYLIST_ID

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

http://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6

Если вы используете YouTube Data API (v3), вы можете создавать эти URL программными методами, извлекая идентификаторы плейлиста из результатов поиска, ресурсов канала или ресурсов действия. Получив идентификатор, вставьте его в URL выше вместо PLAYLIST_ID.

Как загрузить добавленные пользователем видео

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

http://www.youtube.com/embed?listType=user_uploads&list=USERNAME

Как загрузить результаты поиска по определенному запросу

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

http://www.youtube.com/embed?listType=search&list=QUERY

Параметры YouTube плеера

Все перечисленные ниже параметры являются необязательными.

Parameters

autoplay

Значения: 0 или 1 . Значение по умолчанию: 0

. Определяет, начинается ли воспроизведение исходного видео сразу после загрузки проигрывателя.

cc_load_policy

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

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

color

Этот параметр определяет цвет, которым выделяется просмотренная часть видео на индикаторе воспроизведения. Допустимые значения: red и white . По умолчанию используется красный цвет. Дополнительные сведения о цвете можно найти в блоге YouTube API.Примечание. Если для параметра color установлено значение white , параметр <a href="#modestbranding">modestbranding</a>

отключается.

controls

Значения: 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

.

disablekb

Значения: 0 или 1 . Значение по умолчанию: 0 . Значение 1

отключает клавиши управления проигрывателем. Предусмотрены следующие клавиши управления.

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

enablejsapi

Значения: 0 или 1 . Значение по умолчанию: 0 . Значение 1

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

end

Значение: положительное целое число. Этот параметр определяет время, измеряемое в секундах от начала видео, когда проигрыватель должен остановить воспроизведение видео. Обратите внимание на то, что время измеряется с начала видео, а не со значения параметра start или startSeconds

, который используется в YouTube Player API для загрузки видео или его добавления в очередь воспроизведения.

fs

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

скрывает кнопку полноэкранного режима.

hl

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

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

iv_load_policy

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

 – по умолчанию будут скрыты.

list

Параметр list в сочетании с параметром <a href="#listType">listType</a>

определяет загружаемый в проигрыватель контент.

  • Если параметр <a href="#listType">listType</a> имеет значение search , то значение параметра list

    определяет поисковый запрос.

  • Если параметр <a href="#listType">listType</a> имеет значение user_uploads , то значение параметра list

    определяет канал YouTube, из которого будут загружаться видео.

  • Если параметр <a href="#listType">listType</a> имеет значение playlist , то значение параметра list определяет идентификатор плейлиста YouTube. В начале идентификатора плейлиста должны стоять буквы PL

    , как показано ниже.

    http://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6
Примечание. Если вы задаете значения параметров <a href="#list">list</a> и listType

, в URL для встраивания IFrame не нужно указывать идентификатор видео.

listType

Параметр listType в сочетании с параметром <a href="#list">list</a> определяет загружаемый в проигрыватель контент. Допустимые значения: playlist , search и user_<wbr>uploads .Если вы задаете значения параметров <a href="#list">list</a> и listType

, в URL для встраивания IFrame не нужно указывать идентификатор видео.

loop

Значения: 0 или 1 . Значение по умолчанию: 0 . Если значение равно 1 , то одиночный проигрыватель будет воспроизводить видео по кругу, в бесконечном цикле. Проигрыватель плейлистов (или пользовательский проигрыватель) воспроизводит по кругу содержимое плейлиста. Примечание. Этот параметр имеет ограниченную поддержку в проигрывателе AS3 и при встраивании IFrame для загрузки проигрывателя AS3 или HTML5. В настоящее время параметр loop работает только в проигрывателе AS3, если он используется в сочетании с параметром <a href="#playlist">playlist</a> . Чтобы закольцевать одно видео, установите для параметра loop значение 1 , а для параметра <a href="#playlist">playlist</a>

укажите тот же идентификатор видео, что и в URL Player API:

http://www.youtube.com/v/<strong>VIDEO_ID</strong>?version=3&loop=1&playlist=<strong>VIDEO_ID</strong>

modestbranding

Этот параметр позволяет использовать проигрыватель YouTube, в котором не отображается логотип YouTube. Установите значение 1 , чтобы логотип YouTube не отображался на панели управления. Небольшая текстовая метка YouTube

будет отображаться в правом верхнем углу при наведении курсора на проигрыватель во время паузы

origin

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

.

playlist

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

.

playsinline

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

    : воспроизведение в полноэкранном режиме. В настоящее время это значение по умолчанию, впоследствии оно может быть изменено.

  • 1 : воспроизведение на странице для параметра UIWebViews , созданного с помощью свойства allowsInlineMediaPlayback со значением TRUE

    .

rel

Значения: 0 или 1 . Значение по умолчанию: 1

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

showinfo

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

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

start

Значение: положительное целое число. Если этот параметр определен, то проигрыватель начинает воспроизведение видео с указанной секунды. Обратите внимание, что, как и для функции <a href="https://developers.google.com/youtube/js_api_reference?hl=ru#seekTo">seekTo</a>

, проигрыватель начинает воспроизведение с ключевого кадра, ближайшего к указанному значению. Это означает, что в некоторых случаях воспроизведение начнется в момент, предшествующий заданному времени (обычно не более чем на 2 секунды).

01:30
31