1C-Битрикс: Управление сайтом

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

Одностраничный компонент осуществляет проигрывание медиафайлов различных форматов, поддерживает проигрывание плей-листов (см. список поддерживаемых форматов и плей-листов), имеет большое количество настроек внешнего вида плеера. Компонент является стандартным и входит в дистрибутив модуля.

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

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

<?$APPLICATION->IncludeComponent("bitrix:player","",Array(
	"PLAYER_TYPE" => "auto",
	"USE_PLAYLIST" => "Y",
	"PATH" => "playlist.xml",
	"PLAYLIST_DIALOG" => "",
	"PROVIDER" => "video",
	"STREAMER" => "",
	"WIDTH" => "400",
	"HEIGHT" => "400",
	"PREVIEW" => "",
	"FILE_TITLE" => "Вступление",
	"FILE_DURATION" => "305",
	"FILE_AUTHOR" => "Иван Иванов",
	"FILE_DATE" => "01.08.2010",
	"FILE_DESCRIPTION" => "Презентация продукта",
	"SKIN_PATH" => "/bitrix/components/bitrix/player/mediaplayer/skins",
	"SKIN" => "bitrix.swf",
	"CONTROLBAR" => "bottom",
	"WMODE" => "transparent",
	"PLAYLIST" => "right",
	"PLAYLIST_SIZE" => "180",
	"LOGO" => "/logo.png",
	"LOGO_LINK" => "http://ваш_сайт.com/",
	"LOGO_POSITION" => "bottom-left",
	"PLUGINS" => array("tweetit-1", "fbit-1"),
	"PLUGINS_TWEETIT-1" => "tweetit.link=",
	"PLUGINS_FBIT-1" => "fbit.link=",
	"ADDITIONAL_FLASHVARS" => "",
	"WMODE_WMV" => "window",
	"SHOW_CONTROLS" => "Y",
	"PLAYLIST_TYPE" => "xspf",
	"PLAYLIST_PREVIEW_WIDTH" => "64",
	"PLAYLIST_PREVIEW_HEIGHT" => "48",
	"SHOW_DIGITS" => "Y",
	"CONTROLS_BGCOLOR" => "FFFFFF",
	"CONTROLS_COLOR" => "000000",
	"CONTROLS_OVER_COLOR" => "000000",
	"SCREEN_COLOR" => "000000",
	"AUTOSTART" => "Y",
	"REPEAT" => "list",
	"VOLUME" => "90",
	"MUTE" => "N",
	"HIGH_QUALITY" => "Y",
	"SHUFFLE" => "N",
	"START_ITEM" => "1",
	"ADVANCED_MODE_SETTINGS" => "Y",
	"PLAYER_ID" => "",
	"BUFFER_LENGTH" => "10",
	"DOWNLOAD_LINK" => "http://ваш_сайт.com/video.flv",
	"DOWNLOAD_LINK_TARGET" => "_self",
	"ADDITIONAL_WMVVARS" => "",
	"ALLOW_SWF" => "Y",
  	)
);?>
Настройка компонента доступна в упрощенном и расширенном режимах.

Описание параметров

Упрощенный режим

Поле Параметр Описание
Основные настройки
Путь к файлуPATHУказывается путь к файлу для проигрывания или к списку воспроизведения. Следует задавать полный путь к файлу от корня сайта. Также можно указать ссылку на видео с сайта YouTube.
Медиа-провайдерPROVIDERУказывается медиа-провайдер потокового видео:
  • Видео (FLV / MP4) (video);
  • HTTP - потоковое видео (http);
  • RTMP - потоковое видео (rtmp);
  • Звук (MP3) (sound);
  • Изображения (GIF / JPG / PNG) (image);
  • Видео с YouTube.com (youtube).
Выбрав пункт (другое)->, можно сформировать свой вариант медиа-провайдера потокового видео.
Ширина WIDTH Указывается ширина окна плеера в пикселях (px), вместе со списком воспроизведения, если проигрывается плей-лист.
Высота HEIGHT Указывается высота окна плеера в пикселях (px), вместе со списком воспроизведения, если проигрывается плей-лист.
Настройки воспроизведения
Автоматически начать проигрывать AUTOSTART [Y|N] При отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы.
Настройки повторения REPEAT Указывается вариант повтора при проигрывании медиафайла(ов) или списка воспроизведения:
  • не повторять (none);
  • возпроизвести список один раз (list);
  • повторять файл/список постоянно (always);
  • повторять один файл в списке (single).
Уровень громкости в процентах от максимального VOLUME Указывается уровень громкости звука в процентах от максимального заданного в системе.
Дополнительные настройки
Расширенный режим настройки компонента ADVANCED_MODE_SETTINGS [Y|N] При отмеченной опции открывается полный набор настроек компонента. Опция предназначена для опытных пользователей. Позволяет расширенно настроить компонент. Если отключить эту опцию, то редакторы сайта смогут размещать медиафайлы в упрощенном режиме, но установленные расширенные настройки будут действовать.

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

Поле Параметр Описание
Основные настройки
Тип плеера PLAYER_TYPE Указывается тип плеера:
  • Определить автоматически (auto) - если необходимо проигрывать файлы разных форматов;
  • HTML5 / Flash плеер (flv) - HTML5 / Flash плеер;
  • WMV Плеер (wmv) - WMV плеер. Для работы WMV плеера необходимо установить Microsoft Silverlight.
Использовать список воспроизведенияUSE_PLAYLIST [Y|N] При отмеченной опции будет использоваться список воспроизведения, при этом необходимо настроить параметры: Путь к списку воспроизведения (PATH) и Список воспроизведения (PLAYLIST_DIALOG).
Путь к списку воспроизведенияPATH Указывается путь к списку воспроизведения. Задается полный путь к файлу от корня сайта либо только имя файла, если он расположен в текущей директории. Также можно указать ссылку на видео с сайта YouTube.
Cписок воспроизведения PLAYLIST_DIALOG Параметр позволяет создать/отредактировать список воспроизведения.
Путь к файлуPATHУказывается путь к файлу для проигрывания. Следует задавать полный путь к файлу от корня сайта. Также можно указать ссылку на видео с сайта YouTube.

Поле неактивно при отмеченной опции Использовать список воспроизведения.
Медиа-провайдер PROVIDERУказывается медиа-провайдер потокового видео:
  • Видео (FLV / MP4) (video);
  • HTTP - потоковое видео (http);
  • RTMP - потоковое видео (rtmp);
  • Звук (MP3) (sound);
  • Изображения (GIF / JPG / PNG) (image);
  • Видео с YouTube.com (youtube).
Выбрав пункт (другое)->, можно сформировать свой вариант медиа-провайдера потокового видео.
Серверное приложение потокового видео (Стриммер)STREAMERУказывается приложение на сервере для потокового видео.
Ширина WIDTH Указывается ширина окна плеера в пикселях (px), вместе со списком воспроизведения, если проигрывается плей-лист.
Высота HEIGHT Указывается высота окна плеера в пикселях (px), вместе со списком воспроизведения, если проигрывается плей-лист.
Путь к рисунку для предварительного просмотра PREVIEW Задается путь к рисунку заставки для предварительного просмотра. Можно задать полный путь к файлу от корня сайта либо только имя файла, если он расположен в текущей директории.
Заголовок видео FILE_TITLE Указывается заголовок ролика.
Продолжительность ролика (в секундах) FILE_DURATION Указывается продолжительность ролика в секундах.
Автор видео FILE_AUTHOR Указывается автор ролика.
Дата публикации видео FILE_DATE Указывается дата публикации видео.
Описание видео FILE_DESCRIPTION Произвольное текстовое описание ролика.
Внешний вид flash-плеера
Путь к папке со скинами SKIN_PATH Указывается путь к папке со скинами Flash плеера. Пользовательские скины должны храниться в директории, не затрагиваемой системой обновлений.
Скин SKIN Указывается скин Flash плеера. Стандартный скин Flash плеера доступен в любом случае.
Расположение панели управления CONTROLBAR Указывается расположение панели управления плеера:
  • внизу (bottom) - снизу окна просмотра;
  • поверх (over) - всплывает поверх окна просмотра;
  • не показывать (none) - панель управления будет скрыта.
Режим окна (WMode) WMODE Указывается режим окна Flash плеера:
  • Обычный (window) - медиафайл будет проигрываться на странице в собственном прямоугольном окне. Этот вариант дает наибольший выигрыш в скорости воспроизведения анимации;
  • Непрозрачный (opaque) - медиафайл будет помещен на задний план страницы;
  • Прозрачный (transparent) - фон страницы будет "проглядывать" через все прозрачные места медиафайла при проигрывании. Этот вариант может замедлить скорость воспроизведения анимации.
Путь к изображению авторского знака LOGO Задается путь к рисунку, который будет использован как авторский знак в окне видео или аудио файла. Можно задать полный путь к файлу от корня сайта либо только имя файла, если он расположен в текущей директории.
Ссылка на изображении авторского знакаLOGO_LINKЗадается ссылка перехода при клике на изображении авторского знака.
Расположение авторского знакаLOGO_POSITIONЗадается расположение авторского знака:
  • Не показывать (none);
  • Внизу слева (bottom-left);
  • Вверху слева (top-left);
  • Вверху справа (top-right);
  • Внизу справа (bottom-right).
Внешний вид wmv-плеера
Расположение списка воспроизведения PLAYLIST Задается расположение списка воспроизведения:
  • Внизу (bottom) - список воспроизведения будет расположен снизу;
  • Справа (right) - список воспроизведения будет расположен справа.
Размер списка воспроизведения в пикселях PLAYLIST_SIZE Задается размер (высота или ширина) списка воспроизведения в пикселях (px) в зависимости от его расположения.
Режим окна WMODE_WMV Указывается режим окна Wmv-плеера:
  • Обычный (window) - окно плеера будет убрано за HTML элементы страницы;
  • Прозрачный (windowless) - окно плеера будет отображаться непосредственно в клиентской области обозревателя или внутри специально созданного окна.
Показывать панель управления SHOW_CONTROLS [Y|N] При отмеченной опции будет отображаться панель управления плеером.
Формат списка воспроизведения PLAYLIST_TYPE Указывается формат списка воспроизведения:
  • ASX
  • ATOM
  • RSS
  • XSPF
Ширина картинки в списке воспроизведения PLAYLIST_PREVIEW_WIDTH Задается ширина картинки в списке воспроизведения в пикселях (px).
Высота картинки в списке воспроизведения PLAYLIST_PREVIEW_HEIGHT Задается высота картинки в списке воспроизведения в пикселях (px).
Показывать текущее время воспроизведения и оставшееся время SHOW_DIGITS [Y|N] При отмеченной опции будет показано текущее и оставшееся время воспроизведения ролика.
Цвет фона панели управления CONTROLS_BGCOLOR Указывается код цвета для фона панели управления плеера.
Цвет элементов управления CONTROLS_COLOR Указывается код цвета для элементов управления плеера.
Цвет элементов управления при наведении указателя мыши CONTROLS_OVER_COLOR Указывается код цвета для элементов управления плеера при наведении указателя мыши.
Цвет экрана SCREEN_COLOR Указывается код цвета для экрана плеера.
Дополнительные настройки flash-плеера
Список подключаемых плагиновPLUGINSУказываются подключаемые к flash-плееру плагины.

Выбрав пункт (не выбрано)->, можно указать плагина.
Параметры плагина [название плагина]PLUGINS_[название плагина]Указываются дополнительные параметры подключаемых к flash-плееру плагинов.

Поле доступно, если в Списке подключаемых плагинов указан какой-либо плагин.
Дополнительные переменные FlashvarsADDITIONAL_FLASHVARSУказываются дополнительные переменные для flash-плеера.
Настройки воспроизведения
Автоматически начать проигрывать AUTOSTART [Y|N] При отмеченной опции проигрывание медиафайла(ов) будет начато сразу после загрузки страницы.
Настройки повторения REPEAT Указывается вариант повтора при проигрывании медиафайла(ов) или списка воспроизведения:
  • не повторять (none);
  • возпроизвести список один раз (list);
  • повторять файл/список постоянно (always);
  • повторять один файл в списке (single).
Уровень громкости в процентах от максимального VOLUME Указывается уровень громкости звука в процентах от максимального заданного в системе.
Дополнительные настройки воспроизведения flash-плеера
Отключать звук при старте MUTE [Y|N] При отмеченной опции звук не будет воспроизводиться, включить его можно будет вручную в панели управления плеера.
Перемешать список воспроизведения SHUFFLE [Y|N] При отмеченной опции элементы списка воспроизведения будут проиграны в случайном порядке. Внешнее отображение списка изменено не будет.
Дополнительные настройки
Начать проигрывать с элемента в списке START_ITEM (для Flash Плеера) Указывается номер элемента списка воспроизведения, с которого начать проигрывать. Элементы нумеруются с нуля.
Расширенный режим настройки компонента ADVANCED_MODE_SETTINGS [Y|N] При отмеченной опции открывается полный набор настроек компонента. Опция предназначена для опытных пользователей. Позволяет расширенно настроить компонент. Если отключить эту опцию, то редакторы сайта смогут размещать медиафайлы в упрощенном режиме, но установленные расширенные настройки будут действовать.
Идентификатор плеера PLAYER_ID Необязательный параметр. Указывается идентификатор для плеера для дальнейшего обращения к объекту плеера из JavaScript.
Размер буфера в секундах BUFFER_LENGTH Указывается сколько секунд воспроизведения ролика сохранять в буфере обмена, прежде чем начать проигрывать. Рекомендуется для медленного трафика.
Ссылка для скачивания ролика DOWNLOAD_LINK Можно указать прямую ссылку для скачивание ролика с вашего сайта либо адрес страницы, на которую пользователь попадет при клике по экрану (если это настроено в параметре Действие при клике по экрану) или по стрелке в панели управления плеера. Переход по ссылке работает при проигрывании единичного файла.
Открывать ссылку в DOWNLOAD_LINK_TARGET Указывается в каком окне браузера открывать ссылку для скачивания: в текущем (_self) или в новом (_blank).
Дополнительные переменные Silverlight ADDITIONAL_WMVVARS Указываются дополнительные переменные для WMV плеера.
Разрешить проигрывание swf-файлов (не рекомендуется) ALLOW_SWF [Y|N] При отмеченной опции будет разрешено проигрывание файлов формата swf. Не рекомендуется использовать в силу высокой степени опасности XSS-атаки через подключаемый файл.

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

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

Для создания списка воспроизведения необходимо указать в поле Путь к списку воспроизведения имя нового списка и нажать кнопку Изменить в поле Список воспроизведения. Откроется окно Создание списка воспроизведения:

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

Кнопка Добавить элемент служит для добавления элементов списка воспроизведения. По её нажатию нужно заполнить следующие поля:

Поле Описание
Якорь Инструмент для изменения положения пункта меню в общем порядке списка воспроизведения способом Drag & Drop.
Редактировать Нажать для редактирования поля.
Название Указывается название медиафайла, как оно будт отображаться в общем списке.
Автор Указывается имя автора медиафайла.
Время Указывается время проигрывания медиафайла в формате MM:SS.
Путь к файлу Задается путь к медиафайлу.
Путь к рисунку Указывается путь к рисунку для анонса.
Стрелки Инструмент для пошагового изменения положения медиафайла в общем списке.
Удалить Инструмент для удаления элемента списка воспроизведения.

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

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

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

Кнопка Команда
Сохранить Сохранение внесенных изменений.
Отменить Отказ от внесенных изменений.

Редактирование списка воспроизведения выполняется аналогичным образом.

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

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

Добавлять комментарии могут только зарегистрированные пользователи. Сообщения для просмотра появляются после модерации.
0
Роберт Басыров 10.06.2009 13:44:54
Если необходимо вставить видео в инфоблок.
http://dev.1c-bitrix.ru/community/blogs/howto/435.php
© «Битрикс», 2001-2012, «1C-Битрикс», 2012