Плейлисты

Поддерживаются два вида плейлистов:

Динамические — список ID видео передаётся в URL-параметре. Удобно для формирования плейлиста на лету.
Статические — плейлист создаётся в панели управления Kinescope и указывается по ID.

Динамический плейлист

Перечислите ID видео через запятую в параметре video_ids:


<iframe
  src="https://kinescope.io/playlist?video_ids=ID1,ID2,ID3"
  allow="autoplay; fullscreen; picture-in-picture; encrypted-media; gyroscope; accelerometer; clipboard-write; screen-wake-lock;"
  style="border: none;"
></iframe>

В браузерах есть ограничения на длину URL. Для больших плейлистов используйте статические плейлисты.

Статический плейлист

Укажите ID плейлиста:


<iframe
  src="https://kinescope.io/pl/PLAYLIST_ID"
  allow="autoplay; fullscreen; picture-in-picture; encrypted-media; gyroscope; accelerometer; clipboard-write; screen-wake-lock;"
  style="border: none;"
></iframe>

Использование с IFrame API

При создании плеера через IFrame API используйте те же URL-адреса в параметре url:


function onKinescopeIframeAPIReady(playerFactory) {
  playerFactory
    .create('player', {
      url: 'https://kinescope.io/playlist?video_ids=ID1,ID2,ID3',
      behavior: {
        playlist: {
          autoSwitch: true,
          loop: false,
        },
      },
    })
    .then((player) => {
      player.on(player.Events.CurrentTrackChanged, (event) => {
        console.log('Текущий ролик:', event.data.item.id);
      });
 
      player.on(player.Events.Ended, () => {
        console.log('Плейлист завершён');
      });
    });
}

Управление плейлистом

Для переключения между роликами в плейлисте используйте методы IFrame Player API:

Метод	Описание
`next()`	Переключить на следующий ролик.
`previous()`	Переключить на предыдущий ролик.
`switchTo(id)`	Переключить на ролик с указанным ID.
`getPlaylistItem()`	Получить информацию о текущем ролике.