Плейлист (*.plf)

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

Файл плей-листа сохраняется в папку Media\ и имеет расширение *.plf.

Зарезервированы имена 01.plf и 02.plf для плейлистов «формы с автоопределением».
Как правило, лист 01.plf показывает изображения info_up_center_XX.bmp информационных сообщений,
02.plf может использоваться для воспроизведения flash-анимаций.

С помощью flash в плейлистах можно отображать рекламу, стрелочные часы и пр.динамичные элементы интерфейса.

Подключение плейлиста в форме ввода

В нужном ini-файле пользовательских элементов оформления экрана (keyboards\) задаем параметр:

[common]
flashes=1

где 1 - количество мульдимедиа-объектов на данном 'экране'.

Добавляется соответвующее число разделов под каждый мульдимедиа-объект:

[Flash-NN]

внутри раздела параметры:

PlayListName=имя_файла_плейлиста.plf
Left=0
Top=0
Width=100
Height=80
IntervalInSec=30

где:

Название параметра Тип Обязательный По умолчанию Описание
имя_файла_плейлиста.plf Строка да - имя файла, включая путь, относительно папки Media\
Left, Top, Width, Height Целое нет из плей-листа координаты и размеры в пикселях
IntervalInSec Целое нет из плей-листа интервал в секундах

Несколько ini-форм могут использовать один plf файл, а также более одного раза на одной форме.

Структура файла плей-листа:

Строка_настроек
строка_медиа_файла_01
строка_медиа_файла_02
строка_медиа_файла_N

Строка настроек

имеет вид:

x=координата_угла_X;y=координата_угла_Y|w=ширина;h=высота|State=список_состояний|Stop=условие_остановки_возпроизведения

Где координата_угла_X, координата_угла_X, ширина, высота - целые числа, задающие местоположение прямоугольника вывода мульдимедиа.

Координаты из плей-листа имеют меньший приоритет, чем координаты из вызывающего его ini-файла.

Список состояний

Список_состояний - любое сочетание следующих состояний:

[AutoInputPay,KBD_Visible,Pay,PayOwn,PayV3_Visible,PayV3Own_Visible,ShowProviderInfo,Bonus,Finish]

Перечисление производится через запятую, регистр не важен. Здесь задаются состояния ПО, в которых виден мульдимедиа-объект:

Написание Значение
AutoInputPay режим автоопределения провайдера (основной)
ShowProviderInfo режим с отображением провайдера, который определён
KBD_Visible режим пользовательской настройки (элементов) оформления
Pay режим оплаты платежа (с одним полем ввода)
PayOwn режим оплаты собственной комиссии (с одним полем ввода)
Bonus режим отображения бонуса и ожидания его подтверждения
Finish режим подготовки к завершению работы ПО
PayV3_Visible режим оплаты платежа по форме ввода
PayV3Own_Visible режимы оплаты собственной комиссии по форме ввода

Пример:

State=AutoInputPay,Bonus,Pay,PayOwn

В плей-листах 01.plf и 02.plf следует указать весь набор нужных состояний, но обязательно включить AutoInputPay.

Состояние State=KBD_Visible достаточно указать для всех дополнительных плей-листов.

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

Условие_остановки_воспроизведения может принимать одно из следующих значений:

Написание Значение
OnInput пользователь ввел данные
OnDefine номер определен
OnNever никогда не останавливать

Регистр текста не важен.

Перечисление медиа-файлов

Строка_медиа_файла имеет вид:

имя_файла_флеш.swf|NN

либо

имя_файла_изображения.bmp|NN

Где NN = длительность отображения данного медиа в секундах (при этом флеш-файл будет активным, т.е. проигрываться), по умолчанию NN= 1 секунда;

имя_файла_ может быть как локальным для папки Media\ так и содержать полный путь к файлу.

Количество строк в плей-листе не ограничено, но желательно не превышать N=100.

Ссылка на провайдера или форму

На текущее время добавлять ссылку нужно будет в ручную, после Нового Года уже можно будет через конфигуратор.

Строка_медиа_файла имеет вид:

имя_файла|Длительность в секундах|ProviderID=N

либо

имя_файла|Длительность в секундах|Form=Path.ini

Где N = ID провайдера, по умолчанию N = 0;
Path.ini = Пусть до формы провайдера или группы;

Ссылки будут активны только когда состояние ПО = Форма с авто определением.

Если задана ссылка, то по нажатию на банер, будет осуществлен переход на форму или провайдера, в зависимости какой тип ссылки вы сделали. Это может пригодиться например для рекламы - делаете форму, добавляете на форму видео ролик и текст, затем на эту форму в банере прописываете ссылку, и теперь по нажатию загрузиться ваша форма с рекламой. Также, допустим у вас появился новый провайдер и вы хотите чтоб его все видели, делаем банер с большим текстом об этом провайдере и прописываем в банере ID этого провайдера.

Рекомендации по повышению быстродействия

Рекомендуем использовать flash-файлы *.swf без прозрачности.

Размеры flash (ширина, высота) должны соответствовать размерам прямоугольника отображения, либо быть кратными им.

Пример плейлиста целиком

x=1;y=1|w=1280;h=223|State=autoInputPay,Bonus,Finish,pay,PayOwn,payV3,PayV3Own|Stop=onInput
{SKIN_MEDIA}\info_up_center_2.bmp|3
{SKIN_MEDIA}\info_up_center_3.bmp|3
{SKIN_MEDIA}\info_up_center_1.bmp|4
{SKIN_MEDIA}\info_up_center_3.bmp|3|ProviderID=-8
{SKIN_MEDIA}\info_up_center_2.bmp|3|Form=\IMG\keyboards\Groups\group_Other.ini
{SKIN_MEDIA}\info_up_center_1.bmp|5
{SKIN_MEDIA}\info_up_center_11.bmp|3
{SKIN_MEDIA}\info_up_center_14.bmp|3

Используйте {SKIN_MEDIA}\ либо \IMG\{SKIN_NAME}\ для указания директории скина