Инструменты пользователя

Инструменты сайта


tvip_tms_faq

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Следующая версия
Предыдущая версия
tvip_tms_faq [2018/06/01 16:01]
Egor Danilenko создано
tvip_tms_faq [2019/07/23 16:32] (текущий)
Vadim Zakharchuk [Авторизация в Flussonic через Middleware]
Строка 1: Строка 1:
 ====== TVIP TMS FAQ ====== ====== TVIP TMS FAQ ======
 +
 +
 +===== Как подключить приставку к TMS используя логин и пароль?​ =====
 +
 +В аккаунте (account) необходимо указать логин и пароль для пользователя и сохранить изменения:​
 +
 +{{::​tms_login.png|}}
 +
 +Приставка без [[provisioning| провиженинга]],​ т.е. с заводскими настройками может быть настроена следующим образом:​
 +
 +На главном экране находим настройки ТВ:
 +
 +{{::​stb_login_step_01.jpg?​400|}}
 +
 +Выбираем протокол Middleware API (соответствует jsonapi в провиженинге)
 +
 +{{::​stb_login_step_02.jpg?​400|}}
 +
 +Настраиваем протокол:​
 +
 +{{::​stb_login_step_04.jpg?​400|}}
 +
 +в качестве сервера указываете адрес вашего сервера TMS, в примере указан http://​tvip.media.
 +
 +После ввода сервера должна быть активна клавиша "​Зарегистрировать",​ нажимаем ее и вводим учетные данные из первого шага:
 +
 +{{::​stb_login_step_05.jpg?​400|}}
 +
 +После удачной регистрации возвращаемся в ТВ интерфейс и проверяем что каналы доступны согласно тарифному плану:
 +
 +{{::​stb_login_step_08.jpg?​400|}}
 +
 +
 +===== Как подключить приставку без логина и пароля?​ =====
 +
 +В некоторых случаях удобна предактивация приставок,​ для этого необходимо:​
 +
 +  - Включить опцию "Allow quick device bind" в настройках провайдера (Settings -> Providers)
 +  - Добавить уникальный id (unique id) устройства в карточке аккаунта (account->​devices),​ в случае STB TVIP уникальный ID - это мак адрес в нижнем регистре.
 +  ​
 +**Ограничением этого метода является невозможность отвязать устройство от аккаунта из интерфейса приставки,​ в т.ч. тех устройств которые были подключены через ввод логина и пароля**
 +
 +===== Как устроены тарифы в TMS? ======
 +
 +Тарифные планы соотносятся с каналами через теги, пример подобных отношений указан ниже.
 +
 +{{::​how_tarifs_works.png|}}
 +
 +В данном примере:​
 +  * каналы "​Channel A" и "​Channel B" отмаркированы тегом "​public channels"​
 +  * каналы "​Channel B" и "​Channel C" отмаркированы тегом "sport channels"​
 +  * тариф "All channels"​ включает в себя оба тега ("​public channels"​ и "sport channels"​),​ таким образом в этом тарифе будут все три канала - Channel A, Channel B, Channel C
 +  * тариф "Sport channels"​ включает в себя только тег "sport channels",​ таким образом в тариф включено только два канала - Channel B, Channel C.
 +
 +Подобная иерархия позволяет достаточно гибко настраивать тарифные планы.
 +
 +Тарифные планы могут быть назначены как устройству (device), так и пользователю (account), при этом более приоритетными являются подписки на устройство,​ в случае отсутствия подписок на устройство будут использованы подписки на аккаунте. ​
 +
 +Одновременно устройство или пользователь может иметь сколько угодно подписок на тарифы,​ в итоге будет использован суммарный набор каналов,​ при этом суммируется только подписки на одном уровне (либо на account, либо на device), т.е. если у устройства на аккаунте "​test"​ будут подписки на тариф "test tarif",​ а у аккаунта будет подписка на тариф "​example tarif" - то устройству будут выданы каналы только от "test tarif"
 +
 +
 +===== Как добавить архив для канала в TMS ? =====
 +
 +TMS поддерживает возможность получения архива передачи и как следствие поддержку серверной паузы при использовании DVR от Flussonic.
 +
 +
 +==== Настройка Flussonic ====
 +Минимальная конфигурация Flussonic для включения этой возможности:​
 +<​code>​
 +stream TEST{
 +  url udp://​225.100.50.10:​1234;​
 +  dvr /media/HDD2 6d;
 +}
 +</​code>​
 +
 +В данном блоке мы включаем запись архива канала под названием **TEST** на шесть дней (**6d**) в каталог /​media/​HDD2,​ архив будет доступен через HLS.
 +
 +Больше информации по настройке DVR вы можете найти [[https://​erlyvideo.ru/​doc/​dvr/​configuration|тут]]
 +
 +На этом базовая настройка Flussonic завершена.
 +
 +==== Настройка TVIP TMS ====
 +
 +=== Общие настройки ===
 +
 +Подключить DVR сервер можно через меню Channels->​ DVR Servers
 +
 +В настройках сервера необходимо указать базовый **URL** (не канала),​ в нашем случае это **http://​fs.example.net**,​ если ваш flussonic использует нестандартный порт - его необходимо указать через двоеточие.
 +Для сервера указывается глубина архива (в нашем случае **86400**), она будет использована в том случае,​ если в настройках канала не будет указана другая глубина.
 +
 +
 +{{::​tms-dvr-server-setup.png?​400|}}
 +
 +=== Настройка канала ===
 +Для связи **Канала** с Flussonic используется атрибут **System name**, он должен точно совпадать с названием канала в Flussonic, в нашем примере это **TEST** ​
 +
 +{{::​channel-dvr-step-1.png?​400|}}
 +
 +
 +На вкладке **Archive** канала указываем сервер,​ архив которого будет использован.
 +
 +Так же в этой вкладке можно переопределить глубину архива,​ для сервера она указана как **86400** секунд,​ т.е. одни сутки, в настройках канала указываем корректное значение архива для канала - 6 суток (**6d**) - **518400** секунд.
 +
 +{{::​tms-dvr-channel-setup.png?​400|}}
 +
 +На этом настройка архива для канала закончена.
 +
 +==== Серверный архив и пауза на медиацентрах S-Box ====
 +До версии **3.9.13** включительно признаком наличия архива является наличие иконки "​play"​ в программе передач.
 +
 +{{::​dvr_3.9.13.jpg?​400|}}
 +
 +С версии **4.0.11** иконка приняла вид киноленты в программе передач канала.
 +
 +{{:​dvr_4.0.13.jpg?​400|}} ​
 +
 +Медиацентр получает информацию о глубине архива от TMS, при этом реальное наличие архива не проверяется,​ при попытке проиграть несуществующий архив медиацентр перейдет в "​Live"​ вещание.
 +
 +При нажатии на паузу - плеер запоминает точку ​ и при воспроизведении уже обращается к архиву для воспроизведения с этой точки. При этом локальной записи на медиацентр не происходит.
 +
 +===== Есть ли у TMS API, где найти документацию на API? =====
 +
 +Да, мы используем JSON REST API, документация встроена в дистрибутив,​ API может расширятся от версии к версии,​ о новых возможностях вы можете узнать в [[tvip_tms_changelog| changelog]]
 +
 +Ссылку на документацию вы можете найти в правом верхнем углу веб-интерфейса.
 +
 +
 +{{::​where_is_api_docs.png?​400|}}
 +
 +
 +===== Как авторизовываться в Provider API ?=====
 +
 +Для http basic авторизации в API необходимо использовать учетную запись администратора.
 +
 +Пример для CURL:
 +
 +Кодируем связку логин:​пароль в base64
 +<​code>​
 +echo -ne login:​password | base64
 +</​code>​
 +
 +полученную строку ​
 +
 +bG9naW46cGFzc3dvcmQK
 +
 +используем в авторизации:​
 +
 +
 +<​code>​
 +curl -X GET --header '​Authorization:​ Basic bG9naW46cGFzc3dvcmQK'​ --header '​Accept:​ application/​json'​ '​https://​tms.example.com/​api/​provider/​accounts'​
 +</​code>​
 +
 +При POST запросах обязательно указывайте тип данных в теле запроса '​Content-Type:​ application/​json'​
 +
 +===== Какие методы защиты контента есть в TMS? =====
 +
 +TMS, совместно с сервером //​flussonic//​ поддерживает AES-128 шифрование контента
 +
 +Работает это следующим образом: ​
 +  - //​flussonic//​ запрашивает ключи для шифрования у сервера //​tvip-cas//​ и шифрует этим ключом сегменты,​ ротация ключей происходит каждые 10 минут.
 +  - В HLS плейлисте генерируется ссылка на ключи, //​клиент//​ определив наличие ключей,​ пытается получить их по ссылке которая ведет на //​tvip-cas//​.
 +  - //TVIP TMS// и //​tvip-cas//​ постоянно синхронизирует данные о том, какой контент доступен для конкретных устройств,​ основываясь на этих данных //​tvip-cas//​ выдает или не выдает ключ клиенту.
 +
 +О том, как установить и настроить сервер tvip-cas вы можете почитать в статье [[tvip_key_server_installation|установка и настройка tvip-cas]]
 +
 +
 +===== Авторизация в Flussonic через Middleware ​ =====
 +
 +Документация Flussonic по этому разделу доступна по [[ https://​erlyvideo.ru/​doc/​avtorizatsiya/​avtorizatsiya-v-flussonic-cherez-middleware | ссылке ]]: 
 +
 +1. Включить опцию Flussonic auth enabled в TMS у провайдера
 +
 +{{::​enable_fa_provider.png|}}
 +
 +2. Включить у канала Flussonic auth
 +
 +{{::​enable_fa_channel.png|}}
 +
 +3. Установить адрес получения токена от ТМС в Flussonic по адресу http://​tms.example.com/​api/​drm/​auth_token
 +
 +<​code>​
 +stream test {
 +  url udp://​225.101.15.6:​1234;​
 +  auth http://​tms.example.com/​api/​drm/​auth_token 12345=12345;​
 +}
 +</​code>​
 +
 +4. Добавить в конфигурационный файл ТМС /​opt/​tvip-tms/​application-prod.properties опцию '​flussonic.app.secret.key' ​
 +<​code>​
 +flussonic.app.secret.key = 12345
 +</​code>​
 +
 +5. Перезапустуть службу Tvip-tms
 +
 +<​code>​
 +systemctl restart tvip-tms.service
 +</​code>​
  
  
  
-[[support_flussonic_dvr_in_the_tms| Как настроить DVR (архив) для канала?​]] 
tvip_tms_faq.1527858094.txt.gz · Последние изменения: 2018/06/01 16:01 — Egor Danilenko