Видеоплеер
Расширение ui.video-player
воспроизводит видео и аудио с использованием библиотеки video.js. Доступен с версии UI 24.1000.0.
Подключение
Объект BX.UI.VideoPlayer.PlayerManager
предоставляет доступ к плеерам на странице. Метод getPlayerById
возвращает объект по его идентификатору:
BX.Fileman.PlayerManager.getPlayerById( playerId )
BX.UI.VideoPlayer.Player
создает объект для каждого плеера на странице.
JS
import { Player } from 'ui.video-player'; // es6 new Player(id, params); new BX.UI.VideoPlayer.Player(id, params); // es5
PHP
\Bitrix\Main\UI\Extension::load('ui.video-player');
Параметры
Параметртип | Описание |
---|---|
idstring | Идентификатор элемента DOM, в котором будет инициализирован плеер |
paramsObject | Коллекция параметров для настройки плеера |
Параметр params
Параметртип | Описание |
---|---|
sourcesаrray | Список объектов, описывающих источники медиафайлов для воспроизведения. Каждый объект должен содержать свойства:
|
autostartboolean | Автоматически запускать воспроизведение. По умолчанию — false |
playbackRatenumber | Скорость воспроизведения. Значение по умолчанию — 1 Допустимые значения от 0.5 до 3 |
volumenumber | Громкость плеера. Значение по умолчанию — 0.8 |
startTimenumber | Начальное время воспроизведения в секундах. По умолчанию — 0 |
skinstring | CSS класс для скина плеера. По умолчанию — пустая строка |
isAudioboolean | Использовать аудио режим. По умолчанию — false |
widthnumber | Ширина плеера. По умолчанию — 560 для видео и 400 для аудио |
heightnumber | Высота плеера. По умолчанию — 315 для видео и 30 для аудио |
durationnumber | null | Продолжительность видео. По умолчанию — null |
mutedboolean | Отключить звук по умолчанию. По умолчанию — false |
Методы
Получить объект плеера:
var player = BX.UI.VideoPlayer.PlayerManager.getPlayerById( playerId );
Методы работы с объектом плеера:
Метод | Описание |
---|---|
player.isPlaying() | Проверяет, идет ли воспроизведение. Если да — возвращает true |
player.isEnded() | Проверяет, остановилось ли воспроизведение после проигрывания файла целиком. Если да — возвращает true |
player.isReady() | Возвращает true , если плеер до конца инициализирован |
player.getElement() | Получает html-ноду плеера |
player.createElement() | Возвращает ноду, аналогично методу getElement, если плеер вставлен в документ. Если ноды нет — создает ее, но не вставляет в документ |
player.setSource(source) | Устанавливает трек плеера. Рекомендуется передавать объект вида
{ src: 'путь к файлу', type: 'mime-type' } |
player.getSource() | Возвращает текущий трек |
player.mute() | Выключает звук плеера |
player.play() | Запускает воспроизведение |
player.pause() | Останавливает воспроизведение |
Пример
Код создает видеоплеер на веб-странице, который воспроизводит указанное видео.
// Импортируем Player import { Player } from 'ui.video-player'; // Создаем новый объект плеера с идентификатором 'player_id' const player = new Player( 'player_id', { // Указываем источник видео sources: [ { src: 'https://dev.1c-bitrix.ru/download/files/video/learning/hermitage.mp4', // URL видеофайла type: 'video/mp4' // Тип видеофайла } ], autostart: true, // Автоматически запускать воспроизведение width: 640, // Установить ширину плеера height: 360 // Установить высоту плеера } ); // Создаем HTML-элемент для плеера const playerNode = player.createElement(); // Находим элемент на странице с идентификатором 'video' const node = document.getElementById('video'); // Добавляем созданный элемент плеера в найденный элемент на странице node.appendChild(playerNode); // Инициализируем плеер player.init();
© «Битрикс», 2001-2025, «1С-Битрикс», 2025
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.