Опции нового мобильного приложения

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

Опции также можно переопределить через панель управления Smarty в блоке «Конфигурация портала и приложений» на странице устройства, если сборка мобильного клиента это поддерживает (для Android — начиная с версии 3.6, для iOS — приложения, собранные позднее 26.01.2021).

Тегом #hardcoded помечены опции, которые зашиваются в сборку и не могут быть переопределены со стороны Smarty. Тегом #required помечены обязательные для указания опции.

Установка приложения

Содержаниепоказать

1.Установка приложения
1.Авторизация и регистрация
1.Контент
1.Личный кабинет
1.Оплата
1. 1.1.Шаблон платежной страницы
2. 1.1.Тип мерчанта для оплаты с экрана

Длительность показа стартовой заставки

Название опции: 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.