Boomstream - профессиональная видеоплатформа для бизнеса: размещайте видео на сайте, проводите прямые трансляции, защищайте контент DRM и водяными знаками, продавайте доступ и интегрируйте к себе через API. Инфраструктура в России, тестовый период 30 дней.

Параметры для плеера

плеер

Параметры настройки плеера Boomstream: полный список URL-параметров

Коротко о главном:
Для настройки плеера Boomstream добавляйте параметры к ссылке на видео через знак ? для первого параметра и & для последующих. Основные параметры: autoplay=1 (автостарт), title=0 (скрыть название), rewind=0 (запрет перемотки), background=1 (фоновое видео), controls=0 (скрыть элементы управления). Параметры позволяют кастомизировать поведение плеера, настраивать сквозную авторизацию и управлять отображением элементов интерфейса.

Как добавлять параметры к ссылке плеера

Параметры добавляются к URL-адресу видео после знака вопроса ?. Если параметров несколько, они разделяются амперсандом &.

Базовый синтаксис:

Text 
https://play.boomstream.com/VCcNtuiw?параметр1=значение1&параметр2=значение2

Примеры:

Один параметр:

Text 
https://play.boomstream.com/VCcNtuiw?title=0

Несколько параметров:

Text 
https://play.boomstream.com/VCcNtuiw?title=0&rewind=0&controls=0

Интерфейс настройки параметров плеера в Boomstream

Полный список параметров плеера

Воспроизведение и поведение

Параметр Значение Описание
autoplay 1 Автостарт воспроизведения. Всегда запускается без звука из-за политик безопасности браузеров
muted 1 Выключение звука при воспроизведении. Автоматически подставляется при использовании autoplay=1
loop 1 Циклическое воспроизведение видео
speed 0.5, 1, 1.25, 1.5, 2 Скорость воспроизведения видео
start Число в секундах Время, с которого начинается воспроизведение (например, start=60 — старт с 1 минуты)
rewind 0 Запрет перемотки видео (для обучающего контента)
autopause 1 Автоматическая пауза, когда плеер выходит из видимой области экрана

Отображение элементов интерфейса

Параметр Значение Описание
title 0 Скрыть название видео
controls 0 Скрыть все элементы управления и отключить горячие клавиши
ui_disable 1 Полностью отключить все элементы управления
ui_fullscreen 0 / 1 Выключить / включить кнопку полноэкранного режима
ui_settings 0 / 1 Выключить / включить кнопку настроек
ui_timeline 0 / 1 Выключить / включить временную шкалу (прогресс-бар)
ui_play 0 / 1 Выключить / включить кнопку воспроизведения
ui_time 0 / 1 Выключить / включить отображение времени
ui_volume 0 / 1 Выключить / включить регулятор громкости
ui_speed 0 / 1 Выключить / включить кнопку скорости
ui_controls 1 Принудительно показать элементы управления при загрузке

Внешний вид и размеры

Параметр Значение Описание
color HEX-код цвета (например, %23ff6600) Цвет фона плеера под постером
size contain, cover, auto Режим размещения обложки: contain — масштабирование с сохранением пропорций (по умолчанию), cover — заполнение с обрезкой, auto — заполнение с сохранением пропорций
use_full_height 1 / 0 1 — плеер занимает всю высоту контейнера (адаптивный по ширине и высоте), 0 — режим пропорции (адаптивный только по ширине)
border-radius Значение в CSS (например, 20px) Скругление углов плеера (при использовании JS-кода: data-boomstream-border-radius="20px")

Специальные функции

Параметр Значение Описание
background 1 Режим фонового видео. Объединяет параметры: title=0, autoplay=1, muted=1, controls=0, loop=1, autopause=0
preload 0 Показывать виджет оплаты, ввода пароля или формы регистрации сразу при загрузке плеера
display_playlist 1 Отображение плейлиста при загрузке плеера
airplay 1 Включить функцию AirPlay для устройств macOS и iOS (не работает с водяными знаками)
auth no Виджет пароля/оплаты появляется при каждом обновлении страницы (без сохранения сессии)

Авторизация и данные пользователя

Параметр Значение Описание
id_recovery Хеш или пароль Сквозная авторизация в доступе по паролю
buyer[email] Email (например, test@test.ru) Email покупателя для сквозной авторизации
buyer[name] Имя (URL-encoded) Имя покупателя для сквозной авторизации
password_button Текст (URL-encoded) Переименование кнопки ввода пароля
referrer URL (URL-encoded) Точный адрес referrer для аналитики

Примеры использования параметров

Фоновое видео на сайте

Для создания фонового видео без элементов управления используйте параметр background=1:

Text 
https://play.boomstream.com/VCcNtuiw?background=1

Этот параметр автоматически применяет: автостарт, без звука, без элементов управления, зацикливание.

Обучающий курс без возможности перемотки

Для образовательного контента, где важна последовательность просмотра:

Text 
https://play.boomstream.com/VCcNtuiw?rewind=0&title=0

Минималистичный плеер

Для встраивания с минимальным интерфейсом:

Text 
https://play.boomstream.com/VCcNtuiw?controls=0&title=0

Сквозная авторизация с данными ученика

Для автоматической авторизации и отображения водяных знаков:

Text 
https://play.boomstream.com/VCcNtuiw?buyer[email]=student@example.com&buyer[name]=Иван%20Петров

Кастомизация внешнего вида

Для подстройки под дизайн сайта:

Text 
https://play.boomstream.com/VCcNtuiw?color=%23ff6600&size=cover&border-radius=20px

Важные замечания

URL-кодирование специальных символов:

  • Пробелы заменяйте на %20
  • Символ # в HEX-цветах заменяйте на %23
  • Символ : в URL заменяйте на %3A
  • Символ / в URL заменяйте на %2F

Совместимость параметров:
Некоторые параметры могут конфликтовать друг с другом. Например, controls=0 отключает все элементы управления, поэтому отдельные параметры ui_* не будут иметь эффекта.

Ограничения AirPlay:
Функция AirPlay автоматически отключается при активации защиты водяными знаками из-за технических ограничений протокола.

Автостарт и звук:
Современные браузеры блокируют автовоспроизведение видео со звуком. Параметр autoplay=1 работает только в сочетании с muted=1.

Частые вопросы (FAQ)

Как отключить все элементы управления плеера?
Используйте параметр controls=0 для полного отключения элементов управления и горячих клавиш. Для более тонкой настройки используйте отдельные параметры ui_fullscreen=0, ui_settings=0, ui_timeline=0 и т.д.

Можно ли сделать фоновое видео с автоматическим воспроизведением?
Да, используйте параметр background=1. Он автоматически настраивает плеер для фонового режима: автостарт без звука, зацикливание, без элементов управления.

Как запретить зрителям перематывать видео?
Добавьте параметр rewind=0 к ссылке на видео. Это полезно для обучающих курсов, где важна последовательность просмотра материала.

Как изменить цвет фона плеера?
Используйте параметр color с HEX-кодом цвета в URL-кодировке. Например, оранжевый цвет: color=%23ff6600 (где %23 — это закодированный символ #).

Можно ли запустить видео с определённого момента?
Да, используйте параметр start с указанием времени в секундах. Например, start=60 запустит видео с 1-й минуты.

Как настроить сквозную авторизацию?
Используйте параметры buyer[email] и buyer[name] для передачи данных пользователя. Для авторизации по паролю используйте id_recovery=hash, где hash — пароль доступа.

Как сделать плеер адаптивным по высоте?
Используйте параметр use_full_height=1. Плеер займёт всю высоту родительского контейнера и будет адаптивным по ширине и высоте.

Можно ли переименовать кнопку ввода пароля?
Да, используйте параметр password_button с URL-кодированным текстом. Например, password_button=Получить%20доступ (где %20 — пробел).

Как отключить автоматическую паузу при прокрутке?
Используйте параметр autopause=0. По умолчанию плеер ставит видео на паузу, когда выходит из видимой области экрана.

Можно ли изменить размер обложки в плеере?
Да, используйте параметр size со значениями: contain (масштабирование с сохранением пропорций), cover (заполнение с обрезкой), auto (заполнение с сохранением пропорций).

Как передать referrer для аналитики?
Используйте параметр referrer с URL-кодированным адресом. Например, referrer=https%3A%2F%2Fvashdomen.ru%2Fcatalog%2F (где %3A — двоеточие, %2F — слэш).

Работают ли параметры с iframe-встраиванием?
Да, параметры добавляются к URL в атрибуте src тега <iframe>. Например: <iframe src="https://play.boomstream.com/VCcNtuiw?autoplay=1&muted=1"></iframe>.

Можно ли комбинировать параметры с JS-кодом плеера?
Да, параметры можно использовать как в прямых ссылках, так и в JS-коде встраивания. Для JS-кода некоторые параметры передаются через data-атрибуты (например, data-boomstream-border-radius).