OTTPLAYER

                              
  Плейлист использует формат M3U, с дополнительными переменными. 
Глобальными, которые касаются всего плейлиста и локальными, касаются конкретного канала.
Глобальные: url-epg, url-logo. Локальные tvg-id, tvg-logo, group-title,tvg-rec, {KEY}.

  Вот небольшой пример плейлиста:

#EXTM3U url-epg="http://example.com/epg_url/« url-logo="http://example.com/images/"
#EXTINF:-1 tvg-id="1" tvg-logo=«Channel_1.png" group-title=«Group_1» , Channel 1
http://example.com/stream/1.m3u8
#EXTINF:-1 tvg-id=«2» tvg-logo="Channel_2.png" group-title=«Group_2» tvg-rec="1" ,Channel 2
http://example.com/stream/{KEY}/2.m3u8

  Глобальные переменными записаны в первой строке плейлиста после #EXTM3U.
Локальные для каналов Channel 1 и  Channel 2 после #EXTINF.
После перечисления всех переменных канала, например для первого канала это:
tvg-id="1" - id-канала=1, понадобится для работы EPG и архива); 
tvg-logo="Channel_1.png" - имя файла логотипаканала;
group-title="Group_1" - название группы, которой принадлежит канал);
 Channel 1 - непосресвенно само название канала канала;
В следующей строке идет ссылка на HLS поток,http://example.com/stream/1.m3u8.       
                            
                            

                                

Глобальные переменные:
  url-epg - Это URL для скачивание EPG каналов. Подробнее о работе EPG, 
читайте в одноименном разделе API;
  url-logo - URL указвающий корневой путь для скачивания плеером иконок каналов.

Локальные переменные:
  tvg-id - id идентификатор канала, нужен для работы EPG и архива,
уникальное число для каждого канала в плейлисте;
  tvg-logo - имя файла иконки канала, который находится в папке указанной в url-logo
  group-title - название тематической группы канала. 
Поддерживаемые названия групп описаны в разделе "Оформление" настоящего API;     
  tvg-rec - флаг архива, если установленно tvg-rec="1", 
это указывает о наличи архива этого канала. Поумолчанию ноль;
  {KEY} - ключ доступа к телевидению. Для операторов предаставлющих платные услуги OTT. 
  Будет описанно в разделе "Ключ";
                               
                            

                                
Формат иконок каналов: PNG 120x90.
Список названий поддерживаемых тематических групп:
    

        
Общие
Детские
Спорт
Музыкальные
Позновательные
Кино
Взрослые
    
   
                                
                            

                                
  EPG - это электронная программа передач телеканолов.
Для ускорения работы плеера, доступ к EPG разделен на два этапа:
1. Список каналов с телепередачами, которые транслируются в данный момент.
2. Полный список телепередач по конкреному каналу.
Первый список должен находиться по URL:
  http://example.com/{url-epg}/channel_now
Второй:
  http://example.com/{url-epg}/channel/{tvg-id}
Первый URL должен дать в ответ JSON массив структур с перемеными:
  

      
ch_id - id канала, равен tvg-id канала;
name - название телепередачи;
time, time_to - время начала и конца программы в unix формате;
duration - длительность передачи в секундах;
descr - детальное описание передачи (необязательно);
  
  Полный список также должен предтавлять собой JSON массив cтуктур
аналогичных первому без переменной ch_id.      
                                
                            

                                
  Доступ к архиву плеер осуществляет добавлением переменных archive и archive_end 
в GET запрос URL'a HLS потока:

http://example.com/stream/1.m3u8?archive=1407164412&archive_end=1407165000

  В этом примере плеер просит воспроизвести поток начиная со времени 1407164412,
время в unix формате, и заканчивая временем 1407165000.
                            
                            

                                
Многие операторы онлайн телевидения организовали доступ к ТВ  
по средствам уникального ключа, который присутствует в URL HLS потока.

Например: http://example.com/stream/12345678/1.m3u8

  "12345678" - является ключом доступа, конкретного абонента.
По ниму оператор осущетвляет доступ и тарификацию услуг.
Для удобства пользователей был добавлен параметр {KEY}.
  Во время первого запуска, при наличии параметра {KEY} в плейлисте,
плеер попросит его ввести и затем сохранит, изменить его можно в меню "Настройки".
Обращаем Ваше внимание, что {KEY} является одним на весь плейлист.
Т.е. в одном плейлисте может быть только один ключ доступа.   
                                
                            

                                
Загрузка плейлиста по коду - это функция, с помощью которой операторы онлайн телевидения могут передавать адрес плейлиста и ключ доступа по коду показаном на экране устройства или телевизора. 

Для добавления плейлиста нужно отправить POST или GET запрос на адрес https://api.ottplayer.org/v1/add_playlist/ указав переменные:
code - код для загрузки с экрана устройства;
playlist_url - url плейлиста в формате http(s)://example.com;
key - ключ доступа;
В ответ сервер отправляет данные в формате JSON с переменными status и message. Существует два статуса в ответе сервера.
"status": "success" - при получении данного статуса все данные приняты и плейлист будет загружен
"status": "faild" - произошла ошибка, неправильный формат данных или код не найден