Даний розділ описує загальні аспекти формату Extended M3U, які не є унікальними для нашого застосування. Також ви можете ознайомитися з додатковими параметрами, введеними для розширення можливостей SS IPTV і використовуваними тільки їм.
Плей-лист в форматі M3U - це звичайний текстовий документ в кодуванні UTF-8. Його можна редагувати, наприклад, використовуючи додаток Блокнот із стандартного набору утиліт Windows. Будь-який файл M3U починається з першого рядка в якій міститься напис # EXTM3U. Далі, файл являє собою набір парних рядків, перша з яких завжди починається з #EXTINF :. а друга являє собою посилання на контент.
Приклад файлу в форматі M3U:
Як видно з прикладу файл являє собою набір парних рядків позначають позначають джерело потоку або сигналу з доповнюючим описом. У прикладі наведено 3 канали: BBC World, CNN International і Arirang. Перший рядок з парних завжди починається з #EXTINF: (тривалість) (атрибути), (назва каналу). Обов'язкові параметри: тривалість і назва каналу. Причому, тривалість завжди повинна дорівнювати нулю для Live TV.
Атрибути є необов'язковими параметрами, ось список атрибутів які використовуються під час завантаження плей-листа:
- tvg-shift - зміщення в часі телепрограми
- tvg-name - ідентифікатор телепрограми каналу
- tvg-logo - логотип каналу
- audio-track - мовної код (ISO 639-2) аудіо доріжки каналу, наприклад: eng, rus. Допускається зазначення декількох аудіо доріжок через кому: "rus, ukr, eng". Доріжкою за замовчуванням встановлюється перша зазначена в списку.
- aspect-ratio - визначає пропорції екрану (можливо, ви не для деяких моделей телевізорів). Допустимі значення: 16: 9. 3: 2. 4: 3. 1,85: 1. 2,39: 1 (найбільш поширене значення для фільмів)
Увага! Значення атрибута завжди має зазначатися в подвійних лапках, наприклад: tvg-shift = "3".
В даному розділі описуються директиви і атрибути, які застосовуються тільки в SS IPTV, сторонні додатки можуть інтерпретувати ці параметри некоректно
В SS IPTV крім традиційних директив і атрибутів формату Extended M3U передбачені додаткові. Використання описаних тут атрибутів дозволяє дуже гнучко налаштовувати зовнішній вигляд плейлистів на головному екрані, маніпулюючи відображенням окремих тайлів.
Директиви формату M3U завжди починаються з нового рядка і мають першим символом - грати "#", атрибути вписуються в рядок з директивою (як правило #EXTINF) і представлені у вигляді пари атрибут = "значення". Значення атрибута завжди має бути укладена в подвійні лапки
#EXTSIZE визначає розмір тайла, що відноситься до описуваного елементу плейлиста. Можливі значення: small. medium. big
#EXTCTRL після директиви може бути вказаний url за яким буде здійснено запит при натисканні на тайл, що відноситься до описуваного елементу. Запит відправляється до завантаження контенту. Ця функція може бути корисна власникам супутникових ресиверів, при її використанні додаток буде відправляти ресивера команду на перемикання каналу.
Додаткові атрибути директиви #EXTINF:
description - визначає опис, що відображається на тайла розміру medium і big
content-type - дозволяє вказати додатком тип описуваного контенту. Можливі варіанти значень: stream. video. playlist. У більшості випадків програма автоматично визначає тип контенту і в використанні даного параметра немає необхідності.
Додаткові атрибути директиви # EXTM3U
Директива # EXTM3U як атрибутів може містити атрибути description. size і background. У цьому випадку значення, задані для перерахованих атрибутів застосовуються для всіх елементів плейлиста, якщо вони не перевизначені в директивах #EXTINF
Нижче наведено приклад M3U-плейлиста з використанням додаткових директив і атрибутів і то, як він буде виглядати в додатку.