Android

Минимальные требования

• Операционная система: Android 5.0 и выше (уровень API: 21 и выше);
• Наличие сетевого интерфейса (WiFi или Ethernet);
• Оперативная память: 1 гб и выше;
• Flash память (жесткий диск): от 8 гб.

Рекомендуемые требования

• Операционная система: Android 7.0 и выше (уровень API: 24 и выше);
• Наличие сетевого интерфейса (WiFi или Ethernet);
• Оперативная память: 2 гб и выше;
• Flash память (жесткий диск): от 16 гб.

Приставки на Android OS (Android Smart TV)

Наименование приставки	Перезагрузка	Обновление приложения	Скриншот с видеоролика	Установка времени (тайм-зоны)	Работа 24/7	Наличие root доступа	WiFi 2,4 / 5 ГГц	Отключение автоматического обновления прошивки	Удаление лишниx приложений	Рекомендовано SmartPlayer	Дополнительно
Ugoos X3 Box Family Series (Cube, Pro, Plus)	Да	Да	Да	Да	Да	Да	Да/Да	В разработке	В разработке	Да	Яндекс.Маркет, Amazon
Tanix TX9S	Да	Да	Да	Да	Да	Да	Да/Да	В разработке	В разработке	Да	Яндекс.Маркет, Amazon
Perfeo Matrix	Да	Да	Да	Да	Да	Да	Да/Да	В разработке	В разработке	Да (в качестве бюджетного решения)	Яндекс.Маркет
X2 CUBE Инструкция по настройке	Да	Да	Да	Да	Да	Да	Да/Да	В разработке	В разработке	Да (в качестве бюджетного решения)	Яндекс.Маркет Оф. сайт
Ugoose AM3 2Gb/16Gb Инструкция по настройке	Да	Да	Да	Да	Да	Да	Да/Да	В разработке	В разработке	Да (в качестве профессионального решения)	Яндекс.Маркет Оф. сайт Обзор
INVIN IPC002 1Gb/8Gb	Да	Да	Да	Да	Да	Да	Да/Нет	В разработке	В разработке	Да (в качестве бюджетного решения)	Яндекс.Маркет
W95 1Gb/8Gb	Да	Да	В разработке	Да	Да	Да	Да/Нет	В разработке	В разработке	Да (в качестве бюджетного решения)	Яндекс Маркет
Xiaomi Mi Box International Version Требуется обновить до Android 8.0 через настройки в системе.	Нет	Нет	Да	Нет	Да	Нет	Да/Да	Нет	Нет	Нет	Яндекс Маркет
Invin W5 2Gb/16Gb	Да	Да	Нет	Да	Нет	Да	Да/Нет	В разработке	В разработке	Нет	Яндекс Маркет

Подробное описание возможностей:

• "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
• "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
• "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
• "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
• "Работа 24/7" - приставка работае 24 часа 7 дней в неделю.
• "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек.Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
• "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапозонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
• "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
• "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
• "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов
• "Где купить" - магазины, где можно купить приставку.

P.s. Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии.

P.s. По-умолчанию поддерживаются все устройства начиная с версии Android 5.0.

Последние прошивки для TV BOX: https://chinagadgetsreviews.com/firmwares

Привилегии приложения

Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством

• Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше
• Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
• Privileged - привилигированное приложение, когда производитель прошивки добавляет приложение в системный раздел /system/priv-app. Это более безопасно, чем давать root на устройство.
• Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается разработчиком прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
• Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.

Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).

Команда	Обычный	Device Owner	Privileged	Signature	Root
Перезагрузка устройства	Нет	Да (c Android 7.0 и выше)	Да	Нет	Да
Скрыть(показать) все системные launchers	Нет	Нет	Нет	Нет	Да
Выключить устройство	Нет	Нет	Нет	Нет	Да
Изменить ориентацию устройства	Да (на уровне приложения)	Да (на уровне приложения)	Да (на уровне системных настроек)	Нет	Да (на уровне системных настроек)
Установить время и дату	Нет	Да (c Android 9.0 и выше)	Да	Нет	Да
Установка тайм-зоны	Нет	Да (c Android 9.0 и выше)	Да	Нет	Да
Установка сторонних приложения	Нет	Нет	Нет	Нет	Да
Установка звука	Да	Да	Да	Да	Да
Обновление приложения SmartPlayer с сервера	Нет	Да	Нет	Да	Да

Кто и какой режим может выдать приложению.

Кто может дать доступ	Обычный	Device Owner	Privileged	Root
Интегратор	Да	Да	Нет	Нет
Разработчик прошивки	Да	Да	Да	Да

Установка клиентского приложения на телефон (планшет)

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



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



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



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



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



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

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

Решения и настройка в нестандартных ситуациях

Установка приложения из 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). Потребуется выдача разрешений вручном режиме на устройство, для этого:

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

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

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

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

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

Запуск в вертикальной ориентации

SmartPlayer поддерживает вертикальную ориентации на части устройств.

1. Зайти в настройки приставки
2. Настройки изображения
3. Выбрать пункт rotating screen
4. Установить приложение SmartPlayer

Режим киоска

SmartPlayer под Android поддерживает режим киоска.

При включенном режиме киоска, пользователь не может покинуть приложение и отключены следующие возможности:

• не работаю нажатия с пульта (для приставок с Android).
• не работает кнопка home приложение автоматически перезапускается через 100 ms
• приложение скрывает все диалоги которые появляются, поверх приложения

Отключение режима киоска

• Переместить мышку в правый верхний угол
• Зажать левую кнопку мышки на 5 секунд
• Ввести код 95224
• После этого приложение отключит режим киоска

Администрирование режима киоска

Выключение(Включение) режима киоска если устройство онлайн.
В личном кабинете можно отключить через настройки “Режим киоска”. Настройка будет сохранена на сервере и следующий старт приложения уже будет без режима киоска. Выбрать устройство (группу устройств) -> платформу Android -> Режим киоска -> выбрать “Отключить“ -> Нажать на кнопку: “Сохранить изменения“
Аналогичный образом происходит включение режима киоска через личный кабинет. Выбрать устройство (группу устройств) -> платформу Android -> Режим киоска -> выбрать “Включить“ -> Нажать на кнопку: “Сохранить изменения“
Выключение режима киоска если устройства оффлайн.
С пульта
На пульте нужно выполнить следующую комбинацию клавиш в течение 7 секунд с пульта: ENTER -> BACK ->BACK->LEFT
С подключенной мышкой к устройству
Долгое нажатие курсором мышки в верхнем правом углу (200x200 пискелей область), после чего покажется диалоговое окно, где нужно ввести пароль в течении 15 секунд, пароль: 95224
С отключением режима киоска по тач событию
Долгое нажатие пальцем в верхнем правом углу (200x200 пискелей область), после чего покажется диалоговое окно, где нужно ввести пароль в течении 15 секунд, пароль: 95224

После отключения режима киоска, приложение покажет список доступных Launcher приложений, которые можно использовать для выхода с приложения. Диалог с выбором автоматически уберется через пять секунд. При выключенном режиме киоска кнопка BACK/HOME работает в обычном режиме делая выход из приложения.

Включение режим киоска оффлайн.
Включение режима киоска в режиме оффлайн происходит аналогично отключению, при долгом нажатии (мышкой или пальцем) в правом верхнем углу (200x200 пискелей область). При включении будет показано сообщение, что режим киоска включен.

Настройка телефона в режиме открытой выкладки

1. Настроить сеть интернет на телефоне.
2. Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
3. Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
4. После установки приложения SmartPlayer проверить Настройки - Домашнее приложение - там должен стоять стандартный launcher, а не SmartPlayer

Производители Android TV

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

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

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