Плейлист (*.plf)
Плейлист - инструмент задания последовательности медиа-файлов для отображения в нужной позиции на форме. Представляет собой текстовый файл определенной структуры.
Как правило, лист 01.plf показывает изображения info_up_center_XX.bmp информационных сообщений,
02.plf может использоваться для воспроизведения 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 | Целое | нет | из плей-листа | интервал в секундах |
Структура файла плей-листа:
Строка_настроек строка_медиа_файла_01 строка_медиа_файла_02 строка_медиа_файла_N
Строка настроек
имеет вид:
x=координата_угла_X;y=координата_угла_Y|w=ширина;h=высота|State=список_состояний|Stop=условие_остановки_возпроизведения
Где координата_угла_X, координата_угла_X, ширина, высота - целые числа, задающие местоположение прямоугольника вывода мульдимедиа.
Список состояний
Список_состояний - любое сочетание следующих состояний:
[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
State=KBD_Visible достаточно указать для всех дополнительных плей-листов.
Условие остановки воспроизведения
Условие_остановки_воспроизведения может принимать одно из следующих значений:
| Написание | Значение |
|---|---|
| OnInput | пользователь ввел данные |
| OnDefine | номер определен |
| OnNever | никогда не останавливать |
Регистр текста не важен.
Перечисление медиа-файлов
Строка_медиа_файла имеет вид:
имя_файла_флеш.swf|NN
либо
имя_файла_изображения.bmp|NN
Где NN = длительность отображения данного медиа в секундах (при этом флеш-файл будет активным, т.е. проигрываться), по умолчанию NN= 1 секунда;
имя_файла_ может быть как локальным для папки Media\ так и содержать полный путь к файлу.
Ссылка на провайдера или форму
имя_файла|Длительность в секундах|ProviderID=N
либо
имя_файла|Длительность в секундах|Form=Path.ini
Где
N = ID провайдера, по умолчанию N = 0;
Path.ini = Пусть до формы провайдера или группы;
Рекомендации по повышению быстродействия
Пример плейлиста целиком
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}\ для указания директории скина