Smarty

  1. Домой
  2. Документы
  3. Smarty
  4. Конфигурация и обслуживание Smarty
  5. Настройка видеотеки из архивных записей

Настройка видеотеки из архивных записей

Начиная с версии Smarty 1.78.3 оператор имеет возможность настроить для своего сервиса собственную видеотеку, состоящую из архивных записей фильмов, сериалов, передач и т.д.

Раздел «Архив» в шаблоне futuristic

1. Настройка категорий архивных записей

Для фильтрации записей будут использоваться категории передач (объекты Program category в служебной панели администрирования Smarty), отображаемые в разделах телеканалов (раздел «ТВ по интересам» в шаблоне impuls, раздел «ТВ» в шаблонах futuristic и infinitly). Если на момент настройки данного раздела эти категории ещё не были созданы, то начать следует с инструкции по их настройке.

Чтобы EPG-категория отображалась в разделе архивных записей, следует дополнительно установить для нее чекбокс «Использовать для списка архивных записей»:

Форма редактирования EPG-категории в служебной панели администрирования

2. Создание подборок из EPG

После того, как настроены EPG-категории, требуется создать подборки для архивных записей. Подборка в данном контексте — это объединение объектов программ в EPG по имени (требуется для объединения серий сериалов и передач в сезоны, разных частей фильмов — в пакеты). Команда для создания подборок:

smarty_manage epg_import --create_content --settings=settings.<settings name>

Данную команду следует добавить в crontab для регулярного выполнения (рекомендуем просто добавить опцию --create_content в текущую команду импорта EPG, так как требуемая периодичность их запуска одинакова).

3. Настройка кеширования подборок

Получение подборок архивных записей на лету довольно тяжелый и долгий запрос для приложений, поэтому для его оптимизации необходимо добавить в crontab команду оффлайн-кеширования подборок:

smarty_manage cache_record_list --categories --settings=settings.<settings name>

Команда имеет 3 возможных параметра:

--categories - добавить в кэш фильтры по категориям (для отображения в экране "Архив" в левой колонке категорий EPG)
--genres - добавить в кэш фильтры по жанрам (для отображения в экране "Архив" в левой колонке жанров EPG)
--category_skip_ids - возможность убрать из кеширования программы выбранных категорий.
--genre_skip_ids - возможность убрать из кеширования программы выбранных жанров.
--client_id - создавать кеш только для конкретного Client.

Периодичность запуска данной команды рекомендуем подбирать индивидуально для своего сервиса, в зависимости от количества каналов с записями и серверных мощностей (начиная от 20 минут и чаще).

Для оптимизации работы данной команды можно использовать опции ниже:

  • TVMIDDLEWARE_PROGRAM_RECORD_LIST_DONT_CHECK_BLOCKS — при значении True отключается проверка передачи на заблокированность. Если функционал блокировки архивных передач не используется, рекомендуем включить данную опцию.
  • TVMIDDLEWARE_PROGRAM_RECORD_LIST_MINIMUM_LENGTH — исключает из выборки для экрана «Архив» передачи короче N секунд. По умолчанию 900.
  • TVMIDDLEWARE_PROGRAM_RECORD_DAYS — исключает из кэша программы старше N дней. По умолчанию 5.
  • TVMIDDLEWARE_PROGRAM_RECORD_ONLY_FINISHED — при значении True в API-методе для получения списка записей в экране «Архив» не будут передаваться ещё неоконченные передачи. Тип данных: bool. По умолчанию False.

4. Настройка очистки устаревших подборок

При устаревании архивных записей подборки, которые их содержали, становятся пустыми. Для удаления пустых подборок следует настроить команду:

smarty_manage clean_old_records --client_id=1 --settings=settings.<settings name>

Рекомендуемая периодичность запуска — один раз в сутки, но при желании можно и реже.

5. Включение нового раздела в интерфейсе

Финальный шаг настройки нового раздела — включение его для устройств в панели администрирования Smarty:

Форма редактирования устройства

6. [Опционально] Настройка отдачи фидов архивных записей

В некоторых интеграциях с медиаплатформами иногда необходимо иметь возможность отдать так называемые фиды — мета-информацию о контенте сервиса.

Подготовка фидов осуществляется менеджмент-командой cache_record_feed:

smarty_manage cache_record_feed --client_id=1 --settings=settings.<settings name>

После отрабатывания команды (предлагаем добавить ее в крон), по адресу ниже можно получить список фидов:

http://smarty.example.com/tvmiddleware/record/feed/<client_id>

Часто задаваемые вопросы:

Откуда берутся обложки (постеры) для подборок в разделе «Архив»?

В качестве обложки подборки используется превью программы, импортируемое из источника EPG. В случае, если EPG-источник не предоставляет превью передач, в приложении отображается стандартная картинка-заглушка для подборки.

Как настраивается глубина архивных записей для данного раздела?

Глубина архива совпадает с настроенной глубиной архива для каналов (настраивается для стриминг-сервиса и переопределяется на странице канала). Но в случае, если настроенная глубина архива для канала больше, чем глубина имеющейся программы передач, то глубина записи будет ограничена глубиной имеющейся программы передач.

Можно ли отдельно тарифицировать доступ к данному разделу для абонентов?

Абоненту будут доступны записи со всех доступных ему каналов.
Для записей с каналов «с замочками» при запуске будет отображено предупреждение о недоступности записи, либо показ потока-заглушки и баннера.

В каких шаблонах уже доступен данный раздел?

На текущий момент только в шаблоне futuristic, начиная с версии 460.