Документация для разработчиков
Темная тема

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

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


Описание 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).
плеера в пикселях (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 [Y|N] При отмеченной опции открывается полный набор настроек компонента. Опция предназначена для опытных пользователей. Позволяет расширенно настроить компонент. Если отключить эту опцию, то редакторы сайта смогут размещать медиафайлы в упрощенном режиме, но установленные расширенные настройки будут действовать.
Идентификатор плеера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"
  	)
);?>


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Антон Царук
В настройках свойства инфоблока типа "Видео" нет жесткой настройки ширины и высоты проигрывателя. Эти параметры выставляются уже непосредственно при добавлении элемента инфоблока для каждого видео. Это крайне неудобно, так как чаще всего под видео в дизайне определяется строго заданная область. А получается, что юзер при добавлении видео может задать ему размер, например, 1000 пикселей, и весь дизайн поедет...

Решение есть: использовать параметры "Дополнительные переменные Flashvars" и "Дополнительные переменные Silverlight" в настройках свойства типа "Видео". Для этого укажите в них следующее:
Код
width=300
height=200

Каждый параметр с новой строчки ОБЯЗАТЕЛЬНО.

Такой подход навсегда закрепит за видео нужные Вам размеры.
0
Роберт Басыров
Если необходимо вставить видео в инфоблок.
http://dev.1c-bitrix.ru/community/blogs/howto/435.php
© «Битрикс», 2001-2025, «1С-Битрикс», 2025
Наверх