Медиа проигрыватель
Компонент осуществляет проигрывание медиафайлов на веб-страницах.
Описание bitrix:player
Одностраничный компонент предоставляет удобный интерфейс для добавления медиаплеера на сайт и поддерживает различные форматы файлов. Компонент является стандартным и входит в дистрибутив модуля.
В визуальном редакторе компонент расположен по пути: Контент > Медиа > Медиа проигрыватель.
Компонент относится к модулю Информационные блоки.
Внимание! Компонент поддерживает два режима настройки: базовый и расширенный. Расширенный предоставляет более широкие возможности.
Базовый режим
Расширенный режим
| Поле | Параметр | Описание | |||||||||
| Основные настройки | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Использовать список воспроизведения | USE_PLAYLIST | [Y|N] При отмеченной опции будет использоваться список воспроизведения, при этом необходимо настроить
параметры:
Медиа проигрыватель поддерживает следующие форматы списков воспроизведения: XSPF, ATOM, RSS, XML, ASX. Не рекомендуется использовать данный параметр. Он устарел и оставлен для совместимости. | |||||||||
| Путь к файлу | PATH | Указывается путь к файлу для проигрывания. Следует задавать полный путь к файлу от корня сайта. | |||||||||
| Способ указания размеров | SIZE_TYPE | Указываются
Абсолютные размеры
Станут доступны для заполнения следующие поля:
| |||||||||
| Внешний вид, общие настройки | |||||||||||
| Путь к рисунку для предварительного просмотра | PREVIEW | Указывается путь к изображению для заставки перед просмотром. Можно задать полный путь к файлу от корня сайта либо только имя файла, если он расположен в текущей директории. | |||||||||
| Показывать панель управления | SHOW_CONTROLS | При отмеченной опции будет отображаться панель управления плеером. | |||||||||
| Настройки воспроизведения | |||||||||||
| Автоматически начать проигрывать | AUTOSTART | [Y|N] При отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы. | |||||||||
| Автоматически начинать проигрывать при появлении плеера на экране | AUTOSTART_ON_SCROLL | При отмеченной опции проигрывание медиафайла(ов) будет начато только после попадания плеера в поле зрения пользователя. Видео запускается автоматически только один раз. При автоматическом запуске звук выключается, включается только при первом взаимодействии с плеером. | |||||||||
| Настройки повторения | REPEAT | Указывается вариант повтора при проигрывании медиафайла(ов) или списка воспроизведения:
| |||||||||
| Уровень громкости в процентах от максимального | 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"
)
);?>
Антон Царук
| ||
|
В настройках свойства инфоблока типа "Видео" нет жесткой настройки ширины и высоты проигрывателя. Эти параметры выставляются уже непосредственно при добавлении элемента инфоблока для каждого видео. Это крайне неудобно, так как чаще всего под видео в дизайне определяется строго заданная область. А получается, что юзер при добавлении видео может задать ему размер, например, 1000 пикселей, и весь дизайн поедет...
Решение есть: использовать параметры "Дополнительные переменные Flashvars" и "Дополнительные переменные Silverlight" в настройках свойства типа "Видео". Для этого укажите в них следующее:
Каждый параметр с новой строчки ОБЯЗАТЕЛЬНО. Такой подход навсегда закрепит за видео нужные Вам размеры. | ||
Роберт Басыров
|
|
Если необходимо вставить видео в инфоблок.
|
© «Битрикс», 2001-2025, «1С-Битрикс», 2025
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.