Данное руководство предназначено для использования и управления видеоблоками Areels на сайтах третьих сторон. Использование API становится возможным только при установке в секции <head> javascript-кода Areels, который можно получить в панели управления приложения Areels при добавлении сайта:
<script type="text/javascript" src="https://player.areels.ru/tags/[SITE_ID].js" data-integrity="[SITE_TOKEN]" referrerpolicy="no-referrer-when-downgrade" id="areels-tag-[SITE_ID]"></script>
Если вы просто добавили код видео на сайт (iframe), API для управление плеером будет недоступно.
После загрузки страницы сайта, создается глобальный объект для управления видеоплеерами на странице:
window.VideoUnitsManager
getPlayers([objects])
const players = VideoUnitsManager.getPlayers() // [1276865835, 335099043]
const players = VideoUnitsManager.getPlayers(true) // [EmbedPlayer, InlinePlayer]
Возвращает массив с идентификаторами всех плееров Areels на странице (в порядке загрузки содержимого плеера). Если передать параметр objects = true, вместо идентификаторов плеера вернет экземпляры объектов плеера.
getPlayer([id])
const videoPlayer = VideoUnitsManager.getPlayer(player_id)
Возвращает экземпляр видео плеера по его идентификатору. Если опустить идентификатор, возвращается первый загруженный плеер на странице, это может быть удобно, если на странице предусмотрен только один видеоплеер.
ready
VideoUnitsManager.on("ready", readyCallback)
Событие вызывается после загрузки страницы, когда все плееры на странице готовы к воспроизведению видео.
Видеоплеер Areels. Может быть добавлен на страницу через менеджер видеоблоков в панели управления Areels, вставкой кода видеоблока (javascript), или вставкой кода конкретного видео (iframe).
play() - возобновить воспроизведение
videoPlayer.play()
pause() - остановить воспроизведение
videoPlayer.pause()
mute() - выключить звук
videoPlayer.mute()
unmute() - включить звук
videoPlayer.unmute()
volume(level) - установить громкость (0 - 100)
videoPlayer.volume(50)
seek(seconds) - перемотать видео на позицию (сек.)
videoPlayer.seek(10)
error - ошибка плеера
player.on("error", handlePlayerError)
ready - видео готово к воспроизведению
player.on("ready", handlePlayerReady)
played - видео доиграло до конца
player.on("played", handlePlayerPlayed)
visible - видео скрылось с экрана
player.on("visible", handlePlayerVisible)
subscribe - пользователь оставил email
player.on("subscribe", handlePlayerSubscribe)
resize - размер плеера изменился
player.on("resize", handlePlayerResize)
pause - плеер поставлен на паузу
player.on("pause", handlePlayerPause)
play - плеер начал воспроизводить видео
player.on("play", handlePlayerPlay)
seek - видео было перемотано
player.on("seek", handlePlayerSeek)
ctaclick - пользователь кликнул на кнопку со ссылкой
player.on("ctaclick", handlePlayerCtaclick)
volumechange - изменилась громкость
player.on("volumechange", handlePlayerVolumechange)
qualitychange - изменилость качество видео
player.on("qualitychange", handlePlayerQualitychange)
speedchange - изменилась скорость воспроизведения
player.on("speedchange", handlePlayerSpeedchange)
mute - выключен звук
player.on("mute", handlePlayerMute)
unmute - включен звук
player.on("unmute", handlePlayerUnmute)
fullscreen - переключен полноэкранный режим
player.on("fullscreen", handlePlayerFullscreen)