Содержание

TVIP TMS FAQ

Как подключить приставку к TMS используя логин и пароль?

В аккаунте (account) необходимо указать логин и пароль для пользователя и сохранить изменения:

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

На главном экране находим настройки ТВ:

Выбираем протокол Middleware API (соответствует jsonapi в провиженинге)

Настраиваем протокол:

в качестве сервера указываете адрес вашего сервера TMS, в примере указан http://tvip.media.

После ввода сервера должна быть активна клавиша «Зарегистрировать», нажимаем ее и вводим учетные данные из первого шага:

После удачной регистрации возвращаемся в ТВ интерфейс и проверяем что каналы доступны согласно тарифному плану:

Как подключить приставку без логина и пароля?

В некоторых случаях удобна предактивация приставок, для этого необходимо:

  1. Включить опцию «Allow quick device bind» в настройках провайдера (Settings → Providers)
  2. Добавить уникальный id (unique id) устройства в карточке аккаунта (account→devices), в случае STB TVIP уникальный ID - это мак адрес в нижнем регистре.

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

Как устроены тарифы в TMS?

Тарифные планы соотносятся с каналами через теги, пример подобных отношений указан ниже.

В данном примере:

Подобная иерархия позволяет достаточно гибко настраивать тарифные планы.

Тарифные планы могут быть назначены как устройству (device), так и пользователю (account), при этом более приоритетными являются подписки на устройство, в случае отсутствия подписок на устройство будут использованы подписки на аккаунте.

Одновременно устройство или пользователь может иметь сколько угодно подписок на тарифы, в итоге будет использован суммарный набор каналов, при этом суммируется только подписки на одном уровне (либо на account, либо на device), т.е. если у устройства на аккаунте «test» будут подписки на тариф «test tarif», а у аккаунта будет подписка на тариф «example tarif» - то устройству будут выданы каналы только от «test tarif»

Как добавить архив для канала в TMS ?

TMS поддерживает возможность получения архива передачи и как следствие поддержку серверной паузы при использовании DVR от Flussonic.

Настройка Flussonic

Минимальная конфигурация Flussonic для включения этой возможности:

stream TEST{
  url udp://225.100.50.10:1234;
  dvr /media/HDD2 6d;
}

В данном блоке мы включаем запись архива канала под названием TEST на шесть дней (6d) в каталог /media/HDD2, архив будет доступен через HLS.

Больше информации по настройке DVR вы можете найти тут

На этом базовая настройка Flussonic завершена.

Настройка TVIP TMS

Общие настройки

Подключить DVR сервер можно через меню Channels→ DVR Servers

В настройках сервера необходимо указать базовый URL (не канала), в нашем случае это http://fs.example.net, если ваш flussonic использует нестандартный порт - его необходимо указать через двоеточие. Для сервера указывается глубина архива (в нашем случае 86400), она будет использована в том случае, если в настройках канала не будет указана другая глубина.

Настройка канала

Для связи Канала с Flussonic используется атрибут System name, он должен точно совпадать с названием канала в Flussonic, в нашем примере это TEST

На вкладке Archive канала указываем сервер, архив которого будет использован.

Так же в этой вкладке можно переопределить глубину архива, для сервера она указана как 86400 секунд, т.е. одни сутки, в настройках канала указываем корректное значение архива для канала - 6 суток (6d) - 518400 секунд.

На этом настройка архива для канала закончена.

Серверный архив и пауза на медиацентрах S-Box

До версии 3.9.13 включительно признаком наличия архива является наличие иконки «play» в программе передач.

С версии 4.0.11 иконка приняла вид киноленты в программе передач канала.

Медиацентр получает информацию о глубине архива от TMS, при этом реальное наличие архива не проверяется, при попытке проиграть несуществующий архив медиацентр перейдет в «Live» вещание.

При нажатии на паузу - плеер запоминает точку и при воспроизведении уже обращается к архиву для воспроизведения с этой точки. При этом локальной записи на медиацентр не происходит.

Есть ли у TMS API, где найти документацию на API?

Да, мы используем JSON REST API, документация встроена в дистрибутив, API может расширятся от версии к версии, о новых возможностях вы можете узнать в changelog

Ссылку на документацию вы можете найти в правом верхнем углу веб-интерфейса.

Как авторизовываться в Provider API ?

Для http basic авторизации в API необходимо использовать учетную запись администратора.

Пример для CURL:

Кодируем связку логин:пароль в base64

echo -ne login:password | base64

полученную строку

bG9naW46cGFzc3dvcmQK

используем в авторизации:

curl -X GET --header 'Authorization: Basic bG9naW46cGFzc3dvcmQK' --header 'Accept: application/json' 'https://tms.example.com/api/provider/accounts'

При POST запросах обязательно указывайте тип данных в теле запроса 'Content-Type: application/json'

Какие методы защиты контента есть в TMS?

TMS, совместно с сервером flussonic поддерживает AES-128 шифрование контента

Работает это следующим образом:

  1. flussonic запрашивает ключи для шифрования у сервера tvip-cas и шифрует этим ключом сегменты, ротация ключей происходит каждые 10 минут.
  2. В HLS плейлисте генерируется ссылка на ключи, клиент определив наличие ключей, пытается получить их по ссылке которая ведет на tvip-cas.
  3. TVIP TMS и tvip-cas постоянно синхронизирует данные о том, какой контент доступен для конкретных устройств, основываясь на этих данных tvip-cas выдает или не выдает ключ клиенту.

О том, как установить и настроить сервер tvip-cas вы можете почитать в статье установка и настройка tvip-cas

Авторизация в Flussonic через Middleware

Документация Flussonic по этому разделу доступна по ссылке :

1. Включить опцию Flussonic auth enabled в TMS у провайдера

2. Включить у канала Flussonic auth

3. Установить адрес получения токена от ТМС в Flussonic по адресу http://tms.example.com/api/drm/auth_token

stream test {
  url udp://225.101.15.6:1234;
  auth http://tms.example.com/api/drm/auth_token 12345=12345;
}

4. Добавить в конфигурационный файл ТМС /opt/tvip-tms/application-prod.properties опцию 'flussonic.app.secret.key'

flussonic.app.secret.key = 12345

5. Перезапустуть службу Tvip-tms

systemctl restart tvip-tms.service