viju

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

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

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

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

sudo apt update
sudo apt install manager-tvip-tms-vod-viju
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-viju/application-prod.yml
sed -i "s/refreshTokenSecret/$REFRESH_TOKEN_SECRET/g" /opt/tvip-tms/manager/manager-tvip-tms-vod-viju/application-prod.yml
sudo systemctl enable manager-tvip-tms-vod-viju
sudo systemctl start manager-tvip-tms-vod-viju

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

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

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

viju:
    partner:
        access-key: <access_key>
        password: <password>

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

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

systemctl restart manager-tvip-tms-vod-viju

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

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

  • В разделе VOD / Тарифные теги VOD создайте новый тег с произвольным названием, например VIJU.

  • В настройках тега, в разделе Источники VOD, создайте источник с кодом VIJU и укажите тип VIJU.

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

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

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

  • Назначьте VOD-тег, связанный с сервисом VIJU.

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

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

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

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

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

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

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

  • Сервис viju не поддерживает подписки с открытой датой и требует указания даты окончания подписки в API.

  • TVIP TMS поддерживает открытые даты подписок и автоматически продлевает их на указанный в тарификации период. Проверка подписок выполняется 4 раза в день.

  • Для корректной синхронизации подписок между TMS и viju ведутся журналы синхронизации текущих и архивных подписок в формате таблиц PostgreSQL. Доступ через API будет реализован в будущем.

  • viju API ограничен 10 запросами в секунду, что может замедлить применение настроек тарифов.

  • Стоимость тарифа будет передана в копейках в API шлюз viju вне зависимости от выбранной валюты

  • Синхронизация библиотеки VoD viju и TMS проводится раз в сутки.

  • После первичной настройки рекомендуется перезапустить сервис: systemctl restart manager-tvip-tms-vod-viju