Особенности Приложения
OTTPlayer является бесплатным,универсальным приложение для просмотра онлайн телевидения по протоколу HLS. Каждый может загрузить свой плейлист и настроить его под себя.
Адаптивность
В данный момент приложения полностью адаптированно под Android смартфоны и планшеты, iPhone и iPad также поддерживаются Android miniPC и Android ТВ приставки. В стадии разработки находится версия для телевизоров Smart TV.
Приятный Интерфейс
К разработке UI наша команда подошла очень серьезно. Мы постарались сделать его максимально простым и удобным для пользователя. Но мы не останавливаемся на достигнутом и будем его совершенствовать.
OTTPLAYER - Бесплатен и Доступен для Скачивания
OTTPlayer является бесплатным приложением для пользователя и таким всегда будет оставаться
API интерфейс
Плееру для работы нужен плейлист определенного формата, который должен хранится на Web-сервере и быть доступным для скачивания. При первом запуске приложение попросит Вас ввести URL плейлиста, затем он сохранится и больше не потребуется. URL в приложении можно изменить в любой момент в меню Настройка.
Плейлист использует формат 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
https://u.to/kPonFw
#EXTINF:-1 tvg-id=«2» tvg-logo="Channel_2.png" group-title=«Group_2» tvg-rec="1" ,Channel 2
https://u.to/i-onFw
Глобальные переменными записаны в первой строке плейлиста после #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 - это электронная программа передач телеканалов.
Для ускорения работы плеера, доступ к EPG разделен на два этапа:
1. Список каналов с телепередачами, которые транслируются в данный момент.
2. Полный список телепередач по конкретному каналу.
Первый список должен находиться по URL:
https://u.to/jPonFw
Второй:
https://u.to/kvonFw
Первый URL должен дать в ответ JSON массив структур с переменными:
ch_id - id канала, равен tvg-id канала;
name - название телепередачи;
time, time_to - время начала и конца программы в unix формате;
duration - длительность передачи в секундах;
descr - детальное описание передачи (необязательно);
Полный список также должен представлять собой JSON массив структур
аналогичных первому без переменной ch_id.
Архив
Доступ к архиву плеер осуществляет добавлением переменных archive и archive_end
в GET запрос URL'a HLS потока:
https://u.to/jvonFw
В этом примере плеер просит воспроизвести поток начиная со времени 1407164412,
время в unix формате, и заканчивая временем 1407165000.
Ключ
Многие операторы онлайн телевидения организовали доступ к ТВ
по средствам уникального ключа, который присутствует в URL HLS потока.
Например: https://u.to/kfonFw
"12345678" - является ключом доступа, конкретного абонента.
По нему оператор осуществляет доступ и тарификацию услуг.
Для удобства пользователей был добавлен параметр {KEY}.
Во время первого запуска, при наличии параметра {KEY} в плейлисте,
плеер попросит его ввести и затем сохранит, изменить его можно в меню "Настройки".
Обращаем Ваше внимание, что {KEY} является одним на весь плейлист.
Т.е. в одном плейлисте может быть только один ключ доступа.
Плейлисты
Загрузка плейлиста по коду - это функция, с помощью которой операторы онлайн телевидения могут передавать адрес плейлиста и ключ доступа по коду показанном на экране устройства или телевизора.
Для добавления плейлиста нужно отправить POST или GET запрос на адрес https://u.to/k-onFw указав переменные:
code - код для загрузки с экрана устройства;
playlist_url - url плейлиста в формате http(s)://example.com;
key - ключ доступа;
В ответ сервер отправляет данные в формате JSON с переменными status и message. Существует два статуса в ответе сервера.
"status": "success" - при получении данного статуса все данные приняты и плейлист будет загружен
"status": "faild" - произошла ошибка, неправильный формат данных или код не найден
Когда будет поддержка большего количества устройств?
В данный момент приложение поддерживает уже довольно широкий спектр устройств. Идет работа по адаптации его для Android TV, также идут работы по созданию версии для Smart TV LG и Samsung.
