Настройка модуля START
- Модуль START в Smarty является отдельной опцией лицензии, поэтому прежде, чем начать настройку, убедитесь, что ваша лицензия включает данный модуль.
- Подключите модуль cinema_start в конфигурации Smarty в секции INSTALLED_APPS, перезагрузите Smarty и выполните миграцию данных.
python /usr/share/nginx/html/microimpuls/smarty/manage.py migrate --settings=settings.<settings filename>3. Создайте скрытый тарифный пакет, который будет использоваться для возможности доступа абонентов к каталогу фильмов START (можно назвать его «Доступ к каталогу START»). Этот тарифный пакет будет автоматически включаться для всех импортированных фильмов для того, чтобы фильм был виден абоненту в каталоге.
4. Создайте тарифный пакет, который будет использоваться для подписки на пакет фильмов (можно назвать его «Кинотеатр START»). При покупке фильмов START этот пакет будет подключаться абоненту в Smarty, а при отключении пакета — будет происходить отписка на стороне START. Этот тариф нужно сделать видимым, назначить ему цену и периодичность.
Для подписки на START также можно создать несколько тарифов, которые, помимо фильмов START будут включать в себя каналы и другие услуги — такие тарифы будут считаться бандлами.
Важно: все созданные тарифы и бандлы следует согласовывать с представителями START, либо с представителями Microimpuls, если договор был оформлен через нас.
5. Далее следует настроить интеграцию в панели администрирования в разделе «Общие настройки Client» -> «Интеграция с API внешних систем»:
- Имя партнера — выдают представители START или Microimpuls
- Ключ API — выдают представители START или Microimpuls
- Переопределить API URL — поле, в которое можно вписать адрес до песочницы START для тестирования
- URL прокси — заполняется представителями Microimpuls в случае, если договор был оформлен через нас.
6. После этого следует запустить первый импорт фильмов с помощью команды:
smarty_manage cinema_start_sync_content --settings=settings.<settings name>Дополнительные параметры:
--remove_outdated — при его указании скрипт импорта после окончания работы удаляет все фильмы с обработчиком START, которые не были найдены в каталоге START, то есть совершает очистку старых фильмов.
--update_actors — при его указании при импорте будет производиться дополнительная проверка наличия постеров у существующих импортируемых актеров.
--update_assets_promos — при его указании вместе с импортом происходит загрузка промо-картинки для ассетов. Предупреждение: при наличии промо у ассета происходит его обновление.
Первая синхронизация может занять около часа в связи со скачиванием обложек, последующие синхронизации проходят быстрее. Для регулярной синхронизации фильмов необходимо добавить вызов команды в crontab.
7. После первой синхронизации будут созданы жанры фильмов Start и их базовый маппинг на жанры Smarty. Если вдруг будет замечено, что фильтрация фильмов Start по жанрам происходит некорректно, то рекомендуем зайти в раздел http://smarty.example.com/admin/cinema_start/startgenremap/ и перенастроить маппинг нужным образом (а также можно добавить свои жанры и настроить новый связи для маппинга). При последующей синхронизации фильмов произойдет перепривязка жанров.
8. Далее необходимо настроить отправку статистики о просмотрах в Start — на страницах устройств в Общие настройки Client -> Настройки STB и приложений -> блок «Настройки сбора данных телесмотрения» включить чекбокс «Включить отправку статистических данных на сервер Start при просмотре контента Start» (включить отправку сразу на всех устройствах можно через их массовое редактирование)
9. После этого можно проверить отображение кинотеатра в интерфейсе — для этого нужно подключить абоненту тариф «Доступ к каталогу START» — после этого абонент сможет увидеть фильмы в интерфейсе, но на странице их описания будет кнопка «Купить»:
10. Если для списаний и управления тарифами используется внутренний биллинг Smarty, то достаточно нажать в интерфейсе кнопку «Купить» и при достаточном балансе произойдёт подписка на фильм и его можно будет просмотреть. Если нет, то для тестирования можно подключить этот тариф абоненту через админку и проверить, что он проигрывается.
11. Чтобы по кнопке «Купить» происходила покупка фильма не только в Smarty, но и во внешнем биллинге, можно разработать скрипт интеграции по нашему примеру.
12. Для корректного продления подписок на стороне START при использовании простой логики биллинга необходимо добавить в crontab management-команду check_video_subscriptions:
smarty_manage check_video_subscriptions --settings=settings.<settings name>Команда проходит по всем подпискам на кинотеатр на стороне Smarty (внутренние объекты tariffsubscription в django-админке Smarty) и при необходимости продляет их на стороне START. Подписка на стороне START создаётся с запасом на 1 день, относительно подписки внутри Smarty, чтобы данная менеджмент-команда гарантированно успела отработать и продлить подписку кинотеатра до того, как она закончится. Рекомендуется запускать команду не реже 1 раза в сутки, а в случае использования команды check_accounts — запускать команду check_video_subscriptions сразу после неё.
13. При необходимости можно проверить работу подписки. Данная команда проверит наличие соответствующего тарифа при наличии внешней подписки Start. При отсутствии соответствующего тарифа выполняется закрытие подписки на внешней стороне.
Команда:
smarty_manage cinema_start_resync_subscriptions --settings=settings.<settings name>Дополнительные параметры:
--external_api_id — идентификатор внешней интеграции кинотеатра START в Smarty.
--custom_billing_api — при добавлении этого параметра будут затронуты лишь те пользователи, к которым привязан обработчик биллинга c переданным id.
