Данные опции позволяют изменить внешний вид и поведение приложения и задаются при сборке.
Опции также можно переопределить через панель управления Smarty в блоке «Конфигурация портала и приложений» на странице устройства, если сборка мобильного клиента это поддерживает (для Android — начиная с версии 3.6, для iOS — приложения, собранные позднее 26.01.2021).
Тегом #hardcoded помечены опции, которые зашиваются в сборку и не могут быть переопределены со стороны Smarty. Тегом #required помечены обязательные для указания опции.
Установка приложения
Длительность показа стартовой заставки
Название опции: splashScreenDuration, тип данных: int. #hardcoded
Определяет длительность показа стартовой заставки, задается в миллисекундах. По умолчанию 1500.
Сообщение о целях сбора данных
Название опции: appTrackingTransparencyMessage, тип данных: string. #hardcoded, #required
Показ сообщения о целях сбора данных при использовании уникального идентификатора IDFA. (Требование iOS 14.5+). По умолчанию null. Применяется только для iOS.
Пример сообщения: «Для продолжения использования нашего сервиса просим Вашего разрешения на отслеживание данных в соответствии с требованиями App Store. Мы храним только номер абонемента, номер телефона (если Вы его указали при регистрации) и идентификатор устройства. Ваше согласие позволит нам радовать Вас любимыми фильмами и передачами».
Показ рекламного текста
Название опции: promo_signup_screen_message, тип данных: string. #required
Позволяет указать сообщения для экрана онбординга в формате: «строка1; строка2; строка3, …», где каждая из строк, разделенных символом «;» будет отображаться отдельно. По умолчанию null.
Пример сообщения: «Microimpuls предоставляет более сотни каналов на любой вкус; Архив сохранит для вас записи всех передач, фильмов и сериалов за последние 14 дней; Скачивайте любимые фильмы и сериалы, чтобы смотреть их офлайн».
Отправка данных в сервис Yandex AppMetrica
Название опции: app_metrica_api_key, тип данных: string.
Активирует сервис аналитики AppMetrica, включающий инструменты для трекинга установок приложения и проведения персонализированных push-компаний. По умолчанию null.
Предупреждение: для работы опции недостаточно её включения, потребуются дополнительные работы, а также пересборка приложения.
Активация push-уведомлений через Firebase
Название опции: enable_firebase, тип данных: bool.
Включает Firebase-зависимую логику приложения, которая необходима для работы push-уведомлений. При включении обеспечивает запрос необходимых разрешений от пользователя. По умолчанию false.
Предупреждение: для работы опции недостаточно её включения, потребуются дополнительные работы, а также пересборка приложения.
Префикс для типа устройства
Название опции: devicePrefix, тип данных: string. #hardcoded
Позволяет добавить префикс для типа устройства, который передается в параметр device у запросов к Smarty. В обычном случае в device передается строка «ios» / «android». При установке опции в значение «test_», например, будет передаваться строка «test_ios» / «test_android». По умолчанию «» (пустая строка).
Авторизация и регистрация
Режим авторизации
Название опции: auth_mode, тип данных: string.
Возможные значения:
- password — по логину и паролю (по умолчанию).
- phone_number — по номеру телефона.
Отображение кнопки выбора способа авторизации (по логину и паролю или номеру телефона)
Название опции: show_alter_auth_button, тип данных: bool.
Возможные значения:
- true — на экране авторизации будет отображаться кнопка выбора способа логина.
- false — кнопка выбора способа логина отображаться не будет (по умолчанию).
Отключение автоматической регистрации при авторизации по номеру телефона
Название опции: disable_registration_on_phone_auth, тип данных: bool.
Возможные значения:
- true — после нажатия кнопки «Войти» на экране авторизации по номеру телефона будет выполнена попытка авторизации в аккаунт.
- false — после нажатия кнопки «Войти» на экране авторизации по номеру телефона будет выполнена скрытая попытка регистрации аккаунта с последующей авторизацией в него (по умолчанию).
Авторизация по уникальному идентификатору устройства
Название опции: try_login_without_login_password, тип данных: bool.
Возможные значения:
- true — авторизация будет происходить по уникальному идентификатору устройства или по IP-адресу.
- false — авторизация будет происходить по логину и паролю (по умолчанию).
Включение экрана регистрации
Название опции: registration_enabled, тип данных: bool.
Включает элементы регистрации на экране авторизации по номеру телефона и сам экран регистрации. По умолчанию false.
Автоматическая авторизация после регистрации
Название опции: enable_autologin_after_registration, тип данных: bool.
Возможные значения:
- true — после успешной регистрации через экран регистрации будет осуществлена попытка автоматической авторизации в новый аккаунт.
- false — после успешной регистрации через экран регистрации автоматической авторизации не будет, пользователь должен будет сам вернуться для этого на экран авторизации (по умолчанию).
Плейсхолдер номера телефона
Название опции: phone_number_placeholder, тип данных: string. #required
Опция для указания плейсхолдера для номера телефона на экране регистрации (подсказка в полях ввода, которая указывает пользователю, какую информацию следует ввести, отображается до введения какого-либо символа в поле). По умолчанию null.
Маска номера телефона
Название опции: registration_phone_mask, тип данных: string. #required
Показывает маску ввода номера телефона (шаблон, который автоматически форматирует вводимые пользователем данные в заданный стандарт). Указанные пробелы, символы и цифры являются зарезервированными символами, остальные цифры для ввода помечаются символом «d». В Smarty отправится числовое значение без пробелов и символов.
Пример маски: «+7 ddd ddd dd dd». Символ + и цифра 7 будут вставлены автоматически при вводе первого символа, последующие символы будут вставляться по заданной маске с пробелами в соответствующих позициях.
Пример маски: «+972 5d ddd dddd». Символ + и цифры 9725 будут вставлены автоматически при вводе первого символа с учетом пробелов в маске, последующие символы будут вставляться по заданной маске с пробелами в соответствующих позициях. По умолчанию null.
Использование компонента посимвольного ввода кода
Название опции: use_code_input_component, тип данных: bool.
Возможные значения:
- true — для кода подтверждения будет использоваться компонент в виде отдельных окон для ввода каждого символа (по умолчанию).
- false — для кода подтверждения будет использоваться стандартное поле ввода.
Длина кода подтверждения из SMS-сообщения
Название опции: sms_code_length, тип данных: int.
Длина SMS-кода подтверждения. По умолчанию 4.
Длина кода подтверждения по номеру телефона
Название опции: phone_code_length, тип данных: int.
Длина кода подтверждения из номера телефона. По умолчанию 4.
Отправка SMS с данными аккаунта при регистрации
Название опции: send_sms, тип данных: int.
Регулирует соответствующий параметр в запросе AccountRegister, отправлять SMS или нет на мобильный телефон с данными созданного аккаунта. Возможные значения: 0/1. По умолчанию 0.
Таймер блокировки повторного запроса кода подтверждения
Название опции: code_waiting_timer, тип данных: int.
Определяет время блокировки повторного запроса кода подтверждения в секундах. По умолчанию 60.
Длительность промо-периода после регистрации
Название опции: signup_auto_activation_period, тип данных: int.
Позволяет установить количество дней, на которое будет выдан бесплатный доступ для первичного использования аккаунта после регистрации. Регулирует параметр auto_activation_period в запросе AccountRegister. По умолчанию 0.
Задержка перед автологином после регистрации
Название опции: after_register_login_delay, тип данных: int.
Определяет длительность задержки перед автологином после регистрации, задается в миллисекундах. По умолчанию 1500.
Контент
Максимальная глубина EPG в прошлое
Название опции: max_pvr_depth, тип данных: int.
Глубина указывается в днях, если не указать значение, то глубина архива будет равна глубине записи архивных передач на каналах. По умолчанию null.
Максимальная глубина EPG в будущее
Название опции: max_future_epg, тип данных: int.
Глубина указывается в днях, по умолчанию 7 дней.
Автозапуск плеера при открытии страницы канала
Название опции: autoplay, тип данных: bool.
Включает автопроигрывание в превью-плеерах в экранах канала и передачи.
Возможные значения:
- true — запускать канал при клике на него из списка.
- false — при клике на канал/передачу в списке открывается соответствующий экран и показывается окно превью-плеера в состоянии паузы (по умолчанию). Для экрана передачи запуск возможен при наличии записи.
Отключение статических категорий для каналов
Название опции: consider_epg_channel_category, тип данных: int.
Работа данной опции справедлива только при включенном флаге TVMW_CONSIDER_PROGRAM_CATEGORY в конфигурации Smarty.
Возможные значения:
- 0 — каналы распределяются согласно только динамическим категориям (согласно передачам, идущим в данный момент на каналах).
- 1 — каналы распределяются согласно динамическим и статическим категориям (по умолчанию).
Отключение динамических категорий для каналов
Название опции: consider_program_category, тип данных: int.
Работа данной опции справедлива только при включенном флаге TVMW_CONSIDER_PROGRAM_CATEGORY в конфигурации Smarty.
Возможные значения:
- 0 — каналы распределяются согласно только статическим категориям.
- 1 — каналы распределяются согласно динамическим и статическим категориям (по умолчанию).
Включение жанров-категорий для видеотеки или архива
Название опции: use_category_genres, тип данных: int.
Возможные значения:
- 1 — группировать фильмы видеотеки согласно жанрам-категориям (жанрам, у которых проставлен чекбокс «Является категорией» в панели управления Smarty).
- 0 — группировать фильмы по обычным жанрам (по умолчанию).
Сортировка каналов
Название опции: channel_sort_id, тип данных: int.
Опция для указания идентификатора сортировки каналов. Если не передан, то используется стандартная сортировка. По умолчанию NaN.
Лента слайдера для дашборда
Название опции: slider_tape_id, тип данных: int.
Опция для указания идентификатора ленты-слайдера в дашборде. Ею может быть только лента видео или подборки видео; если опция не указана, то берется первая лента видео (не подборки) из списка лент дашборда. По умолчанию -1.
Механика генерации ленты «Похожие фильмы»
Название опции: similar_video_genre_limit, тип данных int.
В данной опции указывается количество жанров, которые нужно использовать для поиска похожих фильмов — например, по умолчанию, фильмы считаются похожими, если у них совпадает 3 жанра. По умолчанию 3.
Периодичность запросов сохранения позиции просмотра
Название опции: content_position_set_interval, тип данных: int.
Периодичность выполнения запросов к серверу Smarty для сохранения текущей позиции просмотра контента PVR и VOD для работы функции возвращения к последней сохраненной позиции просмотра. Задается в миллисекундах. По умолчанию 30000 (30 секунд).
Фильтрация контента по годам
Название опции: filtration_year_start, тип данных: int.
Определяет начальный год фильтра контента по годам. По умолчанию 1888.
Включение пользовательского рейтинга
Название опции: show_average_customers_rating, тип данных: bool.
Возможные значения:
- true — будет показываться пользовательский рейтинг.
- false — будет показываться внешний рейтинг (по умолчанию).
Отображение дисклеймера о вреде наркотических средств
Название опции: show_drugs_disclaimer, тип данных: bool.
Возможные значения:
- true — будет показываться дисклеймер в карточке контента, если возрастной рейтинг фильма не ниже порога (в приложении порог задан константой 12).
- false — дисклеймер в карточке контента показываться не будет (по умолчанию).
Отображение избранного
Название опции: show_favorites, тип данных: bool.
Включает поведение и разделы избранного. По умолчанию false.
Личный кабинет
Активация промокода
Название опции: show_promo_code, тип данных: bool.
Возможные значения:
- true — отобразить секцию активации промокода в настройках и соответствующий экран (по умолчанию).
- false — не отображать секцию активации промокода в настройках.
Отображение тарифов
Название опции: show_tariffs, тип данных: bool.
Возможные значения:
- true — отобразить раздел тарифов в экранах «Меню», «Настройки» и «Управление аккаунтом» (по умолчанию).
- false — не отображать раздел тарифов в настройках.
Отображение информации о балансе
Название опции: show_balance, тип данных: bool.
Возможные значения:
- true — в разделе «Управление аккаунтом» будет отображаться пункт «Баланс».
- false — пункт «Баланс» будет скрыт (по умолчанию).
Отображение даты окончания подписки
Название опции: show_activation_days_left, тип данных: bool.
Возможные значения:
- true — в разделе «Управление аккаунтом» будет отображаться информация о дате окончания подписки (по умолчанию).
- false — дата окончания подписки отображаться не будет.
Отображение информации о пароле
Название опции: show_password, тип данных: bool.
Возможные значения:
- true — в разделе «Управление аккаунтом» будет отображаться информация о пароле (по умолчанию).
- false — информация о пароле отображаться не будет.
Отображение кнопки смены пароля
Название опции: show_change_password_button, тип данных: bool.
Возможные значения:
- true — в разделе «Управление аккаунтом» будет отображаться кнопка смены пароля (по умолчанию).
- false — кнопка смены пароля отображаться не будет.
Отображение кнопки редактирования данных
Название опции: show_change_data_button, тип данных: bool.
Возможные значения:
- true — в разделе «Управление аккаунтом» будет отображаться кнопка редактирования данных (по умолчанию).
- false — кнопка редактирования данных отображаться не будет.
Отображение лицевого счета вместо логина
Название опции: show_ext_id, тип данных: bool.
Возможные значения:
- true — в разделе «Управление аккаунтом» будет отображаться лицевой счет (
ext_id) вместо логина. - false — в разделе «Управление аккаунтом» будет отображаться логин (по умолчанию).
Длина ПИН-кода
Название опции: max_pin_code_length, тип данных: int.
Ограничение максимальной длины ПИН-кода. По умолчанию 16.
Проверка дополнительного статуса аккаунта
Название опции: check_account_status_reason, тип данных: bool.
Возможные значения:
- true — дополнительный статус аккаунта будет проверяться даже в случае успешной авторизации. Например, если аккаунт активен, но в дополнительном статусе установлено «Заблокирован по задолженности», то в портале будет выдана соответствующая ошибка авторизации.
- false — дополнительный статус проверяться не будет (по умолчанию).
Периодичность запросов статуса аккаунта
Название опции: account_status_interval, тип данных: int.
Позволяет задать кастомное значение интервалов запроса AccountStatus в портале. При указании малого значения (<60000) проверка будет осуществляться с интервалом 1-2 минуты. Задается в миллисекундах. Значение по умолчанию 600000 (10 минут).
Шаблон дашборда
Название опции: dashboard_template, тип данных: string.
Регулирует параметр template в запросе PortalDashboardList, описывающий название шаблона UI, который используется в данный момент на устройстве. По умолчанию futuristic.
Комментарий к юридическим документам
Название опции: legal_docs_message, тип данных: string.
Определяет текст рядом с юридическими документами на экране авторизации/регистрации.
Пример сообщения: «продолжая вы принимаете». Для отображения строки и правовых документов нужно, чтобы строка была задана и пришел хотя бы один правовой документ с типом «Показывать при авторизации» (для экрана авторизации) или «Показывать при регистрации» (для экрана регистрации) со Smarty. По умолчанию null.
Отображение «Политики конфиденциальности»
Название опции: legal_document_policy_id, тип данных: int.
Опция для указания идентификатора документа, регулирует отображение пункта «Политика конфиденциальности».
Возможные значения:
- >0 — в разделе «Управление аккаунтом» будет отображаться «Политика конфиденциальности».
- -1 — «Политика конфиденциальности» отображаться не будет.
Отображение «Пользовательского соглашения»
Название опции: legal_document_user_terms_id, тип данных: int.
Опция для указания идентификатора документа, регулирует отображение пункта «Пользовательское соглашение».
Возможные значения:
- >0 — в разделе «Управление аккаунтом» будет отображаться «Пользовательское соглашение».
- -1 — «Пользовательское соглашение» отображаться не будет.
Отображение «Правил пользования сервисом»
Название опции: legal_document_service_usage_rules_id, тип данных: int.
Опция для указания идентификатора документа, регулирует отображение пункта «Правила пользования сервисом».
Возможные значения:
- >0 — в разделе «Управление аккаунтом» будут отображаться «Правила пользования сервисом».
- -1 — «Правила пользования сервисом» отображаться не будут.
Телефоны технической поддержки
Название опции: supportPhoneNumbers, тип данных: array. #hardcoded
Определяет список телефонов поддержки с указанием страны (с локализацией) и номер телефона, при нажатии на который открывается номеронабиратель с указанным номером.
Пример:
var CLIENT_SETTINGS = {
// …
supportPhoneNumbers: [
{
country: {
ru: 'Россия',
en: 'Russia',
},
number: '8 (499) 647-49-78',
},
{
country: {
ru: 'Другие страны',
en: 'Other countries',
},
number: '8 (499) 647-49-58',
},
],
};
Ссылка на канал технической поддержки
Название опции: supportLink, тип данных: string. #hardcoded
Определяет ссылку на внешний канал поддержки (чат/сайт/кабинет).
Пример: «Чат поддержки в ВК».
Оплата
Шаблон платежной страницы
Название опции: payment_template, тип данных: string.
Регулирует параметр template в запросе PaymentCreate, описывающий название шаблона формы (если есть поддержка шлюзом), на которую будет осуществляться редирект при оплате. По умолчанию null.
Тип мерчанта для оплаты с экрана
Название опции: merchant_type, тип данных: string.
Возможные значения:
- пустое значение — будет использоваться мерчант, установленный на сервере по умолчанию (по умолчанию).
- w1 — мерчант Wallet One.
- paymaster — мерчант Paymaster.
- payture — мерчант Payture.
