Различия

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

--- tvip_tms_faq [2018/06/01 16:20]
Egor Danilenko
+++ tvip_tms_faq [2019/07/23 16:32] (текущий)
Vadim Zakharchuk [Авторизация в Flussonic через Middleware]
@@ Строка 1: / Строка 1: @@
 ====== TVIP TMS FAQ ======
-===== Как устроены тарифы в TMS ======
+===== Как подключить приставку к 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? ======
 Тарифные планы соотносятся с каналами через теги, пример подобных отношений указан ниже.
@@ Строка 19: / Строка 60: @@
 Одновременно устройство или пользователь может иметь сколько угодно подписок на тарифы, в итоге будет использован суммарный набор каналов, при этом суммируется только подписки на одном уровне (либо на account, либо на device), т.е. если у устройства на аккаунте "test" будут подписки на тариф "test tarif", а у аккаунта будет подписка на тариф "example tarif" - то устройству будут выданы каналы только от "test tarif"
-[[support_flussonic_dvr_in_the_tms| Как настроить DVR (архив) для канала?]]
+===== Как добавить архив для канала в 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 | ссылке ]]:
+. Включить опцию Flussonic auth enabled в TMS у провайдера
+{{::enable_fa_provider.png|}}
+. Включить у канала Flussonic auth
+{{::enable_fa_channel.png|}}
+. Установить адрес получения токена от ТМС в 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>
+. Добавить в конфигурационный файл ТМС /opt/tvip-tms/application-prod.properties опцию 'flussonic.app.secret.key'
+<code>
+flussonic.app.secret.key = 12345
+</code>
+. Перезапустуть службу Tvip-tms
+<code>
+systemctl restart tvip-tms.service
+</code>

TVIP Wiki

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

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

Различия

Инструменты страницы