Инструменты пользователя

Инструменты сайта


provisioning

Содержание

Настройка функционала приставки провайдером (provisioning)

Для настройки функционала STB используется специальный xml-файл, размещенный по постоянному адресу http://[PROVISION_ADDR]/prov/tvip_provision.xml

В стандартной прошивке адрес сервера provisioning: tvipstb.net

Разным приставкам в сети можно отдавать разные варианты данного xml файла средствами веб-сервера, в зависимости от IP-адреса или MAC-адреса устройства (Header: Mac-Address).

Пример выдачи различных ограничений в зависимости от MAC-адреса STB для веб-сервера nginx:

                set $tvipres "";
                set $tvipmac "";
                if ($http_mac_address) {
                    set $tvipmac M;
                }
                if ( -d "/var/www/tvipstb.net/prov.mac/$http_mac_address/" ) {
                    set $tvipres  F$tvipmac;
                }
                if ( $tvipres = FM ) {
                    rewrite ^/prov/(.*)$ /prov.mac/$http_mac_address/$1 break;
                }

В данном примере запросы с разными MAC-адресами попадают в разные каталоги на веб-сервере: /var/www/tvipstb.net/prov.mac/МАК_АДРЕС_УСТРОЙСТВА/

:!: Если при запросе URL http://tvipstb.net/prov/tvip_provision.xml приставка получает ошибку 404, все настройки провайдера отменяются.

Выбор сервера провиженинга медиацентром

По-умолчанию провиженинг производится с сервера http://tvipstb.net. Существует возможность его переопределения через настройки провижининга, через протокол TR-069, через выдачу специальных опций DHCP-сервером.

Адрес сервера провиженинга обрабатывается согласно следующим приоритетам:

В прошивках до 4.1.x включительно:

  1. TR-069 - адрес сервера, полученный от ACS TR-069
  2. Адрес зашитый в устройстве, может быть установлен на этапе производства и переопределен файлом провиженинга (директивой provision_server) , на всех медиацентрах, кроме S-Box v.300 и v.310, сброс к заводским настройкам не сбрасывает данное значение.
  3. Адрес сервера, полученный по DHCP
  4. Значение в прошивке (В стандартной прошивке это tvipstb.net), сброс к заводским настройкам не сбрасывает данное значение.

В прошивках с 4.2.x:

  1. Адрес зашитый в устройстве, может быть установлен на этапе производства и переопределен файлом провиженинга (директивой provision_server) , на всех медиацентрах, кроме S-Box v.300 и v.310, сброс к заводским настройкам не сбрасывает данное значение.
  2. TR-069 - адрес сервера, полученный от ACS TR-069
  3. Адрес сервера, полученный по DHCP
  4. Значение в прошивке (В стандартной прошивке это tvipstb.net), сброс к заводским настройкам не сбрасывает данное значение.

Конфигурирование домена для провижионинга tvipstb.net

:!: Для использования провижионинга нужно настроить локальный домен tvipstb.net

пример конфигурации домена tvipstb.net для bind:

$TTL 1200
tvipstb.net        IN SOA  ***HOSTNAME_ВАШЕГО_DNS***. dnsmaster.tvipstb.net. (
                                201380101 ; serial
                                10800      ; refresh (3 hours)
                                3600       ; retry (1 hour)
                                604800     ; expire (1 week)
                                3600       ; minimum (1 hour)
                                )
                        NS      ***HOSTNAME_ВАШЕГО_DNS***.
                        A       *******АДРЕС_ВАШЕГО_СЕРВЕРА****

Файл tvip_provision.xml

Базовая структура файла tvip_provision.xml:

<?xml version="1.0"?>
<provision reload="86400">
  <!-- Modules -->
</provision>

Атрибут reload указывает интервал проверки обновлений приставкой файла tvip_provision.xml на сервере в секундах. По-умолчанию: 86400. Вместо <!– Modules –> находятся теги модулей настройки, описанные ниже.

Модули и фильтрация

Модуль является прямым наследником тэга provision.
Начиная с версии прошивки 5.0.33 появилась возможность отдавать разные модули настройки провиженинга для разных устройств. Для этого создается дополнительная секция и указываются устройства, для которых она будет доступна

Пример:

<tv_protocols devices="s605,s530"  override="true" default="jsonapi"  autostart="true"   >
     <protocol type="jsonapi" server="http://example.com" />
</tv_protocols>
<tv_protocols devices=""  override="true"  default="jsonapi"  autostart="true" >
      <protocol type="jsonapi" server="https//example2.com" />
</tv_protocols>        

* device - модель приставки
В данном примере приставки s605 и s530 получат адрес сервера middleware example.com, все остальные example2.com.
:!: Приставки с более ранней версией прошивки, чем 5.0.33, будут получать последний адрес сервера middleware.

Информация о сервере обновлений

Поддерживается начиная с прошивки 1.0.28
Используется в случае, если оператор использует локальное зеркало обновлений или просто желает использовать адрес сервера обновлений, отличный от tvipupdate.net

<update_server name="tvipupdate.operator.domain" />

Атрибут name задает имя сервера обновлений.

  • Алгоритм обработки приоритетов адресов серверов обновлений
  • Указанный адрес сервера будет записан в /var/tvip/update_server.prov
  • Все официальные обновления всегда доступны на альтернативном сервере обновлений: update.tvip.ru

Информация о сервере TR-069 (ACS)

Поддерживается начиная с прошивки 3.8.6
Позволяет установить URL, логин и пароль для подключения к ACS по протоколу CWMP.

<tr69_server url="http://myacs.net/TR-069" user="test" password="test" />

Информация о сервере syslog

Поддерживается начиная с прошивки 3.9.13
Позволяет указать ip-адрес сервера syslog на который приставка будет дублировать лог /var/log/syslog. При передаче используется протокол UDP и порт 514.

<syslog_host name="1.1.1.1"/>

Для применения данной настройки требуется перезагрузка приставки.
Чтобы выключить отправку логов - необходимо передать пустое поле name

<syslog_host name=""/>

Информация о сервере статистики

Поддерживается начиная с прошивки 4.0.13
Позволяет указать URL сервера на который приставка будет посылать статистику

<statistics url="http://domain/stbstat/index.php" accum_period="45">
  <media />
  <network period="20" />
</statistics>

Атрибуты тега statistics:

  • url - адрес сервера, на который будет передаваться статистика
  • accum_period - период в секундах, за который статистика аккумулируется и пересылается серверу

Атрибуты тега network (сброс статистики сетевых интерфейсов):

  • period - период съема статистики с сетевых интерфейсов.

Атрибуты тега media (сброс статистики плеера):

  • period - период съема статистики для плеера. При его отсутствии приставка будет посылать статистику по потоку только после его остановки. Иначе и периодически, и после остановки.

Информация о provisioning сервере

Поддерживается начиная с прошивки 3.1.0
Позволяет перенаправить запрос настроек оператора на другой сервер provisioning. Запрос на новый сервер будет выполнен немедленно.

<provision_server name="http://tvipstb.net" />

Атрибут name задает имя нового сервера provisioning.
Начиная с прошивки 3.4.x, адрес сервера сохраняется даже при сбросе приставки к заводским настройкам.
В прошивках 4.x.x рекомендуется использовать полный URL (с http/https).
Для сброса адреса сервера необходимо в явно указать пустой атрибут name:

<provision_server name="" />

Перезагрузка приставки при обновлении провижининга

Поддерживается начиная с прошивки 3.4.0

<restart value="reboot" />

Возможные значения:
shell - реинициализация приложения.
reboot - перезагрузка приставки.

Информация о типах обновлений

Поддерживается начиная с прошивки 3.1.0
Задает список типов обновлений, на которые разрешена перепрошивка пользователем. Например, пользователи могут иметь доступ к Beta и Release версиям прошивок. Версия «release» присутствует в меню всегда в виде пункта «По-умолчанию».

<update_types>
  <device id="s400a">
    <type name="Android/Beta" os="android" type="beta" />
    <type name="Linux-Qt/Release" os="linux-qt" />
  </device>
  <device id="s300" force_type="release" force_os="linux">
  </device>
</update_types>

Атрибут id в теге device задает тип медиацентра, к которому применяется настройка (например, s410, s500, s500a).

Атрибуты тега type:

  • name - название типа обновления для отображения пользователю;
  • os - тип операционной системы (например, «linux», «linux-qt», «android»);
  • type - тип обновления в указанной ОС (например, «release», «beta»).

Если не указан атрибут os, то по-умолчанию подразумевается текущая установленная ОС. Если не указан атрибут type, то по-умолчанию подразумевается тип «release». По-умолчанию означает что данный параметр не менялся вручную через меню, либо не установлен принудительно (force) через provisioning.

Возможно принудительное указание типа обновления через установку атрибутов:

  • force_os - тип операционной системы (например, «linux», «linux-qt», «android»);
  • force_type - тип обновления в указанной ОС (например, «release», «beta»).

В данном примере приставки S400 (на ОС Android) имеют доступ к прошивкам типа «android/release» (по-умолчанию) и к Beta-прошивкам на ОС Android («android/beta»). Также они имеют возможность смены ОС на Linux-QT («linux-qt/release»).
Приставки S300 имеют доступ только к «release» версиям текущих linux-прошивок. Также тип обновления всегда выставляется в «release» автоматически.

Подробнее о типах прошивок в истории версий.

Управление установкой обновлений

Поддерживается начиная с прошивки 3.4.0

<updates>
  <update_background force="true" value="true" />
  <update_force force="true" value="true" />
  <update_period force="true" value="10800" />
</updates>

update_background - В диалоге «доступно обновление» будет принудительно запущен таймер обновления (вне зависимости от локальных настроек).
update_force - В диалоге «доступно обновление» не будет кнопки «отмена».
update_period - Периодичность проверки обновлений в секундах (возможны любые значения в диапазоне от 3600 до 86400 секунд). Период порверки менее часа можно установить только локально через интерфейс приставки.

Для принудительного включения нужного режима необходимо у нужного парамерта указать атрибут force с значением «true».

Информация об операторе

Задает базовую информацию об операторе, предоставляющем настройки. В данный момент поддерживается установка имени оператора.

<operator name="Operator_Name" />

Атрибут name задает имя оператора.

:!: Следующие атрибуты доступны, начиная с версии 3.8.11.
tv_app_name - задает название ТВ приложения вместо стандартного «Телевидение».
tv_app_icon - задает идентификатор альтернативной иконки для приложения ТВ.

Логотип оператора

Устанавливает URL логотипа для отображения в главном меню. Ограничения:

  • формат PNG, разрешен альфа-канал
  • размер не более 300×300 пикселей
  • для версии прошивки 4.0.11 и выше: рекомендуемый размер ширина 230 пикселей, высота 110 пикселей, в случае если используется изображение большего размера оно автоматически масштабируется в указанный размер с сохранением пропорций

Для принудительного обновления логотипа необходимо изменить URL изображения.

В случае если используется баннер - логотип отключается (справедливо для версии 4.0.11 и выше)

<logo url="http://tvipstb.net/prov/logo.png" />

Атрибут url содержит URL логотипа на сервере оператора.

Поддерживается начиная с прошивки 4.0.11

Устанавливает URL баннера для отображения в главном меню.

Ограничения: формат PNG, размер 1920×180 пикселей, ознакомьтесь с рекомендациями по оформлению баннера

Для принудительного обновления логотипа необходимо изменить URL изображения.

<banner url="http://tvipstb.net/prov/banner.png" uri="tvplayer/?channel=1"/>

Атрибут url содержит URL баннера на сервере оператора; uri содержит системный URI для выполнения действия при клике на баннер (с прошивки 4.1.9).

Загрузочный экран

Поддерживается начиная с прошивки 3.4.0
Устанавливает URL изображения для отображения при загрузке приставки. Ограничения: формат BMP, размер 1280×720 пикселей. Глубина цвета 24bpp. Для принудительного обновления логотипа необходимо изменить URL изображения.

<bootlogo url="http://tvipstb.net/prov/tvip_splash.bmp" />

Атрибут url содержит URL логотипа на сервере оператора.

Фоновая картинка

Поддерживается начиная с прошивки 4.2.33

Возможность назначить цветную фоновую картинку для экрана Домой

<main_menu_background url="https://www.my_background.png" refresh="3600" />

Атрибуты тега main_menu_background:

  • url - адрес сервера, с которого будет браться фоновая картинка
  • refresh - время обновления в сек

Настройка времени и часового пояса

Позволяет настроить часовой пояс, а также указать NTP-сервер для синхронизации времени.

<time tz="Europe/Moscow" ntp="ru.pool.ntp.org" time_format="24" />

Атрибут tz задает часовой пояс в формате zoneinfo. Атрибут ntp задает адрес NTP-сервера. Атрибут time_format (с прошивки 4.2.3) задает формат отображения времени «12» (12-часовой AM/PM) или «24» (24-часовой).

В данном примере часовой пояс устанавливается на Москву, а сервер NTP на ru.pool.ntp.org.

Разрешенные приложения

Позволяет ограничивать доступ к приложениям медиацентра, таким как DVR, CCTV, VOD, медиаплеер.

Типы приложений: mediaplayer - медиаплеер, dvr - видеомагнитофон, cctv - видеонаблюдение, vod - видео по запросу (в разработке). В прошивках от 3.3.x также доступны: tv - телевидение, settings - настройки, apps - приложения (Android). В прошивках от 3.9.x также доступно: navigator - браузер. В прошивках от 4.1.x также доступно: search - поиск.

По-умолчанию доступны все приложения, кроме находящихся в разработке.

<features>
  <mediaplayer enabled="true" />
  <dvr enabled="true" />
  <cctv enabled="false" />
  <vod enabled="false" />
  <navigator enabled="false" />
  <timeshift enabled="false"/>
  <rustore enabled="true" />
  <appstore enabled="false" />
</features>

Имя тега - тип приложения, атрибут enabled - доступно (true) или недоступно (false).

В данном примере доступны приложения IPTV, Медиаплеер, Видеомагнитофон (DVR). Недоступны: Видеонаблюдение (CCTV), Видео по запросу (VOD).

Атрибуты тега timeshift enabled: (Поддерживается начиная с прошивки 4.2.33)

  • true - включение локального timeshift (по умолчаию)
  • false - отключения локального timeshift

:!: Тег appstore - «Магазин приложений», доступен только для 7хх моделей.
Тег rustore - Включает магазин приложений Rustore (Поддерживается начиная с прошивки 5.1.26)

Добавление и скрытие Веб-приложений

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

<webapps>
   <app name="lk" title="Личный кабинет" icon="account" uiwidth="1280" uiheight="720" url="http://private.provider.com" api="mag"/>
     <app name="plex"/>
   <app name="youtube" hidden="true" />
</webapps>

Данный код ставит на первое место приложение «Личный кабинет» на второе Plex и скрывает приложение YouTube.

Если атрибут override равен true, то все приложения по-умолчанию будут скрыты; если false, то новые приложения будут добавлены к уже существующим в прошивке.
:!: Начиная с версии 5.0.33, атрибут override объявлен устаревшим и не рекомендуется к использованию. Вместо него нужно использовать атрибут hidden для системных приложений.

Если атрибут reordering равен true, то это позволяет менять порядок WEB приложений кнопкой menu, поддерживается с версии firmware 5.0.48

Атрибуты веб-приложения:

  • name - уникальное имя приложения (латинские буквы без пробелов), не должен пересекаться с зарезервированными именами (см. ниже) и с именами уже имеющихся Веб-приложений;
  • title - название для отображения в меню;
  • hidden - скрыть системное приложение с указанным name (начиная с версии 5.0.33).
  • icon - кодовое имя иконки в главном меню;
  • bgr - URL до изображения в формате PNG которое будет использовано вместо плитки приложения. Ограничения: ширина 320 px и высота 180 px, начиная с версии 4.0.11 * *
  • uiwidth и uiheight - разрешение для отображения страницы;
  • url - адрес Веб-страницы;
  • api - типа STB API (tvip/mag/html5/youtube/blink);
  • proxy - HTTP/HTTPS прокси сервер (при необходимости).
  • dial_origin - использовать DIAL протокол для запуска приложения через second screen c указанным origin (начиная с версии 4.0.19).
  • dial_title - название приложения для вещания по DIAL проколу.
  • search_script - адрес JavaScript скрипта для организации системного поиска по приложению (начиная с версии 4.1.4).

:!: Для системных приложений доступен только атрибут hidden
Обязательные атрибуты для не системных приложений: name, title, uiwidth, uiheight, url, api. Если иконка не задана, используется поле name. Если иконка не найдена, используется иконка «vod».

Зарезервированные имена приложений name:

  • «tvplayer» (ТВ),
  • «dvr» (Видеомагнитофон),
  • «mediaplayer» (Медиаплеер),
  • «vod» (Кино),
  • «cctv» (Видеонаблюдение),
  • «preferences» (Настройки),
  • «allapps» (Приложения Android).

Имена веб-приложений по-умолчанию:

  • «account» (Личный кабинет),
  • «youtube» (Youtube),
  • «youtube_kids» (YouTube Kids),
  • «ivi» (Ivi.ru),
  • «kinopoisk» (Кинопоиск),
  • «startapp» (start.ru),
  • «rutube» (rutube.ru),
  • «plex» (Plex),
  • «okko» (Okko)
  • «tvigle» (Tvigle),

Имена для атрибута icon соответствуют зарезервированным именам name. Для собственного Веб-приложения можно использовать любую из доступных иконок.

:!: Начиная с версии 5.0.33, нельзя изменять конфигурацию (URL, иконку и т.д.) зарезервированных приложений. В случае необходимости замены системного приложения, его нужно скрыть и создать свое с другим name.

Конфигурация по-умолчанию в прошивке находится в файле: /home/tvip/profiles/<profile>/tvip_webapps.xml
:!: Обратите внимание, что для работы приложений YouTube на прошивках 4.2.x и выше необходимо использовать протокол HTTPS и api=«youtube».

Чтобы вернуться в главное меню, приложение должно переходить на страницу «about:back» при выходе.

Чтобы отключить все Веб-приложения, используйте код:

<webapps override="true">
</webapps>

В текущих прошивках для корректного применения настроек Веб-приложений требуется перезагрузка приставки!

Добавление и скрытие Android-приложений

:!: Модуль доступен только в прошивках для Android OS, начиная с версии 5.0.30.
Позволяет изменять порядок приложений, а так же скрывать установленные приложения.

<android_apps>
     <app name="MediaCenter" title="MyMediaCenter" package="com.droidlogic.mediacenter" hidden="false" bgr="http://tvip.com/myMediaCenter.png"  /> 
     <app name="VideoPlayer" title="MyVidoPlayer" package="com.droidlogic.videoplayer" hidden="true" icon="http://tvip.com/icon.png"/>
</android_apps>

Атрибуты Android-приложения:
name - уникальное имя приложения
title - название для отображения в меню;
package - название пакета в системе;
hidden - позволяет скрывать приложения при значении «true»
icon - позволяет изменить иконку приложения;
bgr - позволяет изменить фон для приложения;

Обязательные атрибуты: package

Установка типа транспортного потока

Позволяет установить тип транспортного потока: мультикаст или UDP-прокси.

<tv_stream type="multicast" tsbuffer="100" tsboost="false" hls_version="4" />

Атрибут type устанавливает тип потока. В данном примере: мультикаст. Возможные значения: multicast,udpxy

Атрибут tsbuffer устанавливает размер MPEG-TS буфера с мсек. (по умолчанию 0мс, Поддерживается начиная с прошивки 3.3.1 )

Атрибут tsboost при заначениее (false) запрет «отрезания» лишнего аудио при старте MPEGTS (Поддерживается начиная с прошивки 4.2.33)

Атрибут hls_version возможность установить версию HLS (Поддерживается начиная с прошивки 4.2.33)

<tv_stream type="udpxy" server="http://user:pwd@host.ru:4022" />

В данном примере типа потока UDP-прокси. Адрес udpxy сервера в формате server_address:port или user:password@server_address:port задается атрибутом server.

Атрибут speedtest_url задает URL к конфигурации для тестирования скорости (поддерживается с прошивки 4.2.20/4.3.4).

Настройка протоколов IPTV

Позволяет преднастроить параметры доступа к услугам IPTV.

<tv_protocols default="tvip" force="tvip">
</tv_protocols>

default - задает тип Middleware по умолчанию.
force - принудительно выставляет тип Middleware.
autostart - запускать (true) ТВ приложение после перезагрузки и сна. По-умолчанию, включено.

Поддерживаемые типы Middleware:

  • tvip - TVIP Middleware.
  • jsonapi - TVIP Json Middleware API.
  • m3u - M3U плейлист.
  • iptvportal - IPTVPORTAL Middleware.
  • browser - Middleware в режиме веб-приложения (поддерживается только в прошивках Linux-Qt).
  • androidapp - Android приложение (поддерживается только в Android OS)

Настройка сервера для TVIP JSON Middleware API

<tv_protocols default="jsonapi">
 <protocol type="jsonapi" server="http://api.operator.com/" hidden="true" />
</tv_protocols>
  • server - URL для доступа к API устанавливается атрибутом server.
  • hidden - Позволяет скрыть адрес TVIP Middleware сервера. Поддерживается с прошивки 5.0.7

Настройка сервера для IPTV-портал

Требуется только если оператор использует собственный сервер IPTV-портал.

<tv_protocols default="iptvportal">
 <protocol type="iptvportal" server="go.iptvportal.ru" />
</tv_protocols>

Доменное имя сервера устанавливается атрибутом server.

Настройка M3U плейлиста и XMLTV/JTV телепрограммы.

Позволяет предустановить URL для загрузки списка каналов в формате M3U и телепрограммы в формате XMLTV или JTV.

<tv_protocols default="m3u">
  <protocol type="m3u" m3u="http://operator.com/channels.m3u" epg="http://operator.com/epg.zip" />
</tv_protocols>

URL m3u плейлиста задается атрибутом m3u. URL телепрограммы задается атрибутом epg.

Настройка сервера для Веб-приложения ТВ-портала

Настройка ТВ-портала вместо IPTV-приложения TVIP. Доступно в прошивках типа linux-qt.

<tv_protocols default="browser">
 <protocol type="browser" server="http://provider.net/portal/" api="tvip" noui="false" combined="false" />
</tv_protocols>

Атрибут server устанавливает URL портала (middleware) для браузера; api задает тип JavaScript API, используемый на данном портале («tvip», «mag», «html5»).
Если атрибут noui равен true стандартный интерфейс TVIP полностью заменяется браузером (режим «Для всей системы»), если false, то портал браузера работает только в разделе ТВ (режим «Только для ТВ»). Если атрибут combined равен true, а noui равен false, то используется режим «Комбинированный» (доступен с v.4.0.23).

:!: Режим «Для всей системы» объявлен устаревшим, не рекомендуется к использованию и будет удален в будущих обновлениях. Вместо него нужно использовать режим «Комбинированный». Для блокировки возможности выхода в домашний экран по долгому нажатию Home, можно использовать тег home_uri со значением tvplayer в теге appearance.

Опциональные атрибуты:
proxy - HTTP/HTTPS-прокси сервер;
uiwidth и uiheight - разрешение для отображения страницы(по умолчанию 1280×720);
cas - тип CAS (на данный момент только «ares» для IPTVPORTAL).
multi_portal - включить (true) или выключить (false) Менеджер порталов. (доступен с v.3.8.19);
multi_portal_params - если включен Менеджер порталов, опция позволяет предопределить порталы, доступные пользователю. (доступно с v.3.8.19);
Параметры для Менеджера Порталов задаются по следующему шаблону: "server1=Server 1 Name|http://server1.domain/path&server2=Server 2 Name|http://server2.domain/path"
Для указания портала загружаемого по умолчанию нужно установить параметр default для нужного портала: "server1=Server 1 Name|http://server1.domain/path|default&server2=Server 2 Name|http://server2.domain/path" ;
force_retry - при значении true принудительно будет пытаться подключиться к порталу при его недоступности или сетевых проблемах. (доступно с v.5.0.16)
waiting_animation - при значении false отключает «анимацию загрузки» во время загрузки портала. (:!: атрибут доступен в AndroidOS начиная с fw 5.1.10 )

Использование приложения как источник контента

:!: Модуль доступен только в прошивках для Android OS
Позволяет использовать приложение в качестве источника контента.

<protocol type="androidapp" package="xxxxx" autostart="false" />

Атрибуты:
package - название пакета в системе;
autostart - позволяет запускать приложение автоматически, доступно с версии 5.0.25.

Параметры Безопасности

Поддерживается начиная с прошивки 3.4.0

Позволяет настроить функции блокировки ТВ-каналов и приложений.

Например:

<security>
        <enabled value="true" force="true" />
        <password value="0000" force="true" />
        <autolock_timeout value="600" force="true" />
        <channel_default_locked value="true" />
        <channel_adult_lock value="true" />
        <operator_forced_age value="18" />
        <disabled_apps force="true" value="vidimax,youtube" />
</security>

Параметр enabled включает режим безопасности, одновременно с ним нужно установить код разблокировки password. Для принудительного включения режима - необходимо у параметров enabled и password указать атрибут force с значением «true».
autolock_timeout - задает таймаут автоблокировки в секундах.
channel_default_locked - Блокировки ТВ-каналов (true - Из черного списка, false - Все, кроме белого списка).
channel_adult_lock - Блокировать каналы для взрослых (поддержка блокировки каналов из Middleware (TVIP, Stalker, IPTVPORTAL)). Только для прошивок 3.8 и ниже.
operator_forced_age - Блокировать каналы для взрослых с меткой возраста равной и более указанной. Только для прошивок 4.0.11 и выше.
disabled_apps - Указанные через запятую приложения будут требовать ввода кода разблокировки.

Настройки Дисплея

Поддерживается начиная с прошивки 3.4.0 (на Linux)

<display>
  <hd_format value="720p50" />
  <hdmi_autofr value="false" />
  <sd_format value="auto" />
  <aspect value="box" />
  <cec value="false" force="true" />
  <sync_standby value="true" />
  <cec_name value="nameSTB" />
</display>

hd_format - Разрешение HDMI-выхода (auto,2160p50,2160p60,1080p50,1080p60,1080i50,720p50,720p60,576i50).
sd_format - Формат A/V-выхода (auto,pal,ntsc).
hdmi_autofr - Включение для HDMI-выхода - автоматического определения частоты кадров.
cec - Включение функции HDMI-CEC.
aspect - Соотношение сторон видео по умолчанию (box,zoom,full), Для выбора соотношения сторон по умолчанию value=«».
sync_standby - Переводить приставку в сон и обратно при выключении/включении ТВ (поддерживается не на всех медиацентрах, с прошивки 4.0.13).
cec_name - Позволяет задать имя устройства через HDMI на совместимых телевизорах. Формат [Aa-Zz,-, ,_,0-9] до 14 символов (поддерживается с прошивки 5.1.26).

Для принудительного включения нужного режима необходимо у нужного параметра указать атрибут force с значением «true».

Настройки перехода в спящий режим

Поддерживается начиная с прошивки 3.8.6

  <auto_standby timeout="3600" force="true" />

timeout - время неактивности в секундах, после которого происходит переход в спящий режим (возможные значения: от 60 до 2500000, или 0 - выкл.).
force - true -переназначать значение пользователя.

Настройки Оформления

Поддерживается начиная с прошивки 3.4.0

<appearance>
  <uialpha value="50" /> 
  <animation value="true" force="true" />
  <listlooped value="true" />
  <uipadding value="large" />
  <tv_preview_mode value="true" force="true" />
  <tv_cursor_mode value="true" />
  <display_channel_numbers value="true" />
  <channel_icons_aspect value="1.777"/>
  <home_uri value="" />
  <display_channel_has_archive value="true" />
  <background_picture value="Custom" force="true">
  <picture name="Custom" url="http://domain/Custom.png"/>
  </background_picture>
  <media_freeze_animation value="false" />
  <back_as_recall value="true" /> 
  <menu_as_home value="true" />
</appearance>
  • uialpha - Процент прозрачности интерфейса (0-100%) - недосупно в версиях начиная c 4.0
  • animation - Включение (true) и выключение (false) анимации интерфейса.
  • listlooped - Круговая прокрутка списков.
  • uipadding - Настройка Overscan («small» - маленький, «medium» - средний, «large» - большой).
  • tv_preview_mode - Включение окна с предпросмотром для ТВ (false - окно отсутствует, true - в окне текущий играющий канала, hybrid - в окне превью канала под курсором).
  • tv_cursor_mode - Включение режима, в котором при просмотре ТВ громкость контролируется кнопками Влево/Вправо, а каналы переключаются кнопками Вверх/Вниз.
  • display_channel_numbers - Включение (true) и выключение (false) отображения номеров каналов в ТВ (поддерживается с прошивки 4.0.17).
  • channel_icons_aspect - Соотношение сторон логотипов каналов (aspect=ширина/высота). Используется для оптимизации интерфейса (поддерживается с прошивки 4.0.20).
  • home_uri - Позволяет задать системный URI, вызываемый при нажатии кнопки Домой, вместо перехода в домашний экран (поддерживается с прошивки 4.2.12).
  • display_channel_has_archive - активирует (если true) отображение иконки наличия архива в списке каналов. Поддерживается с прошивки 4.2.16.
  • background_picture - устанавливает монохромный фон на главном экране (и в некоторых других). value - задает идентификатор фоновой картинки. Идентификатор может быть встроенный (варианты: waves, triangles) или один из заданных в списке тегом <picture>. Атрибуты тега <picture>: name - идентификатор фона, url - URL 8-битного монохромного изображения PNG. Поддерживается с прошивки 4.2.16.
  • media_freeze_animation - Запрет анимации «зависания» видео (false) - включено (true) - отключено (поддерживается с прошивки 4.2.33).
  • back_as_recall - позволяет назначить на кнопку назад функцию возврата к предыдущему каналу (поддерживается с прошивки 5.0.67).
  • menu_as_home - позволяет использовать кнопку menu для вызова действия home, кроме случаев когда используется по прямому назначению, этот функционал работает только в приложении ТВ (поддерживается с прошивки 5.0.67).

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

Настройка цветовых схем пользовательского интерфейса

Поддерживается начиная с прошивки 4.0.17

<appearance>
  <color_schemes value="true" override="true" default="Berries" force="Berries">
    <scheme name="TVIP brand color">
      <color name="CL_MAIN" value="#ff2A50A3" />
      <color name="CL_BACKGROUND" value="#ff14A2DC"/>
      <color name="CL_CONTRAST_MAIN" value="#ffCAE2F5"/>
      <color name="CL_CONTRAST_BACKGROUND" value="#ffCAE2F5"/>
      <color name="CL_SECOND" value="#ffF37121"/>
      <color name="CL_button_casual" >CL_BACKGROUND</color>
    </scheme>
    <scheme name="Berries">
    </scheme>
  </color_schemes>
</appearance>
  • color_scheme - управление цветовыми схемами пользовательского интерфейса. Атрибуты: override - если true, предустановленный цветовые схемы будут полностью заменены описанными; default - название цветовой схемы по-умолчанию; force - название принудительно выбранной цветовой схемы.
    • scheme - описание собственных схем, обязательный атрибут name - определяет уникальное имя схемы.
      • color - определяет цвет оформления, обязательный атрибут name - указывает на элемент интерфейса к которому будет применен цвет. формат цвета указывается в атрибуте value в формате #AARRGGBB.

Базовые цвета схемы:

  • CL_MAIN - главный цвет темы, используется среди элементов с наименьшей прозрачностью, чаще всего сверху и снизу экрана (по умолчанию #ff37363c).
  • CL_BACKGROUND - цвет предназначенный для отображения элементов по центру экрана и фона для таблиц (по умолчанию #73aaaaaa).
  • CL_CONTRAST_MAIN - цвет для отображения информации на элементах главного цвета, обычно текст или картинки, должен быть хорошо различим на CL_MAIN (по умолчанию #ff282832).
  • CL_CONTRAST_BACKGROUND - цвет для отображения информации на элементах по центру экрана, обычно всплывающие меню или прозрачные окна, должен быть хорошо различим на CL_BACKGROUND (по умолчанию #ffffffff).
  • CL_SECOND - вторичный цвет темы, предназначен для активных элементов управления типа селекторов и кнопок (по умолчанию #ffffffff).

Расширенные цвета схемы:

Цвета из этого списка вычисляются из базовых, при необходимости могут быть переопределены.

Параметр Зависимость Прозрачность Назначение
CL_on_main_casualCL_CONTRAST_MAIN1,00общий цвет для элементов на главном цвете.
CL_text_on_main_casualCL_on_main_casual 1,00цвет для обычного текста на главном цвете.
CL_text_on_main_activeCL_on_main_casual 1,00цвет для активного или выделенного текста на главном цвете.
CL_text_on_main_dimmedCL_on_main_casual 0,55цвет для вспомогательного текста на главном цвете.
CL_on_background_casualCL_CONTRAST_BACKGROUND1,00общий цвет для элементов в таблицах и на фоне по центру экрана.
CL_text_on_background_casualCL_on_background_casual1,00цвет для обычного текста в таблицах
CL_text_on_background_activeCL_on_background_casual1,00цвет текущего (активного или выделенного) текста таблицах
CL_text_on_background_dimmedCL_on_background_casual0,55приглушенный цвет для отображения неактивных строк в таблицах или дополнительного текста
CL_wallpaperCL_BACKGROUND0,90цвет фона для для большинства виджетов
CL_fadeCL_BACKGROUND0,90цвет дополнительного затенения видео для полноэкранных элементов интерфейса
CL_additionalCL_BACKGROUND0,40дополнительный цвет для выделения активных виджетов или выделение колонок внутри таблиц
CL_bgr_colorCL_MAIN1,00цвет фонового изображения в главном меню при отсутствии видео и некоторых других элементах
CL_bumperCL_MAIN0,94общий цвет элементов главного цвета (панелей снизу и сверху)
CL_headerCL_bumperцвет фона для элементов, находящийся вверху экрана (шапки и заголовки)
CL_footerCL_bumperцвет для фона элементов, находящихся внизу экрана (выезжающие меню, панели управления)
CL_popupCL_MAIN1,00цвет фона для диалоговых окон, расширенных настроек и сообщений системы
CL_popup_contrastCL_CONTRAST_MAIN1,00цвет контента в диалоговых окнах
CL_plateCL_MAIN1,00цвет фона для плиток в главном меню и в таблицах VOD, а также в других похожих по оформлению элементах
CL_plate_contrastCL_CONTRAST_MAIN1,00цвет для контента (текста и иконок) внутри плиток главного меню и VOD
CL_selectorCL_SECONDцвет селектора, выделенных элементов управления, подсветки курсора, активных кнопок и прочих подсвеченных элементов
CL_emptyCL_SECOND1,00цвет пустоты в прогресс барах
CL_inactiveCL_SECOND0,35цвет заблокированных элементов интерфейса (каменные кнопки)
CL_fullCL_CONTRAST_MAIN1,00цвет заполнения прогрессбаров
CL_button_selectedCL_selector1,00цвет выделенной экранной кнопки
CL_button_casualCL_selector0,35цвет неактивной экранной кнопки
CL_on_buttonCL_on_background_casualцвет надписи и иконки на кнопке

Стандартные схемы, входящие в прошивку, имеют следующие названия:

  • Default
  • Deep Purple
  • Indigo
  • Teal
  • Blue
  • Light Green
  • Berries
  • Chocolate
  • Medusa
  • TVIP classic

Настройка воспроизведения медиа

:!: Модуль доступен, начиная с версии 4.0.19

Позволяет настраивать некоторые параметры воспроизведения.

  <media>
    <default_audio_language force="true" value="bul bg eng en" />
    <default_subtitle_language force="true" value="ru rus" />
  </media>
  • default_audio_language - язык аудио по-умолчанию.
  • default_subtitle_language - язык субтитров по-умолчанию.

Значение параметра value задается в виде кодов языков в форматах ISO 639-1 и ISO 639-2, через пробел. Для каждого языка рекомендуется задать код в обоих форматах (например, «ru rus»). Если указано более одного языка, приоритет при запуске медиа отдается указанному левее в списке.
Если значение для аудио пустое, используется первая аудио дорожка в потоке. Если значение для субтитров пустое, субтитры выключены.
Данная настройка provisioning несовместима с соответствующей настройкой в интерфейсе пользователя. Рекомендуется скрывать настройку от пользователя, если используется настройка provisioning.

Принудительное подключение SMB и NFS ресурсов

Позволяет принудительно примонтировать определенные SMB и NFS ресурсы при старте приставки.

<mountpoints>
  <mountpoint  type="smb" mountname="SMB Share">
    <address value="192.168.1.1" />
    <folder value="Movies" />
    <password value="pass" />
    <username value="login" />
  </mountpoint>
  <mountpoint type="nfs" mountname="NFS Share">
    <address value="nfs.operator.com" />
    <folder value="/home/sharing/Movies" />
  </mountpoint>
</mountpoints>

Тип сервера задается атрибутом type, название ресурса для отображения в интерфейсе атрибутом mountname.

В данном примере принудительно подключаются два ресурса:
- общая папка с именем Movies на SMB-сервере по адресу 192.168.1.1 с именем пользователя login и паролем pass .
- каталог /home/sharing/Movies на NFS-сервере по адресу nfs.operator.com .

Принудительное подключение источников видеонаблюдения

Позволяет принудительно добавить источники видеонаблюдения оператора при старте приставки. Поддерживаются прямые URL видеопотоков в форматах UDP, HTTP, RTSP, а также HTTP URL M3U-плейлистов.

<cctv_sources>
  <source name="Cameras" url="http://cam.operator.com/cameras.m3u" />
  <source name="Our Office" url="rtsp://cam.operator.com/office" />
</cctv_sources>

Атрибут name задает название источника в списке приложения Видеонаблюдение. Атрибут url задает URL плейлиста или видеопотока.

В данном примере подключаются два источника видеонаблюдения:
- список камер в формате M3U по адресу http://cam.operator.com/cameras.m3u
- прямая ссылка на видеопоток по адресу rtsp://cam.operator.com/office

Режим "Кабельное ТВ"

Поддерживается начиная с прошивки 4.2.33

Позволяет запускать один поток при этом интерфейс устройства будет недоступен.

<system_locks>
        <ctv enabled="true" url="http://your_stream.com" volume="30" />
</system_locks>

Ограничение доступа к окну отладочной информации (s.info->DEL)

Поддерживается начиная с прошивки 3.3.10

<system_locks>
        <sysinfo_del locked="true" />
</system_locks>

Ограничение сброса на заводские настройки

Поддерживается начиная с прошивки 3.4.4.
Данная опция отключает сброс приставки через комбинацию кнопок.

<system_locks>
        <reset locked="true" />
</system_locks>

Запрет использования протокола IGMPv1

Поддерживается начиная с прошивки 4.0.13 ОС Linux-Qt. Поддерживается не всеми моделями медиацентров.
Запрещает ядру ОС использовать протоколы IGMP версии ниже 2. Требуется перезагрузка после изменения значения опции.

<system_locks>
        <igmpv1_block enabled="true" />
</system_locks>

Ограничение доступа к настройкам медиацентра

Можно запретить отображение или изменение практически любой настройки в приложении Настройки. Доступ к ограничениям осуществляется по id элементов (список ниже). Настройки делятся на два уровня *Основные разделы* и *Настройки*. Возможные параметры:

visible="false/true"
disabled="false/true"

Список основных разделов:

pref_system - Система
pref_appearance - Оформление
pref_network - Сеть
pref_display - Дисплей
pref_tv - ТВ
pref_security - Безопасность

<preferences>
  <pref_network visible="false" />
</preferences>

В данном примере из настроек полностью скрывается раздел Сеть.

Конкретные настройки должны находится внутри соответствующих тегов Основных настроек.

Список настроек раздела Система

pref_system_language - Язык интерфейса
pref_system_updatetype - Тип обновления
pref_system_updateperiod - Период проверки обновлений
pref_system_updatebackground - Установка обновлений в фоне
pref_system_timezone - Часовой пояс
pref_system_timeserver - Адрес NTP
pref_system_timeformat - Формат времени
pref_system_auto_standby - Авто выключение
pref_system_audiolanguage - Язык аудио по-умолчанию
pref_system_subtitlelanguage - Язык субтитров по-умолчанию
pref_system_digitalsoundmode - Формат цифрового звука
pref_system_dial - Мультискрин
pref_system_button_bluetooth_remote - Настройка Bluetooth
pref_system_button_checkupdates - Кнопка проверки обновлений
pref_system_button_info - Кнопка Инфо

Список настроек раздела Оформление

pref_appearance_alpha - Прозрачность интерфейса
pref_appearance_anim - Анимированный интерфейс
pref_appearance_channel_numbers - Показывать номера каналов
pref_appearance_channel_icons - Показывать лого каналов
pref_appearance_listlooped - Круговая прокрутка списков
pref_appearance_padding - Оверскан ТВ
pref_appearance_tv_preview_mode - Режим предпросмотра
pref_appearance_tv_cursor_mode - Режим курсора ТВ
pref_appearance_color_preset - Цветовая схема
pref_appearance_background - Фоновое изображение

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

pref_network_iface - Тип подключения (Eth/WiFi)
pref_network_iface_enabled - Включение/выключение сетевого интерфейса
pref_network_wlan_ssid - Точка доступа WiFi
pref_network_config - Кофигурация (DHCP/Manual)
pref_network_ip - IP-адрес
pref_network_mask - Маска
pref_network_gateway - Шлюз
pref_network_dns1 - DNS1
pref_network_dns2 - DNS2
pref_network_router_mode - Общий доступ к сети

Список настроек раздела Дисплей

pref_display_hdformat - Формат HD-вывода
pref_display_hdhdmienable - HDMI вкл/выкл
pref_display_hdcomponentenable - Компонентный вкл/выкл
pref_display_sdformat - Формат SD-вывода
pref_display_sdrcaenable - RCA вкл/выкл
pref_display_sdsvideoenable - S-Video вкл/выкл
pref_display_aspect - Соотношение сторон
pref_display_cec - HDMI-CEC

Список настроек раздела ТВ

pref_tv_streamtype - Тип потока (мультикаст/прокси)
pref_tv_udpxyaddress - Адрес UDPXY
pref_tv_mpegts_buffer - Буфер MPEG-TS
pref_tv_dvr_deviceid - Выбор устройства для DVR
pref_tv_timeshift_deviceid - Выбор устройства для Timeshift
pref_tv_autotimeshift - Авто Timeshift вкл/выкл
pref_tv_middleware - Источник контента
pref_tv_button_midd_setup - Настройка источника контента
pref_tv_inter_apps - Интерактивные приложения

Список настроек раздела Безопасность

pref_security_enable - Безопасный режим
pref_security_timeout - Автоблокировка
pref_security_tvfiltertype - Тип блокировки
pref_security_operatorlock - Блокировка каналов для взрослых
pref_security_allowtv - Блокировать ТВ
pref_security_allowmediaplayer - Блокировать Медиаплеер
pref_security_allowdvr - Блокировать Видеомагнитофон
pref_security_allowcctv - Блокировать Видеонаблюдение
pref_security_allowwebapps - Включение/выключение веб-приложений
pref_security_allowapps - Включение/выключение Android-приложений

<preferences>
  <pref_network visible="false" />
 
  <pref_tv>
    <pref_tv_streamtype visible="false" />
    <pref_tv_udpxyaddress visible="false" />
    <pref_tv_middleware disabled="true" />
  </pref_tv>
 
</preferences>

В данном примере полностью скрывается раздел Сеть; скрываются настройки типа потока и адреса UPXY в разделе ТВ, а также запрещается изменение типа Middleware.

Настройка URL сервера TVIP App Store

:!: Поддерживается только в OS Android, начиная с прошивки 4.4.1

Позволяет указать адрес сервера TVIP App Store.

Например:

<appstore_server url="https://operator.com/appstore/appstore.json" />

Описание конфигурирования сервера TVIP App Store доступно по ссылке

Полный пример конфигурации tvip_provision.xml

<?xml version="1.0"?>
<provision reload="3600"><!--Обновление каждый час -->
 
 <!-- Использовать центральный сервер обновлений tvip -->
 <update_server name="tvipupdate.net" />
 
 <!-- Установка логотипа -->
 <logo url="http://operator.com/prov/logo.png" />
 
 <!-- Скрытие приложения Видеомагнитофон -->
 <features>
   <dvr enabled="false" />
 </features>
 
 <!-- Загрузка M3U-плейлиста и телепрограммы -->
 <tv_protocols default="m3u">
   <protocol type="m3u" m3u="http://operator.com/channels.m3u" epg="http://operator.com/epg.zip" />
 </tv_protocols>
 
 <!-- Подключение видео-ресурса -->
 <mountpoints>
  <mountpoint  type="smb" mountname="SMB Share">
    <address value="192.168.1.1" />
    <folder value="Movies" />
    <password value="pass" />
    <username value="login" />
  </mountpoint>
 </mountpoints>
 
 <!-- Подключение списка видеонаблюдения -->
 <cctv_sources>
  <source name="Cameras" url="http://cam.operator.com/cameras.m3u" />
 </cctv_sources>
 
 <!-- Отключение ручной настройки Сети, настроек мультикаста. -->
 <preferences>
   <pref_network visible="false" />
   <pref_tv>
     <pref_tv_streamtype visible="false" />
   </pref_tv>
 </preferences>
 
</provision>
provisioning.txt · Последние изменения: 2023/12/20 16:29 — Vladimir Manov