Start

Установка пакета интеграции VoD сервиса Start

Предупреждение

Перед установкой пакета интеграции обновите платформу TVIP TMS до последней доступной версии

Для установки пакета выполните следующие команды:

sudo apt update
sudo apt install manager-tvip-tms-vod-start
ACCESS_TOKEN_SECRET=$(cat /opt/tvip-tms/manager/manager-tvip-auth/application-prod.yml | grep -oP 'access-token-secret:\s*(.*)' | sed "s/'//g" |awk '{print$2}')
REFRESH_TOKEN_SECRET=$(cat /opt/tvip-tms/manager/manager-tvip-auth/application-prod.yml | grep -oP 'refresh-token-secret:\s*(.*)' | sed "s/'//g" |awk '{print$2}')
sed -i "s/accessTokenSecret/$ACCESS_TOKEN_SECRET/g" /opt/tvip-tms/manager/manager-tvip-tms-vod-start/application-prod.yml
sed -i "s/refreshTokenSecret/$REFRESH_TOKEN_SECRET/g" /opt/tvip-tms/manager/manager-tvip-tms-vod-start/application-prod.yml
sudo systemctl enable manager-tvip-tms-vod-start
sudo systemctl start manager-tvip-tms-vod-start

Настройка пакета интеграции

Укажите в файле конфигурации /opt/tvip-tms/manager/manager-tvip-tms-vod-start/application-prod.yml в разделе start параметры partner-name, api-key и url, полученные от Start:

application:
    jwt:
        access-token-secret: <access_token>
        refresh-token-secret: <refresh_token>

start:
    partner-name: <partner-name>
    api-key: <api-key>
    url: <url>

Настройки application/jwt должны быть идентичны тем, что настроены в других сервисах.

Примените настройки, перезапустив сервис:

systemctl restart manager-tvip-tms-vod-start

Настройка тарифных планов

Доступ к библиотеке VOD регулируется с помощью VOD-тегов. Чтобы создать тег, связанный с сервисом start, выполните следующие действия:

В разделе VOD / Тарифные теги VOD создайте новый тег с произвольным названием, например START.
В настройках тега, в разделе Источники VOD, создайте источник с кодом START и укажите тип START.

Теперь данный тег можно добавить в любой тариф. Если он присутствует в тарифе, пользователи, подписавшиеся на этот тариф, получат доступ к библиотеке START. Подробнее о настройке тарифных тегов VOD можно узнать на соответствующей странице документации.

Настройка тарифа

Перейдите в существующий или создайте новый тариф и настройте его для работы с сервисом Start:

Назначьте VOD-тег, связанный с сервисом Start.
Обязательно укажите условия тарификации, так как они важны при работе с API Start. При необходимости создайте валюту в разделе Управление / Валюты. Отдельное поле «Цена» в случае тарифов использующих библиотеку Start запрещено.
Обязательно активируйте опцию защиты тарифа. Она гарантирует неизменность созданных подписок: дата начала останется фиксированной, удаление подписки будет запрещено, а единственное доступное действие — установка даты окончания, если она не была задана ранее.

Предупреждение

Сервису Start будет передана полная стоимость тарифа, даже если он включает другие ресурсы, такие как ТВ. Настройки тарификации также используются для отображения стоимости в промо-каналах.

Настройка импорта

Для корректной работы сервиса необходимо настроить категории в которые будет импортирован контент. В разделе VOD / Управление категориями сопоставьте в какую категорию должен попадать контент из кинотеатра Start, при необходимости создайте новую категорию.

Особенности реализации

TVIP TMS поддерживает открытые даты подписок для Start и автоматически продлевает их на указанный в тарификации период. Проверка подписок выполняется 4 раза в день.
Для корректной синхронизации подписок между TMS и Start ведутся журналы синхронизации текущих и архивных подписок в формате таблиц PostgreSQL. Доступ через API будет реализован в будущем.
Стоимость тарифа будет передана в API шлюз Start в валюте, настроенной в рамках тарификации.
Синхронизация библиотеки VOD Start и TMS проводится раз в сутки.
После первичной настройки рекомендуется перезапустить сервис: systemctl restart manager-tvip-tms-vod-start