Android/en

Minimum requirements

• Operating system: Android 5.0 and above (API level: 21 and above);
• Availability of a network interface (WiFi or Ethernet);
• RAM: 1 GB and above;
• Flash memory (hard disk): from 8 GB.

Recommended Requirements

• Operating system: Android 7.0 and above (API level: 24 and above);
• Availability of a network interface (WiFi or Ethernet);
• RAM: 2 GB and above;
• Flash memory (hard disk): from 16 GB.

Set-top boxes on Android OS (Android Smart TV)

STB name	Reboot	App update	Screenshot from video	Setting the time (time zone)	Work 24/7	Root access	WiFi 2.4 / 5 GHz	Disable automatic firmware update	Remove unnecessary applications	Recommended by SmartPlayer	Optional
X2 CUBE Setup Instructions	Yes	Yes	Yes	Yes	Yes	Yes	Yes / Yes	In development	In development	Yes (as a professional solution)	Yandex.Market Of. website
Ugoose AM3 2Gb / 16Gb Setup Instructions	Yes	Yes	Yes	Yes	Yes	Yes	Yes / Yes	In development	In development	Yes (as a professional solution)	Yandex.Market Of. website Review
INVIN IPC002 1Gb / 8Gb	Yes	Yes	Yes	Yes	Yes	Yes	Yes / No	In development	In development	Yes (as a budget solution)	Yandex.Market
W95 1Gb / 8Gb	Yes	Yes	In development	Yes	Yes	Yes	Yes / No	In development	In development	Yes (as a budget solution)	Yandex Market
Xiaomi Mi Box International Version Requires upgrade to Android 8.0 through system settings.	No	No	Yes	No	Yes	No	Yes / Yes	No	No	No	Yandex Market
Invin W5 2Gb / 16Gb	Yes	Yes	No	Yes	No	Yes	Yes / No	In development	In development	No	Yandex Market

|- |Ugoos X4 Box Family Series (Cube, Pro, Plus) |Да |Да |Да |Да |Да |Да |Да/Да |В разработке |В разработке

|

Да

|Яндекс.Маркет, Amazon

|- |Ugoos X3 Box Family Series (Cube, Pro, Plus) |Да |Да |Да |Да |Да |Да |Да/Да |В разработке |В разработке

|

Да

|Яндекс.Маркет, Amazon

Detailed description of features:

• "Reboot" - physically reboot the device. SmartPlayer will start automatically after the operating system starts.
• "Application update" - with the development of the client application, SmartPlayer releases updates for its application, in which bugs can be fixed, new functionality added. This function will allow you to update the client application remotely, without the physical involvement of the administrator at the device installation point.
• "Screenshot from video" - allows you to take a screenshot of the device's screen while it is playing a video. This function applies only to videos, if you plan to show only pictures, the screenshot will be taken from any device.
• "Setting the time (time zone)" - in consoles, there is no battery that is responsible for the internal clock of the device, and therefore the application maintains the current time on the consoles. If the set-top box has access to the Internet, then this function is irrelevant, it is important only in closed networks (without Internet access)
• "Work 24/7" - prefix work 24 hours 7 days a week.
• "Root access" is a superuser on set-top boxes who has the right to change system settings. Root access allows the SmartPlayer application to administer the device without restrictions. Root access is provided by console manufacturers.
• "WiFi 2.4 / 5 GHz" - WiFi can work in two ranges, usually 5 GHz networks are less loaded, which allows you to achieve a more stable network state
• "Disable automatic firmware update" - manufacturers release firmware (operating system) updates for their devices, this function allows the system administrator to control when the update is performed.
• "Remove unnecessary applications" - by default, console manufacturers install many applications. Some applications can make notifications and interfere with the playback of content, with this function SmartPlayer will hide unnecessary applications from the console.
• "Recommended by SmartPlayer" - this means that the set-top box has been tested by SmartPlayer and is recommended for organizing Digital Signage projects
• "Where to buy" - shops where you can buy a set-top box.

P.s. All of the above information is the result of testing by SmartPlayer. Even one model may differ from batch to batch.

P.s. By default, all devices starting from Android 5.0 are supported.

Latest firmware for TV BOX: https://chinagadgetsreviews.com/firmwares

Application Privileges

The application on the device can have different privileges, depending on which the device can be controlled

• Normal - by default when installing SmartPlayer app on any device with Android 5.0 or higher
• Device Owner - issued using the developer settings by the application installer. If the device has root access, SmartPlayer will automatically elevate itself to Device Owner.
• Privileged - a privileged application when the firmware manufacturer adds an application to the system partition / system / priv-app. It is more secure than rooting the device.
• Root - the superuser available for the application, the highest level of access for the application. Root is provided by the firmware manufacturer, usually devices without Google certification.

Производитель устройства	Наличие интеграции	Режим работы
Phillips (проф. серия)	Да	Информация по интеграции
Phillips (коммерческие)	Да	Информация по интеграции
Samsung (KNOX)	Да	Интеграция с SDK производителя устройства
TCL	Нет	Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. Настройка
BenQ (проф. серия)	Да	Signature
Xiaomi	Нет	Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
HIKVISION	Да	DeviceOwner. Интеграция с SDK в процессе выполнения.

You can do all the settings manually, but usually this does not satisfy the needs of the b2b sector. The table below shows the capabilities of the application without user participation at the point (administration through the SmartPlayer personal account).

Command	Usual	Device Owner	Privileged	Root
Reboot the device	No	Yes (with Android 7.0 and higher)	Yes	Yes
Hide (show) all system launchers	No	No	No	Yes
Turn off device	No	No	No	Yes
Change device orientation	Yes (application level)	Yes (application level)	Yes (at the system settings level)	Yes (at the system settings level)
Set time and date	No	Yes (with Android 9.0 and higher)	Yes	Yes
Setting the time zone	No	Yes (with Android 9.0 and higher)	Yes	Yes
Installing third-party applications	No	No	No	Yes
Sound setting	Yes	Yes	Yes	Yes
Updating SmartPlayer application from server	No	Yes	No	Yes

Who and what mode can issue to the application.

Who can give access	Usual	Device Owner	Privileged	Root
Integrator	Yes	Yes	No	No
Firmware developer	Yes	Yes	Yes	Yes

Плюсы и минусы работы приложения в разных режимах.

Режим работы приложения	Минусы (-)	Плюсы (+)
Обычный	Нет управления устройством, что часто нужно в рамках b2b сектора Приложение не имеет прав для работы на низком уровне с устройством	Проигрывать контент будет на любом устройстве AndroidOS 5.0 и выше Штатная установка которая не зависит от третьих лиц
Device Owner	Обычному пользователю незнакомому с консолью сложно получить. Google пользовательский способ установки дает (через QR код), только если использовать аккаунт google на устройстве. Многие устройства на Android OS от сторонних производителей его не поддерживают. При настройке больше 10 устройств становится проблематична установка, много ручных действий в системе. Необходимо ставить инструменты разработки на компьютер настройщика приложения. Большенство возможностей, зависит от версии Android OS, т.е. API системы добавляется по мере развития операционной системы.	Официальный путь, в операционной системе Android по управлению устройством для сторонних приложений.
Signature	Каждую версию приложения от SmartPlayer необходимо подписывать у производителя прошивки	Рекомендуемый способ от компании SmartPlayer Большие возможности по управлению устройством (см. табличку выше) Выполнения межпроцессорных взаимодействий из приложения, что дает большое кол-во возможностей по управлению устройством Обеспечивается безопасность устройства (по отношению к root)
Root	Безопасность. Google не сертифицирует устройства с root, в релизной версии прошивки они должны быть отключены.	Безграничные возможности по управлению устройством. SmartPlayer ПО в сборке релизной отключит возможность управления устройством удаленно, что позволит улучшить безопасность. Потребуется физический доступ к устройству, чтобы изменить его настройки. Нет зависимости от третьих лиц, все доработки делаются силами SmartPlayer.

Installing the client application on a phone (tablet)

Download the application to the device using the link received. Run apk file. When the notification appears, click "Settings"



Enable "Unknown sources"



For security reasons, select "Allow this installation only". Click OK.



Select "Install"



Wait for the installation to complete



Click "Open"

Wait for the PIN-code to appear. Enter the PIN-code in your personal account.

Для включения режима “владелец устройства” потребуется подключение к устройству через ADB (Android Device Bridge). После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из Google Play.

После подключения, проверяем девайс, командой:
$ adb devices
Должен быть вывод, аналогичный следующему:

Включаем “Владельца девайса”.
Для production сборки:
$ adb shell dpm set-device-owner org.smartplayer.android.client/co.displaysolutions.digitalsignage.SPAdminReceiver
Для development сборки:
$ adb shell dpm set-device-owner org.smartplayer.client.develop/co.displaysolutions.digitalsignage.SPAdminReceiver

Если все пройдет успешно, adb напишет, что теперь владелец девайса - приложение SmartPlayer. После этого нужно перезапустить приложение (один раз) для активации приложение режима киоска.

На устройстве может быть только одно приложение в режиме “владелец устройства”. Сбросить “владельца устройства” можно только скинув устройство к заводским настройкам (Settings > Backup & Reset > Factory data reset)

== Установка клиентского приложения на телефон (планшет) Скачать приложение на устройство, использую полученную ссылку. Запустить apk файл. При появлению уведомления нажать "Настройки"



Включить "Неизвестные источники"



В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК.



Выбрать "Установить"



Дождаться завершения установки



Нажать "Открыть"

Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

Troubleshooting

Installing the application. If an error appears during installation (there may be different text) and a window does not appear to allow installation from unknown sources. Do the following:

• Android 5.0+ and up to 8.0 (Android Oreo). Settings -> Lock screen and protection -> Unknown sources -> (see further instructions above)
• Android 8.0+ Settings -> Applications -> Additional settings (... in the upper right corner) -> Special access rights -> Install unknown applications -> Allow installation for required applications
• During installation, the message 'there was a problem parsing the package' may appear. This means that the client application is not fully downloaded, or there were errors during loading on the media.

Установка приложения из apk файла

Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:

• Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
• Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
• При установке возможно появление сообщения there was a problem parsing the package (ошибка при синтаксическом анализе пакета). Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.

Регистрация устройства (первый запуск)

При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида

Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:

• Проверить настройку сетевых параметров на устройстве
• Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI

• Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
• Если решить проблему самостоятельно не получилось, нужно предоставить отладочную информацию приложения представителю SmartPlayer или на почту support@smartplayer.org.

После удачного соединения с сервером, будет показан UI для регистрации устройства

Выдача разрешений на снятие скриншота с видеоролика

Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:

• Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
• В правом меню устройства нажать подпункт меню с названием - Настройки и отключить "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.
  

• В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот)
  

• После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:"
  

• После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства

• Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
• В правом меню устройства нажать подпункт меню с названием - Настройки и включить "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.

Launch in vertical orientation

SmartPlayer supports vertical orientation on some devices (on devices that support the rotation option).

1. Go to the device settings
2. Image/Screen settings
3. Select rotating screen option
4. Install SmartPlayer app

Kiosk Mode

SmartPlayer for Android supports kiosk mode.

When the kiosk mode is enabled, the user cannot leave the application and the following features are disabled:

• pressing from the remote control does not work (for consoles with Android).
• home button does not work the app automatically restarts after 100 ms
• application hides all dialogs that appear on top of the application

Disable kiosk mode

• Move the mouse to the upper right corner
• Hold down the left mouse button for 5 seconds
• Enter code 95224
• After that, the app will disable kiosk mode

Administering kiosk mode

'Disable (Enable) kiosk mode if the device is online. '
In your personal account, you can disable it through the "Kiosk mode" settings. The setting will be saved on the server and the next start of the application will already be without kiosk mode. Select device (group of devices) -> Android platform -> Kiosk mode -> select “Disable” -> Click on the button: “Save changes”
Similarly, the kiosk mode is activated through your personal account. Select a device (group of devices) -> Android platform -> Kiosk mode -> select “Enable” -> Click on the button: “Save changes”
'Disable kiosk mode if devices are offline. '
From the remote control
On the remote, you need to execute the following key combination within 7 seconds from the remote: ENTER -> BACK -> BACK-> LEFT
`` With a connected mouse to the device
Long click with the mouse cursor in the upper right corner (200x200 pixels area), after which a dialog box will appear, where you need to enter the password within 15 seconds, password: 95224
Disable kiosk mode by touch event
Long press with your finger in the upper right corner (200x200 pixel area), after which a dialog box will appear where you need to enter the password within 15 seconds, password: 95224

After disabling kiosk mode, the application will show a list of available Launcher applications that can be used to exit the application. The selection dialog will automatically disappear after five seconds. When the kiosk mode is off, the BACK / HOME button works normally, exiting the application.

Enabling kiosk mode offline.
Turning on the kiosk mode in offline mode is similar to turning it off, by long pressing (with the mouse or finger) in the upper right corner (200x200 pixels area). When enabled, a message will be shown that kiosk mode is enabled.

Особенности контента

• Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
• У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
• Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
• Видео в трансляциях должно быть одинаковым по времени. Пример. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
• Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
• Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
• Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
• Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
• Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется

Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS.

Setting up the phone in open space mode

1. Configure the Internet on your phone.
2. Check the availability of new firmware on the phone (Settings - System - System update). If there is new firmware, update it.
3. Disable lock mode on the phone. (Settings - Security - Lock screen - No)
4. After installing the SmartPlayer application, check Settings - Home application - there should be a standard launcher, not SmartPlayer

Android TV makers

• Ugoos https://www.ugoos.ru/
• ShiningWorth http://www.shiningworth.com/
• Zidoo https://www.zidoo.tv/

Обновление клиентского приложения в ручном режиме

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя.
1. Выкладываем на сервер новую версию приложения (обычно делает администратор)
2. Далее по документу Ручное обновление SmartPlayer

Аппаратные ограничения платформы

На устройствах Android существуют следующие аппаратные ограничения:

1. Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством.
2. В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах.

Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.

Воспроизведение контента с нестандартным разрешением на Android OS Приставок

Для приставок под управлением Android OS

Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете.
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".

Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя

Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".

Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080

После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.

Пример отображения иконки создания зоны в трансляции

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

Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции

Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.

Пример отображения выбора контента для трансляции в зоне

Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.

Пример настроенного и работающего устройства

Предустановленные настройки для медиа-потоков

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

Алгоритм действий

Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".

Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете

Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.

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

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

Пример отображения добавления нужного медиа-потока в зону трансляции

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

Пример отображения тулбара с настройками для трансляции

В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".

Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре

Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.

Список настроек

Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".

Пример отображения настроек в блоке "Пресеты для стрима"

В этом блоке доступна для изменения только одна настройка - "Тип пресета". Данная настройка позволяет выбрать из четырех видов пресетов:

• NetUP
• Ugoos 1
• Ugoos 2
• Ручные настройки

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

Подробнее о ручных настройках

В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:

1. Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
2. Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: ссылка 1, ссылка 2, ссылка 3 .
3. Чекбокс/галочка по возможности использовать ExopPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.

После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.