Медиа проигрыватель

Компонент осуществляет проигрывание медиафайлов на веб-страницах.

Описание bitrix:player

Одностраничный компонент предоставляет удобный интерфейс для добавления медиаплеера на сайт и поддерживает различные форматы файлов. Компонент является стандартным и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути: Контент > Медиа > Медиа проигрыватель.

Компонент относится к модулю Информационные блоки.

Внимание! Компонент поддерживает два режима настройки: базовый и расширенный. Расширенный предоставляет более широкие возможности.

Базовый режим

Поле

Параметр

Описание

Основные настройки

Путь к файлу

PATH

Указывается путь к файлу для проигрывания. Следует задавать полный путь к файлу от корня сайта.

Способ указания размеров

SIZE_TYPE

Указываются Абсолютные размеры Станут доступны для заполнения следующие поля:

Ширина	WIDTH	Указывается ширина окна плеера в пикселях (px).
Высота	HEIGHT	Указывается высота окна плеера в пикселях (px).

плеера в пикселях (px), Вписать в контейнер (размеры плеера будут ограничиваться размерами контейнера) либо выбирается способ Подстроиться под размеры видео.

Настройки воспроизведения

Автоматически начать проигрывать

AUTOSTART

[Y|N] При отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы.

Автоматически начинать проигрывать при появлении плеера на экране

AUTOSTART_ON_SCROLL

При отмеченной опции проигрывание медиафайла(ов) будет начато только после попадания плеера в поле зрения пользователя. Видео запускается автоматически только один раз. При автоматическом запуске звук выключается, включается только при первом взаимодействии с плеером.

Настройки повторения

REPEAT

Указывается вариант повтора при проигрывании медиафайла(ов) или списка воспроизведения:

не повторять (none);
повторять файл/список постоянно (always).

Уровень громкости в процентах от максимального

VOLUME

Указывается уровень громкости звука в процентах от максимального заданного в системе.

Дополнительные настройки

Начинать загрузку видео сразу

PRELOAD

При отмеченной опции загрузка видео будет происходить сразу после открытия плеера.

Показывать панель управления

SHOW_CONTROLS

[Y|N] При отмеченной опции будет отображаться панель управления плеером.

Расширенный режим настройки компонента

ADVANCED_MODE_SETTINGS

[Y|N] При отмеченной опции открывается полный набор настроек компонента. Опция предназначена для опытных пользователей. Позволяет расширенно настроить компонент. Если отключить эту опцию, то редакторы сайта смогут размещать медиафайлы в упрощенном режиме, но установленные расширенные настройки будут действовать.

Расширенный режим

Поле

Параметр

Описание

Основные настройки

Использовать список воспроизведения

USE_PLAYLIST

[Y|N] При отмеченной опции будет использоваться список воспроизведения, при этом необходимо настроить параметры:

Путь к списку воспроизведения	PATH	Указывается путь к файлу со списком воспроизведения. Задается полный путь к файлу от корня сайта либо только имя файла, если он расположен в текущей директории.
Cписок воспроизведения	PLAYLIST_DIALOG	Параметр позволяет создать/отредактировать список воспроизведения.
Использовать список воспроизведения как альтернативные версии файла	USE_PLAYLIST_AS_SOURCES	При использовании этой опции плеер пытается проиграть все ролики из списка по порядку и запускает первый, который ему удалось проиграть.

Путь к списку воспроизведения (PATH), Список воспроизведения (PLAYLIST_DIALOG) и Использовать список воспроизведения как альтернативные версии файла (USE_PLAYLIST_AS_SOURCES)

Медиа проигрыватель поддерживает следующие форматы списков воспроизведения: XSPF, ATOM, RSS, XML, ASX.

Не рекомендуется использовать данный параметр. Он устарел и оставлен для совместимости.

Путь к файлу

PATH

Указывается путь к файлу для проигрывания. Следует задавать полный путь к файлу от корня сайта.

Способ указания размеров

SIZE_TYPE

Указываются Абсолютные размеры Станут доступны для заполнения следующие поля:

Ширина	WIDTH	Указывается ширина окна плеера в пикселях (px).
Высота	HEIGHT	Указывается высота окна плеера в пикселях (px).

Внешний вид, общие настройки

Путь к рисунку для предварительного просмотра

PREVIEW

Указывается путь к изображению для заставки перед просмотром. Можно задать полный путь к файлу от корня сайта либо только имя файла, если он расположен в текущей директории.

Показывать панель управления

SHOW_CONTROLS

При отмеченной опции будет отображаться панель управления плеером.

Настройки воспроизведения

Автоматически начать проигрывать

AUTOSTART

[Y|N] При отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы.

Автоматически начинать проигрывать при появлении плеера на экране

AUTOSTART_ON_SCROLL

Настройки повторения

REPEAT

Указывается вариант повтора при проигрывании медиафайла(ов) или списка воспроизведения:

не повторять (none);
повторять файл/список постоянно (always).

Уровень громкости в процентах от максимального

VOLUME

Указывается уровень громкости звука в процентах от максимального заданного в системе.

Отключать звук при старте

MUTE

При отмеченной опции звук не будет воспроизводиться, включить его можно будет вручную в панели управления плеера.

Скорость воспроизведения

PLAYBACK_RATE

Указывается число от 1 до 3, которое будет множителем скорости воспроизведения видео.

Дополнительные настройки

Mime-type файла

TYPE

В поле можно в явном виде указать mime-type, если ссылка на php-скрипт, например.

Начинать загрузку видео сразу

PRELOAD

При отмеченной опции браузер начнет скачивать ролик сразу после загрузки страницы, еще до начала его воспроизведения.

Расширенный режим настройки компонента

ADVANCED_MODE_SETTINGS

Идентификатор плеера

PLAYER_ID

Указывается идентификатор для плеера для дальнейшего обращения к объекту плеера из JavaScript.

Пример вызова

<?$APPLICATION->IncludeComponent("bitrix:player","",Array(
	"ADVANCED_MODE_SETTINGS" => "Y",
	"AUTOSTART" => "N",
	"AUTOSTART_ON_SCROLL" => "Y",
	"HEIGHT" => "300",
	"MUTE" => "N",
	"PATH" => "/upload/myfiles/card.mp4",
	"PLAYBACK_RATE" => "1",
	"PLAYER_ID" => "",
	"PRELOAD" => "N",
	"PREVIEW" => "/upload/myfiles/card_obl.png",
	"REPEAT" => "none",
	"SHOW_CONTROLS" => "Y",
	"SIZE_TYPE" => "fluid",
	"START_TIME" => "0",
	"TYPE" => "",
	"USE_PLAYLIST" => "N",
	"VOLUME" => "90",
	"WIDTH" => "400"
  	)
);?>

Смотрите также

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