Из этой статьи вы узнаете, как встроить проигрыватель 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 плеера

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

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