Smarty содержит модуль для интеграции с онлайн-кинотеатром PREMIER, который включает в себя следующий функционал:
- Синхронизация фильмов и сериалов PREMIER со встроенной видеотекой Smarty (наименования, описание, жанры, обложки и т.д.);
- Все стандартные функции встроенной видеотеки Smarty (поиск, фильтрация, сортировка, группировка по жанрам и т.д.);
- Прозрачная интеграция в стандартные приложения Microimpuls на разных устройствах — единый интерфейс просмотра ТВ, VOD и других сервисов, привычный для абонента.
Подготовка конфигурации Smarty
Для того, чтобы подключить интеграцию с кинотеатром PREMIER необходимо осуществить предварительную подготовку конфигурации Smarty:
1. Подключить модуль premier в конфигурации Smarty в секции INSTALLED_APPS
:
INSTALLED_APPS += (
//..
'premier',
)
2. Перезагрузить Smarty:
sudo service uwsgi restart
3. Выполнить миграцию данных:
python manage.py migrate --settings=settings.<settings filename>
Настройка модуля Premier в Smarty
После того, как были выполнены подготовительные действия, можно перейти к настройке модуля PREMIER в Smarty. Для начала, рекомендуется создать два тарифных плана:
- Скрытый тарифный пакет с типом доступа «Отображение контента в списке без возможности запуска» . Данный тариф будет использоваться для возможности доступа абонентов к каталогу фильмов PREMIER. Для того, чтобы все новые пользователи имели доступ к каталогу фильмов PREMIER, рекомендуем в конфигурации тарифа активировать пункт «подключаемый по умолчанию;
- Тарифный пакет с типом доступа «Доступ к просмотру контента», который будет использоваться для подписки на пакет фильмов.
После того, как тарифные планы были созданы, можно перейти к настройке интеграции:
1. В панели администратора в разделе «Общие настройки» -> «Интеграция с API внешних систем» создать новую внешнюю систему:
- Указать название (например, PREMIER);
- Выбрать из выпадающего списка класс API
premier_api_client
; - Выбрать тарифные пакеты, созданные ранее и описанные выше. Абоненты, у которых подключен первый тарифный пакет, будут видеть фильмы в видеотеке и иметь возможность купить подписку на них;
- Указать дополнительные атрибуты внешней системы в правом блоке страницы — имя партнера и идентификатор коллекции фильмов (данные можно запросить через персонального менеджера);
2. После выполнения всех шагов необходимо произвести синхронизацию контента с помощью management-команды:
python manage.py premier_sync_content --settings=settings.<settings filename>
Команда имеет дополнительные параметры:
--remove_outdated
— при его указании скрипт импорта после окончания работы удаляет все фильмы с обработчиком PREMIER, которые не были найдены в каталоге PREMIER, то есть совершает очистку старых фильмов.
--ignore_main_genres
— при его указании все жанры, полученные от PREMIER, будут обрабатываться как Жанры в Smarty. Если флаг не добавлять, то Главный жанр отмечается как Жанр-категория.
Предупреждение: при добавлении данного параметра у импортированного ранее контента PREMIER все Жанры-категории будут также переведены в Жанры.
--update_assets_promos
— при его указании вместе с импортом происходит загрузка промо-картинки для ассетов. Предупреждение: при наличии промо у ассета происходит его обновление.
Первая синхронизация может занять продолжительный промежуток времени в связи со скачиванием обложек, последующие синхронизации проходят быстрее. Для регулярной синхронизации фильмов необходимо добавить вызов команды в crontab (рекомендуется производить синхронизацию контента во время наименьшей нагрузки на сервер).
После первой синхронизации будут созданы жанры фильмов PREMIER и их базовый маппинг на жанры Smarty. Если вдруг будет замечено, что фильтрация фильмов PREMIER по жанрам происходит некорректно, то рекомендуем зайти в раздел http://smarty.example.com/admin/premier/premiergenremap/ и перенастроить маппинг нужным образом (а также можно добавить свои жанры и настроить новые связи для маппинга). При последующей синхронизации фильмов произойдет перепривязка жанров.
Настройка статистики для кинотеатра PREMIER
Для полноценной интеграции кинотеатра, необходимо настроить отправку статистики о просмотрах в PREMIER. Для этого необходимо совершить следующие действия:
- Получить у менеджера ссылки на события начала просмотра и хартбита для каждого устройства (на каждый тип устройства должно быть 2 ссылки).
- Вписать эти ссылки на страницы устройств в «Общие настройки»-> «Настройки STB и приложений» -> блок «Настройки сбора данных телесмотрения» (для каждого типа устройства необходимо прописать свои URL).