Smarty

  1. Домой
  2. Документы
  3. Smarty
  4. Интеграция с онлайн-кинотеатрами
  5. PREMIER

PREMIER

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;
  • Выбрать тарифные пакеты, созданные ранее и описанные выше. Абоненты, у которых подключен первый тарифный пакет, будут видеть фильмы в видеотеке и иметь возможность купить подписку на них;
  • Указать дополнительные атрибуты внешней системы в правом блоке страницы — имя партнера и идентификатор коллекции фильмов (данные можно запросить через персонального менеджера);
Пример с настроенной интеграцией API

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 в шаблоне Microimpuls
Описание фильма кинотеатра PREMIER в шаблоне Microimpuls

Настройка статистики для кинотеатра PREMIER

Для полноценной интеграции кинотеатра, необходимо настроить отправку статистики о просмотрах в PREMIER. Для этого необходимо совершить следующие действия:

  • Получить у менеджера ссылки на события начала просмотра и хартбита для каждого устройства (на каждый тип устройства должно быть 2 ссылки).
  • Вписать эти ссылки на страницы устройств в «Общие настройки»-> «Настройки STB и приложений» -> блок «Настройки сбора данных телесмотрения» (для каждого типа устройства необходимо прописать свои URL).
Пример экрана с настроенной отправкой статистики PREMIER