SS IPTV

Для настройки в SS IPTV авторизации пользователя провайдер должен подготовить серверный скрипт, который будет возвращать плейлист, основываясь на авторизационных данных, полученных в GET-параметрах. Плейлист, возвращаемый скриптом должне полностью удовлетворять требованиям по CORS и кодировке (utf-8)

Пример ссылки скрипта:

http://example.com/playlist.php?user=test_login&pass=test_pass

После того, как данная скрипт будет подготовлен, провайдеру следует в Личном Кабинете Оператора сменить тип доступа для пакета:

• Токен - авторизация по одному параметру
• Логин/пароль - авторизация по двум параметрам

Далее следует указать ссылку на скрипт, возвращающий плейлист, заменив данные, которые должен ввести пользователь на специальные переменные среды:

• ${token} - введенный пользователем токен (авторизация по одному параметру)
• ${login} - введенный пользователем логин (авторизация по двум параметрам)
• ${password} - введенный пользователем пароль (авторизация по двум параметрам)

Например:

http://example.com/playlist.php?user=${login}&pass=${password}

Приложение позволяет прописывать в плейлисте ссылку на внешнюю телепрограмму, которая будет подгружаться, когда пользователь открывает соответствующий плейлист.

Внимание! Зачастую телевизоры не обладают достаточными ресурсами, чтобы обрабатывать большие источники телепрограмм! Бездумное использование данной опции может привести к подвисанию на длительное время, либо к полному прекращению работы приложения! Настоятельно рекомендуется подключать телепрограмму только для тех каналов, для которых она отсутствует в приложении.

Чтобы заставить приложение обратиться за внешней телепрограммой, необходимо к заголовочной директиве #EXTM3U добавить атрибут x-tvg-url:

В настоящее время поддерживаются телепрограммы формата jtv и xmltv. Рекомендуемый размер jtv - не более 0,5 Мб, xmltv - не более 5 Мб. Использование сжатия для xmltv - недопустимо.

Чтобы обеспечить загрузку телепрограммы на всех устройствах, файл должен отдаваться с http-заголовком: Access-Control-Allow-Origin: * кроме того, для xmltv необходимо также наличие следующих заголовков:

Access-Control-Allow-Methods: "GET, POST, OPTIONS, HEAD"
Access-Control-Allow-Headers: "Range"
Access-Control-Expose-Headers: "Accept-Ranges, Content-Encoding, Content-Length, Content-Range"

При каждой своей загрузке SS IPTV запрашивает плейлист по адресу http://iptv.local/playlist.m3u

и в случае успешной загрузки выводит соответствующий тайл на Главный экран

Обращение за плейлистом происходит вне зависимости от того, зарегистрирован провайдер, пользователь которого запустил приложение, в системе или нет. Т.о. настроив DNS своей сети нужным образом, вы можете обеспечить простую доступность вашего плейлиста для собственных пользователей даже в том случае, если вы не были внесены в список поддерживаемых операторов.

В то же время, регистрация в системе позволяет оператору обеспечить гораздо более гибкое распространение контента, например, средствами получения от пользователя авторизационных параметров (логин/пароль, идентификатор устройства и т.п.

Для того, чтобы обеспечить гарантированную загрузку плейлиста на всех устройствах, сервер должен отдавать его с http-заголовком Access-Control-Allow-Origin. Все требования и возможности, касающиеся структуры плейлиста, распространяются также и на плейлисты, загружаемые из локального домена.

SS IPTV использует плейлисты, удовлетворяющие спецификации формата Extended M3U. Подробную информацию о структуре файла вы можете найти в нашей статье Инструкция по формату M3U.

Важно помнить, что поскольку на телевизорах некоторых производителей запрещены кросс-доменные запросы, загрузка файла плейлиста будет осуществляться не непосредственно клиентским устройством (телевизором), а сервером приложения, а значит, ссылка на файл должна быть доступна из внешней сети (или хотя бы для сервера приложения). Если же вы хотите, чтобы клиентское устройство загружало ваш плейлист напрямую, необходимо осуществить настройку вашего сервера в соответствии с технологией CORS. На практике это означает, что http-заголовок ответа на запрос плейлиста должен содержать следующую строку:

Access-Control-Allow-Origin: *

Кроме того плейлист должен быть доступен с IP адресов 195.201.246.115 116.202.118.184, 138.201.198.228 и 94.19.241.39 для периодической проверки.

Ниже приведена информация по настройке CORS для различных платформ

Header set Access-Control-Allow-Origin "*"

apachectl -t

<?xml version="1.0" encoding="utf-8"?>
<configuration>
 <system.webServer>
   <httpProtocol>
     <customHeaders>
       <add name="Access-Control-Allow-Origin" value="*" />
     </customHeaders>
   </httpProtocol>
 </system.webServer>
</configuration>

<?php
header("Access-Control-Allow-Origin: *");
$playlist = file_get_contents('playlist.m3u');
echo($playlist);
?>

add_header Access-Control-Allow-Origin *;