Плагин Boomstream для 1С-Битрикс: встраивание плеера через визуальный редактор
Коротко о главном:
Плагин Boomstream для 1С-Битрикс позволяет встраивать защищённый видеоплеер на страницы сайта через визуальный редактор без написания кода. Установка — через маркетплейс Битрикс. Для публикации скопируйте ссылку на видео из личного кабинета Boomstream (https://play.boomstream.com/xxxxx) и вставьте в поле «Источник видео» в редакторе страницы. Далее настройте параметры: адаптивность, автостарт, запрет перемотки, передачу данных пользователя и другие опции.
Что даёт плагин
Плагин решает основную проблему при работе с Битрикс — необходимость вручную писать HTML-код для встраивания плеера. Контент-менеджеры и администраторы сайта могут добавлять видео через стандартный визуальный редактор, выбирая нужные параметры из списка.
Возможности:
- Встраивание плеера без знания HTML и JavaScript;
- Настройка параметров воспроизведения через интерфейс;
- Автоматическая передача email и ФИО авторизованных пользователей для сквозной авторизации;
- Адаптивное отображение на всех устройствах;
- Совместимость с ограничениями доступа (оплата, пароль, форма регистрации).
Ссылка на плагин в маркетплейсе: https://marketplace.1c-bitrix.ru/solutions/boomstream.player/
Установка плагина
Установка выполняется стандартным способом через маркетплейс 1С-Битрикс:
- Откройте маркетплейс в административной панели Битрикс;
- Найдите решение Boomstream Player или перейдите по прямой ссылке;
- Нажмите «Установить» и следуйте инструкциям мастера установки;
- После установки компонент появится в визуальном редакторе страниц.
Никакой дополнительной настройки на стороне сервера не требуется — плагин работает сразу после установки.
Как опубликовать плеер на странице
Процесс встраивания видео занимает меньше минуты:
- Откройте личный кабинет Boomstream и скопируйте ссылку на нужное видео. Ссылка имеет вид
https://play.boomstream.com/xxxxx, гдеxxxxx— код медиа; - Откройте страницу сайта в визуальном редакторе Битрикс;
- Добавьте компонент плеера Boomstream в нужное место страницы;
- Вставьте скопированную ссылку в поле «Источник видео»;
- Настройте параметры воспроизведения и отображения;
- Сохраните страницу.
Плеер отобразится на странице с выбранными настройками.
Параметры плеера
Все параметры настраиваются через интерфейс компонента. Ниже — полный список доступных опций с пояснениями.
Основные настройки
| Параметр | Описание |
|---|---|
| Автостарт видео | Видео запускается автоматически при загрузке страницы, но с выключенным звуком. Это требование современных браузеров — автостарт со звуком блокируется. |
| Скрыть название | Название видео не отображается в плеере. Полезно, когда заголовок уже есть в тексте страницы и дублирование не нужно. |
| Сделать плеер адаптивным | Плеер занимает 100% ширины контейнера и адаптируется под размер экрана. Высота пересчитывается автоматически с сохранением пропорций 16:9. Несовместим с параметром «Размер видео». |
| Запретить перемотку | Скрывает полосу таймлайна и отключает возможность перемотки. Остальные элементы управления (пауза, громкость, полноэкранный режим) остаются доступными. Полезно для обучающих курсов. |
| Показать виджет при загрузке плеера | Если видео защищено оплатой, паролем или формой регистрации, виджет ограничения доступа отобразится сразу при загрузке страницы, без необходимости нажимать Play. |
| Контролы плеера принудительно | Элементы управления плеером отображаются постоянно, а не скрываются через несколько секунд бездействия. |
| Плейлист при загрузке плеера | Если видео входит в плейлист, список всех видео плейлиста отобразится сразу при загрузке, а не по нажатию на кнопку. |
Передача данных пользователя
Эти параметры используются для сквозной авторизации — автоматической подстановки данных авторизованного пользователя сайта в плеер Boomstream. Работает при ограничении доступа через сбор данных.
| Параметр | Описание |
|---|---|
| Передача email пользователя в плеер | Email текущего авторизованного пользователя Битрикс автоматически передаётся в форму регистрации Boomstream. Зрителю не нужно вводить email вручную. |
| Передача ФИО пользователя в плеер | ФИО текущего авторизованного пользователя передаётся в плеер. Может использоваться для отображения в водяных знаках. |
Настройки воспроизведения
| Параметр | Описание |
|---|---|
| Начать с | Указывает секунду, с которой начинается воспроизведение. Например, значение 60 запустит видео с 1-й минуты. |
| Скорость видео по умолчанию | Устанавливает скорость воспроизведения при загрузке: 0.5x, 1x, 1.25x, 1.5x или 2x. Зритель может изменить скорость через меню плеера. |
| Размер видео | Фиксированная ширина и высота iframe в пикселях. Несовместим с параметром «Сделать плеер адаптивным». Используйте для страниц с жёсткой сеткой вёрстки. |
Сводная таблица параметров
| Категория | Параметр | Примечание |
|---|---|---|
| Основные | Автостарт видео | Только с выключенным звуком |
| Скрыть название | Скрывает заголовок в плеере | |
| Сделать плеер адаптивным | Несовместим с «Размер видео» | |
| Запретить перемотку | Скрывает таймлайн | |
| Показать виджет при загрузке | Для ограниченного доступа | |
| Контролы плеера принудительно | Элементы управления всегда видны | |
| Плейлист при загрузке | Раскрывает список видео | |
| Данные пользователя | Передача email | Для сквозной авторизации |
| Передача ФИО | Для сквозной авторизации и водяных знаков | |
| Воспроизведение | Начать с (секунда) | Старт с заданного момента |
| Скорость по умолчанию | 0.5x — 2x | |
| Размер видео | Несовместим с адаптивным режимом |
Рекомендации по выбору параметров
Для образовательных курсов:
Включите «Запретить перемотку» для обязательного последовательного просмотра. Если у вас есть система авторизации на сайте — активируйте передачу email и ФИО для автоматического отображения водяных знаков с данными ученика.
Для лендингов и промо-страниц:
Используйте «Автостарт видео» с выключенным звуком для привлечения внимания. Включите «Сделать плеер адаптивным» для корректного отображения на мобильных устройствах.
Для страниц с фиксированной вёрсткой:
Используйте параметр «Размер видео» с конкретными значениями ширины и высоты. Адаптивный режим в этом случае может нарушить сетку страницы.
Для видео с платным доступом:
Включите «Показать виджет при загрузке плеера» — зритель сразу увидит форму оплаты или ввода пароля, не нажимая на кнопку воспроизведения.
Частые вопросы (FAQ)
Нужно ли обновлять плагин при изменении настроек видео в Boomstream?
Нет. Плагин загружает актуальные настройки видео с серверов Boomstream при каждом открытии страницы. Если вы изменили параметры защиты, обложку или добавили субтитры в личном кабинете — изменения отобразятся автоматически без обновления плагина.
Работает ли плагин с многоязычным сайтом на Битрикс?
Да. Плагин корректно работает на многоязычных сайтах. Для каждого языка можно создать отдельную страницу с плеером и встроить видео с нужной языковой дорожкой или субтитрами.
Что делать, если плеер не отображается после установки плагина?
Проверьте: 1) Корректность ссылки на видео (должна начинаться с https://play.boomstream.com/); 2) Наличие активной подписки или баланса в Boomstream; 3) Права доступа к компоненту в настройках Битрикс; 4) Отсутствие конфликтов с другими JavaScript-библиотеками на странице.
Можно ли встроить несколько плееров на одну страницу?
Да, ограничений на количество плееров на странице нет. Каждый плеер настраивается независимо — вы можете задать разные параметры автостарта, размера и передачи данных для каждого видео.
Передаются ли данные пользователя, если зритель не авторизован на сайте?
Нет. Параметры передачи email и ФИО работают только для авторизованных пользователей Битрикс. Если зритель открыл страницу как гость, данные не передаются, и ему потребуется ввести информацию вручную в форме регистрации Boomstream.
Влияет ли плагин на скорость загрузки страницы?
Плагин добавляет минимальную нагрузку — только HTML-разметку и подключение скрипта плеера. Сам плеер загружается асинхронно и не блокирует рендеринг страницы. Для оптимизации используйте ленивую загрузку видео, размещая плеер ниже первого экрана.
Совместим ли плагин с кэшированием Битрикс?
Да, плагин работает с кэшированием. Однако при включённой передаче данных пользователя (email, ФИО) необходимо исключить страницы с плеером из кэша — иначе данные первого пользователя могут отобразиться у всех посетителей.
Что делать, если после обновления Битрикс плагин перестал работать?
Обновите плагин до последней версии через маркетплейс. Если проблема сохраняется — обратитесь в поддержку Boomstream с указанием версии Битрикс и текстом ошибки из консоли браузера.
Поддерживаются ли прямые трансляции через плагин?
Да. Ссылка на прямую трансляцию имеет тот же формат, что и ссылка на видео. Вставьте её в поле «Источник видео» — зрители смогут подключиться к эфиру прямо на странице сайта.