Здесь показаны различия между двумя версиями данной страницы.
Следующая версия | Предыдущая версия Следующая версия Следующая версия справа и слева | ||
tvip_tms_faq [2018/06/01 16:01] Egor Danilenko создано |
tvip_tms_faq [2019/07/23 11:24] Vadim Zakharchuk |
||
---|---|---|---|
Строка 2: | Строка 2: | ||
+ | ===== Как подключить приставку к 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. Добавить в конфигурационный файл ТМС application.propeties опцию 'flussonic.app.secret.key' | ||
+ | <code> | ||
+ | flussonic.app.secret.key = 12345 | ||
+ | </code> | ||
- | [[support_flussonic_dvr_in_the_tms| Как настроить DVR (архив) для канала?]] |