SmartPlayer - Вклад [ru]

Раздел "Трансляции"

2026-08-11T10:56:03Z

N.Bloshkin: /* Дополнительная информация */

<languages/>
<translate>

== '''Раздел "Трансляции"''' ==
В личном кабинете SmartPlayer одним из ключевых разделов, с которым наиболее часто будет взаимодействовать пользователь, является раздел "Трансляции".
[[File:Раздел_трансляции_в_лк.png|thumb|center| Пример отображения в личном кабинете раздела "Трансляции"|800px]]
В этом разделе пользователь сможет создавать различные виды трансляций, настраивать параметры трансляции и применять готовые трансляции к устройствам.
== '''Главная страница''' ==
После перехода в личном кабинете на страницу создания трансляции пользователю откроется главная страница раздела. Данный раздел можно разбить на две зоны:
* Зона поиска трансляции
* Зона со списком трансляций
[[File:Две_зоны_раздела_трансляции.png|thumb|center| Пример отображения зон в разделе "Трансляция"|800px]]
=== '''Зона поиска в разделе трансляции''' ===
В данной зоне пользователь может изменить отображение готовых трансляций на странице.
[[File:Зона_поиска в разделе трансляции.png|thumb|center| Пример отображения зоны поиска|800px]]
Из возможностей пользователю доступно:
* Найти трансляцию в строке поиска
* Настроить сортировку: по дате созданий или в алфавитном порядке
* Возможность выделить/снять выделение со всех трансляций
* Изменить отображение трансляций: плиткой или списком
</translate>
<translate>

=== '''Зона со списком трансляций''' ===
В зоне со списком трансляций пользователь сможет просмотреть все доступные на данный момент трансляции.
[[File:Зона_со_списком_трансляций.png|thumb|center| Пример отображения зоны со списком трансляций|800px]]
К списку этих возможностей относится:
* Скачать трансляцию
* Клонировать трансляцию (создать дубликат текущей трансляции)
* Возможность выставить расписание
* Редактировать расписание (откроется список настроек полностью идентичный настройкам при создании трансляции)
* Удалить расписание
[[File:возможности для работы с трансляцией.png|thumb|center| Пример отображения настроек связанных с тарнсляцией|800px]]
{{Note|Пользователь может выделить одну или несколько трансляции, поставив чекбокс/галочку в правом верхнем углу выбранной трансляции. После выделения справа на экране появится сайдбар с настройками.
[[File:Выделенный_трансляции.png|thumb|center| Сайдбар со списком настроек транлсляции|800px]]
В этом сайдбаре пользователь может взаимодействовать со следующими настройками:
* С помощью иконки "-" снять выделение с трансляции
* Переместить выделенные трансляции в другую папку по иконке папки со стрелкой
* Удалить выделенные трансляции из списка трансляций |warn}}

== '''Категории раздела "Трансляции"''' ==
Раздел "Трансляция" в личном кабинете разбивается на четыре категории.
В эти категории входит:
* Возможность создать трансляцию
* Возможность загрузить трансляцию
* Возможность использовать режим видеостены
* Возможность добавить папку
[[File:Категории_раздела_трансляции.png|thumb|center| Пример списка категорий раздела "Трансляции"|800px]]
=== '''Категория "Создать трансляцию"''' ===
При переходе в категорию "Создать трансляцию", первым что увидит пользователь будет новое окно с зоной контента и сам контент.
[[File:Стартовая страница раздела создать трансляцию.png|thumb|center| Разделение блока "Создание трансляции" на зоны|800px]]
Данный блок также можно разделить на несколько зон:
# Зона работы с контентом
# Зона поиска контента
# Зона контента
</translate>
<translate>

==== '''Зона работы с контентом''' ====
Зона работы с контентом является достаточно обширной и рассмотреть её просто в качестве единой системы достаточно сложно. Поэтому ее лучше разделить на категории.
[[File:Стартовая страница раздела создать трансляцию.png|thumb|center| Разделение блока "Создание трансляции" на зоны|800px]]
Зона работы с контентом из трёх категорий:
* Общие настройки трансляции
* Работа с зоной контента
* Работа с аудиодорожкой
===== '''Категория "Общие настройки трансляции''' =====
В общих настройках трансляции есть информации о трансляции и несколько вкладок. Их можно открыть, кликнув на контент расположенный в зоне трансляции.
В эти данные входит:
* Название трансляции - указано название текущей трансляции
* Настройки трансляции - позволяет выставить такие параметры как: название, родительская папка, прописать ширину и высоту экрана. Для применения всех настроек необходимо нажать клавишу "Сохранить".
[[File: Дополнительые_настройки.png|thumb|center| Список настроек|800px]]
* Сохранить настройки - позволяет сохранить текущие настройки трансляции.
* Не сохранять и закрыть редактор - позволяет закрыть редактор без внесения изменения в трансляцию.
[[File:Настройки_редактора.png|thumb|center| Пример категории "Общие настройки трансляции"|800px]]
</translate>
<translate>

===== '''Категория "Работа с зоной контента''' =====
В категории "Работа с зоной контента" производится добавление и настройка контента
[[File:Зоны настроек при работе с контентом.png|thumb|center| Общий вид категории "Работа с зоной контента"|800px]]
Всю категорию можно разделить на три области:
* Добавление и настройки контента - позволяет произвести следующие действия: переместиться на следующий/предыдущий шаг, увеличить/уменьшить масштаб, растянуть контент на всю зону сохранив пропорции/не сохранив пропорции, растянуть контент до любого размера с сохранением пропорций, просмотреть настройки анимации контента, добавить таблицу, выбрать зону для клонирования, выбрать новую зону для вставки.
* Область работы с контентом - внутрь данной области добавляется контент необходимый пользователю. После добавления контента двойным кликом мыши можно открыть дополнительные настройки для зоны работы с контентом. В открывшихся настройках можно выставить следующие параметры: чекбокс "Расположить контент непрерывно по времени", чекбокс "Режим зацикливания контента в зоне", настроить порядок воспроизведения, название контента, время старта контента, продолжительность, уровень слоя, частота выхода, отступы слева и справа, ширина и высота контента, прозрачность. 
Также можно добавить новый слой с помощью иконки "+".
[[File:Допнастройки_зоны_контента.png|thumb|center| Дополнительные настройки "Зоны контента"|800px]]
* Область дополнительных настроек - в нее входят настройки связанные с режимом представления таймлинии (вертикальной, горизонтальной и списком), дополнительные настройки страницы (продолжительность контента в секундах и уровень громкости страницы) и возможность совершить предпросмотр трансляции. 
Также в данную область входит возможность просмотреть визуальное представление смены страниц с помощью отдельной иконки.
[[File:Настройки_страницы.png|thumb|center| Настройки страницы|800px]]

===== '''Категория "Работа с аудиодорожкой''' =====
В категории "Работа с аудиодорожкой" происходит взаимодействия с аудио.
[[File:Работа_с_аудиодорожкой.png|thumb|center| Пример категории "Работа с аудиодорожкой"|800px]]
При работе с аудио имеются возможности:
* Прослушать само аудио
* Открыть настройки звуковой дорожки
При нажатии на иконку откроется окно с параметрами настройками.
Внутри окна с параметрами есть:
* Базовые параметры - показывает количество аудиодорожек и техническую информацию.
[[File:Базовые_параметр.png|thumb|center| Пример базовых параметров|800px]]
* Дополнительные параметры -позволяет выставлять различные аудио параметры.
Дополнительные параметры располагаются справой стороны от базовых параметров и включает в себя три вкладки:
Во вкладке аудиодорожка - можно изменить громкость на всех контентах.
[[File:Аудиодорожки.png|thumb|center| Вкладка "Аудиодорожка"|800px]]
Во вкладке будет представлен весь выбранный контент.
Во вкладке автопозиционирование можно будет настроить следующие параметры:
* Прописать рекламные вставки
* Установить уровень громкость рекламного контента
* Прописать фоновый контент
* Установить уровень громкости для фонового контента
* Установить порядок воспроизведения
* Настроить и рассчитать с помощью чекбокса возможность чередования рекламного контента на постоянной основ или временно (в секундах).
[[File:Автопозиционирование.png|thumb|center| Параметр вкладки "Автопозиционирования"|800px]]

==== '''Зона поиска контента''' ====
В зону поиска контента входит базовый функционал по поиску, сортировке и добавления контента.
[[File:Работа_с_зоной_поиска.png|thumb|center| Составляющие блока "Зона поиска контента"|800px]]
В данную зону входят следующие настройки:
* Поиск - позволяет найти файл с нужным контентом.
* Изменение отображения контента - меняет отображение с плитки на список и обратно.
* Загрузить файл - позволяет загрузить файл с контентом.
* "Путь" расположения контента - показывает "путь", где хранится весь контент.
</translate>
<translate>

==== '''Зона контента''' ====
Зона контента включает в себя несколько составляющих.
[[File:Зона_контента.png|thumb|center| Составляющие блока "Зона контента"|800px]]
В эти составляющие входит:
* Сортировка по типу контента - позволяет выбрать конкретный вид контента из доступных. 
В качестве доступного контента может быть: весь контент, картинки, видео, музыка, документы, ссылки, текст, таблицы, виджет, контент на подключаемом устройстве.
* Возможность добавить папку - позволяет добавить папку в хранилище данных.
* Возможность добавить виджет - возможность добавить виджет, из списка виджетов доступных на учетной записи.
* Список доступного контента - представлен общий список доступного контента. Отображение контента изменяется в зависимости от описанных выше настроек сортировки.

=== '''Категория "Загрузить трансляцию"''' ===
При нажатии на категорию "Загрузить трансляцию", пользователю откроется окно загрузки. С помощью этого окна пользователь может загрузить трансляцию. 
Загружаемая трансляция должна быть в формате архива. При процессе загрузки появится новое окно с прогрессом загрузки.
После завершения загрузки трансляция появится в списке.
[[File:Пример_загруженной_трансляции.png|thumb|center| Пример загруженной в личный кабинет трансляции|800px]]
После загрузки новая трансляция появится в списке.
</translate>
<translate>

=== '''Категория "Режим видеостены"''' ===
При нажатии на категорию "Видеостена" открывается новое окно. В этом окне может настроить трансляции для работы в режиме видеостены.
[[File:Режим_видеостены.png|thumb|center| Пример отображение стартовой страницы категории "Видеостена"|800px]]
На странице можно выставить параметры необходимые для функционирования режима видеостены.
[[File:Параметры_видеостены.png|thumb|center| Параметры режима видеостены|800px]]
В список параметров, которые необходимо настроить входят:
* Возможность просмотреть расположение контента на устройствах
* Указать количество экранов по горизонтали (в штуках)
* Указать количество экранов по вертикали (в штуках)
* Выбрать режим отображения контента: один контент на все устройства или на каждое устройство уникальный контент
Далее пользователю необходимо выбрать из списка устройств внизу необходимые устройства. Для поиска конкретных устройств может помочь строка поиска, которая работает по аналогии с зоной поиска описанной вначале статьи.
После выставления всех параметров и выбора нужных устройств пользователю необходимо нажать вверху кнопку "Применить". Система покажет ему всплывающее сообщение, информирующее о том, что будет выбрано автоматически разрешение для видеостены с размером "3840"x"2160".
[[File:Оповещающее_сообщение_применить.png|thumb|center| Пример оповещающего сообщения, всплывающего при нажатии клавиши "Применить"|800px]]
Далее пользователю откроется окно с контентом, который необходимо разместить на видеостене.
Пользователь должен добавить нужный контент, и произвести настройку как страницы, так и зоны контента по аналогии с настройками, описанными в категории "Создать трансляцию".
=== '''Категория "Добавить папку"''' ===
При нажатии на категорию "Создать папку" пользователь может создать папку и присвоить ей название.
[[File:Добавить_папку.png|thumb|center| Пример отображения окна создания новой папки|800px]]
После присвоения названия пользователю необходимо нажать кнопку "Создать".
== '''Установка трансляции на устройство''' ==
Для установки расписания пользователю необходимо перейти в раздел "Устройства".
[[File:Устройства.png|thumb|center| Пример отображения раздела "Устройства"|800px]]
Следующим шагом необходимо выбрать устройство и в правом тулбаре нажать на строку "Расписание".
[[File:РАсписание.png|thumb|center| Пример отображения строки "Расписание" в тулбаре|800px]]
Откроется новая страница и на ней пользователю необходимо нажать на иконку "Добавить расписание".
[[File:Добавить_расписание.png|thumb|center| Пример отображения кнопки "Добавить расписание" и готового расписания на устройстве|800px]]
После нажатия на кнопку "Добавить расписание" откроется новая в которой необходимо заполнить параметры расписания.
== '''Дополнительная информация''' ==
{{Note|В этом разделе будут описаны дополнительные возможности функционала SmartPlayer при работе с трансляцией.|warn}}
=== '''Удаление пробелов в многозонной трансляции''' ===
{{Note|Информация описанная в текущем разделе актуальна для ситуации если у пользователя выключенном автоматическом подсчете времени и отключенном режиме зацикливания контента. Режим зацикливания контента можно активировать с помощью чекбокса (галочка) разделе настроек трансляции «Зоны». Обязательно после активации нажать на кнопку «Сохранить» в нижней левой части экрана.
[[File:Режим_зацикливания_контента.png|thumb|center| Пример отображения настройки зацикливания контента|800px]]|warn}}
Данная настройка поможет пользователям у которых есть большая многозонная трансляция заполненная разными разным контентом. Если один контент будет удален из одной зоны трансляции, то в процессе проигрывания на месте удаленного контента появится чёрный экран. Чтобы избежать данной ситуации и используется функциональность выставить продолжительность эфирной сетки по контенту.
[[File:Пример_зоны.png|thumb|center| Пример отображения зоны с пропусками, которые могут привести к появлению чёрного экрана|800px]]
Активировать данную функциональность можно перейдя на настройки страницы и кликнув на кнопку «Продолжительность по контенту».
[[File:Нужная_кнопкаа.png|thumb|center| Пример отображения пути для активации настройки|800px]]
После этого эфирная сетка с удаленным контентом растянется в соответствии с общей продолжительностью текущего проигрываемого контента и будет проигрываться без черного экрана на месте пропуска.
[[File:Правильная_эс.png|thumb|center| Пример отображения адаптированной эфирной сетки|800px]]
=== '''Изменения состава трансляции''' ===
При добавлении контента в текущую зону трансляции пользователю будет отображаться модальное окно со списком изменений в трансляции. В нём пользователь сможет ознакомиться с внесёнными в трансляцию изменениями. Данное окно появляется после нажатия на кнопку сохранения трансляции. Чтобы сохранить изменения трансляции пользователю необходимо нажать на кнопку «Сохранить» внизу экрана.
[[File:История_изменений трансляции.png|thumb|center| Пример отображения модального окна со списком изменений|800px]]
{{Note|Для того чтобы видеть модальное окно с изменением состава трансляций отображалось, необходимо предварительно активировать эту настройку в разделе «Настройки» личного кабинета. Развернув вкладку «Отображение предупреждений», необходимо активировать переключатель напротив параметра «Показывать список изменений при сохранении трансляций»
[[File:Набор_настроек.png|thumb|center| Пример отображения расположения описанных настроек|800px]]|warn}}
</translate>

Файл:История изменений трансляции.png

2026-08-11T10:55:29Z

N.Bloshkin:

Файл:Набор настроек.png

2026-08-11T10:43:13Z

N.Bloshkin:

Удаление аккаунта SmartPlayer

2026-08-11T09:31:23Z

N.Bloshkin:

<languages/>
<translate>

== '''Описание ситуации''' ==
В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и удалить все данные о профиле пользователя.
== '''Алгоритм действий''' ==
Первым дело пользователю необходимо зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом необходимо перейти в раздел «Настройки» и открыть страницу с вкладками настроек.
[[File:Настройки_в_ЛК.png|thumb|center| Пример отображения раздела «Настройки» в личном кабинете SmartPlayer |800px]]
Прокрутив страницу до конца вниз найти блок «Удаление учётной записи» и нажатием развернуть вкладку. После разворачивания вкладки пользователь должен нажать на кнопку «Удалить учётную запись».
[[File:Уаделние_учётки.png|thumb|center| Пример отображения вкладки и кнопки для удаления учётной записи |800px]]
== '''Видеоинструкция''' ==
[https://vkvideo.ru/video-227547238_456239148 Удаление аккаунта SmartPlayer]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_удаления_аккаунта.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</translate>

Удаление аккаунта SmartPlayer

2026-08-11T09:31:16Z

N.Bloshkin:

</languages>
<translate>

== '''Описание ситуации''' ==
В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и удалить все данные о профиле пользователя.
== '''Алгоритм действий''' ==
Первым дело пользователю необходимо зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом необходимо перейти в раздел «Настройки» и открыть страницу с вкладками настроек.
[[File:Настройки_в_ЛК.png|thumb|center| Пример отображения раздела «Настройки» в личном кабинете SmartPlayer |800px]]
Прокрутив страницу до конца вниз найти блок «Удаление учётной записи» и нажатием развернуть вкладку. После разворачивания вкладки пользователь должен нажать на кнопку «Удалить учётную запись».
[[File:Уаделние_учётки.png|thumb|center| Пример отображения вкладки и кнопки для удаления учётной записи |800px]]
== '''Видеоинструкция''' ==
[https://vkvideo.ru/video-227547238_456239148 Удаление аккаунта SmartPlayer]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_удаления_аккаунта.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</translate>

Translations:Удаление аккаунта SmartPlayer/1/en

2026-08-11T09:30:35Z

N.Bloshkin: Новая страница: « == '''Description of the Situation''' == A new functionality has been added to the SmartPlayer personal account — the ability to delete an account through the personal account settings. This functionality allows users to quickly stop using the platform and delete all user profile data. == '''Procedure''' == First, the user must register or log in to the SmartPlayer personal account. Next, the user must navigate to the '''Settings''' section and open t...»

== '''Description of the Situation''' ==
A new functionality has been added to the SmartPlayer personal account — the ability to delete an account through the personal account settings. This functionality allows users to quickly stop using the platform and delete all user profile data.
== '''Procedure''' ==
First, the user must register or log in to the SmartPlayer personal account. 
Next, the user must navigate to the '''Settings''' section and open the page containing the settings tabs.
[[File:Настройки_в_ЛК.png|thumb|center| Example of the '''Settings''' section in the SmartPlayer personal account |800px]]
Scroll to the bottom of the page, find the '''Account Deletion''' section, and click it to expand the tab. After expanding the tab, the user must click the '''Delete Account''' button.
[[File:Уаделние_учётки.png|thumb|center| Example of the tab and button for deleting an account |800px]]
== '''Video Tutorial''' ==
[https://vkvideo.ru/video-227547238_456239148 Deleting a SmartPlayer Account]
== '''Additional Information''' ==
If this article does not help you use the functionality as intended or if you still have questions after reading it, you can ask them in the "Discussions" section at the top of the page.
[[File:Обсуждение_удаления_аккаунта.png|thumb|center| Example of the "Discussions" tab on a wiki page |800px]]
Additional information can also be found on the page [[How Users Can Interact with the "Discussions" Section]]

Translations:Удаление аккаунта SmartPlayer/Page display title/en

2026-08-11T09:30:20Z

N.Bloshkin: Новая страница: «Deleting a SmartPlayer Account»

Deleting a SmartPlayer Account

Удаление аккаунта SmartPlayer

2026-08-11T09:30:05Z

N.Bloshkin: Отметить эту версию для перевода

<translate>

== '''Описание ситуации''' ==
В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и удалить все данные о профиле пользователя.
== '''Алгоритм действий''' ==
Первым дело пользователю необходимо зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом необходимо перейти в раздел «Настройки» и открыть страницу с вкладками настроек.
[[File:Настройки_в_ЛК.png|thumb|center| Пример отображения раздела «Настройки» в личном кабинете SmartPlayer |800px]]
Прокрутив страницу до конца вниз найти блок «Удаление учётной записи» и нажатием развернуть вкладку. После разворачивания вкладки пользователь должен нажать на кнопку «Удалить учётную запись».
[[File:Уаделние_учётки.png|thumb|center| Пример отображения вкладки и кнопки для удаления учётной записи |800px]]
== '''Видеоинструкция''' ==
[https://vkvideo.ru/video-227547238_456239148 Удаление аккаунта SmartPlayer]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_удаления_аккаунта.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</translate>

Удаление аккаунта SmartPlayer

2026-08-11T09:25:18Z

N.Bloshkin:

<translate>
== '''Описание ситуации''' ==
В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и удалить все данные о профиле пользователя.
== '''Алгоритм действий''' ==
Первым дело пользователю необходимо зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом необходимо перейти в раздел «Настройки» и открыть страницу с вкладками настроек.
[[File:Настройки_в_ЛК.png|thumb|center| Пример отображения раздела «Настройки» в личном кабинете SmartPlayer |800px]]
Прокрутив страницу до конца вниз найти блок «Удаление учётной записи» и нажатием развернуть вкладку. После разворачивания вкладки пользователь должен нажать на кнопку «Удалить учётную запись».
[[File:Уаделние_учётки.png|thumb|center| Пример отображения вкладки и кнопки для удаления учётной записи |800px]]
== '''Видеоинструкция''' ==
[https://vkvideo.ru/video-227547238_456239148 Удаление аккаунта SmartPlayer]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_удаления_аккаунта.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</translate>

Удаление аккаунта SmartPlayer

2026-08-11T09:16:35Z

N.Bloshkin:

== '''Описание ситуации''' ==
В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и удалить все данные о профиле пользователя.
== '''Алгоритм действий''' ==
Первым дело пользователю необходимо зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом необходимо перейти в раздел «Настройки» и открыть страницу с вкладками настроек.
[[File:Настройки_в_ЛК.png|thumb|center| Пример отображения раздела «Настройки» в личном кабинете SmartPlayer |800px]]
Прокрутив страницу до конца вниз найти блок «Удаление учётной записи» и нажатием развернуть вкладку. После разворачивания вкладки пользователь должен нажать на кнопку «Удалить учётную запись».
[[File:Уаделние_учётки.png|thumb|center| Пример отображения вкладки и кнопки для удаления учётной записи |800px]]
== '''Видеоинструкция''' ==
[https://vkvideo.ru/video-227547238_456239144 Удаление аккаунта SmartPlayer]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_удаления_аккаунта.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]

Файл:Уаделние учётки.png

2026-08-11T09:14:23Z

N.Bloshkin:

Файл:Настройки в ЛК.png

2026-08-11T09:13:46Z

N.Bloshkin:

Файл:Обсуждение удаления аккаунта.png

2026-08-11T09:12:34Z

N.Bloshkin:

Удаление аккаунта SmartPlayer

2026-08-11T09:11:55Z

N.Bloshkin: Новая страница: «== '''Описание ситуации''' == В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и уда...»

== '''Описание ситуации''' ==
В личном кабинете SmartPlayer появилась новая функциональность — возможность удаления учётной записи через настройки личного кабинета. Данный функционал позволит пользователям быстро завершить взаимодействие с платформой и удалить все данные о профиле пользователя.
== '''Алгоритм действий''' ==
Первым дело пользователю необходимо зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом необходимо перейти в раздел «Настройки» и открыть страницу с вкладками настроек.
[[File:Обсуждение_загрузок.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Прокрутив страницу до конца вниз найти блок «Удаление учётной записи» и нажатием развернуть вкладку. После разворачивания вкладки пользователь должен нажать на кнопку «Удалить учётную запись».
[[File:Обсуждение_загрузок.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
== '''Видеоинструкция''' ==
[https://vk.com/video-227547238_456239055 Удаление аккаунта SmartPlayer]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_загрузок.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]

Android

2026-08-06T06:52:38Z

N.Bloshkin:

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции
|-
| Phillips (проф. серия) || Да
|-
| Phillips (коммерческие) || Да
|-
| Samsung (KNOX) || Да
|-
| TCL || Нет
|-
| BenQ (проф. серия) || Да
|-
| Xiaomi || Нет
|-
| HIKVISION || Да
|-
| Novostar || Да
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В данном случае это можно сделав скопировав [https://cms.smartplayer.org/#/login ссылку]. Должен быть доступен сервер SmartPlayer, если он доступен браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]

===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Установка клиентского приложени на смартфон/планшет

2026-08-06T06:51:19Z

N.Bloshkin: N.Bloshkin переименовал страницу Установка клиентского приложени на смартфон/планшет в Установка клиентского приложения на смартфон/планшет

#перенаправление [[Установка клиентского приложения на смартфон/планшет]]

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

2026-08-06T06:51:19Z

== Установка клиентского приложения на телефон (планшет) ==
Скачать приложение на устройство, использую полученную ссылку.
Запустить apk файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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

2026-08-06T06:51:01Z

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

Android

2026-08-06T06:40:11Z

N.Bloshkin: /* Установка клиентского приложения на телефон (планшет) */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции
|-
| Phillips (проф. серия) || Да
|-
| Phillips (коммерческие) || Да
|-
| Samsung (KNOX) || Да
|-
| TCL || Нет
|-
| BenQ (проф. серия) || Да
|-
| Xiaomi || Нет
|-
| HIKVISION || Да
|-
| Novostar || Да
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В данном случае это можно сделав скопировав [https://cms.smartplayer.org/#/login ссылку]. Должен быть доступен сервер SmartPlayer, если он доступен браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]

===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-06T06:39:24Z

N.Bloshkin:

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции
|-
| Phillips (проф. серия) || Да
|-
| Phillips (коммерческие) || Да
|-
| Samsung (KNOX) || Да
|-
| TCL || Нет
|-
| BenQ (проф. серия) || Да
|-
| Xiaomi || Нет
|-
| HIKVISION || Да
|-
| Novostar || Да
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В данном случае это можно сделав скопировав [https://cms.smartplayer.org/#/login ссылку]. Должен быть доступен сервер SmartPlayer, если он доступен браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]

===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-06T06:38:11Z

N.Bloshkin: /* Режимы работы приложения SmartPlayer на устройстве */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции
|-
| Phillips (проф. серия) || Да
|-
| Phillips (коммерческие) || Да
|-
| Samsung (KNOX) || Да
|-
| TCL || Нет
|-
| BenQ (проф. серия) || Да
|-
| Xiaomi || Нет
|-
| HIKVISION || Да
|-
| Novostar || Да
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В данном случае это можно сделав скопировав [https://cms.smartplayer.org/#/login ссылку]. Должен быть доступен сервер SmartPlayer, если он доступен браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]

===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-05T10:38:12Z

N.Bloshkin: /* Регистрация устройства (первый запуск) */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В данном случае это можно сделав скопировав [https://cms.smartplayer.org/#/login ссылку]. Должен быть доступен сервер SmartPlayer, если он доступен браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]

===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-05T10:37:32Z

N.Bloshkin: /* Регистрация устройства (первый запуск) */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В данном случае это [[https://cms.smartplayer.org/#/login ссылка]]. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]

===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Обновленный дизайн информации об устройстве

2026-08-05T10:34:24Z

N.Bloshkin: /* Информация о работе устройства */

<languages/>
<translate>

== '''Описание ситуации''' ==
Команда SmartPlayer обновила UIи UX часть дизайна раздела «Информация» об устройстве. В этой статье будет описана информация о том, какие данные предоставляет устройство с учетом обновленного дизайна.
== '''Алгоритм действия''' ==
Первый шаг для пользователя — зарегистрироваться/авторизоваться в личном кабинете SmartPlayer. 
Далее пользователю необходимо перейти в раздел «Устройства» и выбрать нужное устройство.
[[File:Новый_интерфейс_устроства.png|thumb|center| Пример отображения раздела «Устройства» и списка устройств |800px]]
После клика по нужному устройству в правой части экрана откроется панель инструментов.
[[File:Раздел_информации.png|thumb|center| Пример отображения строки «Информация» в панели инструментов устройства |800px]]
Пользователю необходимо кликнуть по строке «Информация» и перейти на страницу с описанием всей информации об устройстве.
[[File:Старница_раздела_информация.png|thumb|center| Пример отображения страницы информации об устройстве с отображением нового дизайна |800px]]
== '''Страница «Информация» устройства''' ==
Обновленная страница «Информация» включает в себя следующие блоки:
# Окно снятия скриншота.
# Функциональные кнопки взаимодействия с устройством.
# Информация о работе устройства.
# Доступная информация об устройстве.
[[File:Деление_на_разделы_на_устройстве.png|thumb|center| Пример отображения разделения на блоки нового дизайна страницы с информацией |800px]]
Ниже будет подробнее описано о каждом блоке.
=== '''Окно снятия скриншота''' ===
Данный блок позволяет сделать скриншот проигрываемого контента в текущий момент времени. Оно состоит из двух элементов:
* окно снятия скриншота;
* кнопка снятия скриншота.
[[File:Окно_предпросмотра.png|thumb|center| Пример отображения кнопки и окна предпросмотра скриншота |800px]]
=== '''Функциональные кнопки взаимодействия с устройством''' ===
В этом блоке пользователь сможет напрямую влиять на устройство и управлять им, используя панель с кнопками для управления. Список доступных кнопок (перечислен слева-направо):
* журнал устройства — позволяет выгрузить логи устройства. Доступно два вида логов: полные (за все время) и актуальные;
* питание — позволяет отключить устройство или перевести его в спящий режим;
* перезагрузить — позволяет перезагрузить устройство или клиентское приложение, которое установлено на устройстве;
* очистить — позволяет удалить данные с устройства. Доступно три типа очистки: файлов, локального хранилища, статистика;
* мониторинг — позволяет просматривать логи в реальном времени. Также имеется возможность: следить за последней строкой логов, выгрузить логи, развернуть логи на весь экран, свернуть логи, закрыть окно логов.
* информация о веб-движке — позволяет пользователю получить информацию об устройстве и версии его веб-движка в отдельном окне.
[[File:Управление кнопками устройства.png|thumb|center| Пример отображения кнопок для взаимодействия с устройством |800px]]
=== '''Информация о работе устройства''' ===
Блок включает в себя информацию и данные, которые позволяют понять, как работает устройство. Включает в себя следующие параметры:
* температура;
* загрузка процессора;
* текущая дата и время (UTC +3);
* часовой пояс;
* оперативная память и её наличие;
* время начала работы;
* время без перезагрузки приложения;
* время без перезагрузки устройства.
[[File:Время_без_перезагрузки_устройств.png|thumb|center| Пример отображения информации о работе устройства|800px]]

== '''Доступная информация об устройстве''' ==
Данный блок является самым большим и включает кнопки управления интерфейсом, а также пять основных категорий:
* кнопка «развернуть все поля» — разворачивает все поля на странице;
* кнопка «Свернуть все поля» — сворачивает все поля развернутые на странице;
* кнопка «Копировать в буфер обмена» — копирует всю информацию из полей ниже (можно вставить в текстовый редактор);
* кнопка «Обновить все данные по устройству» — посылает запрос на сервер и обновляет все текущие данные об устройстве;
* категория «Устройство» — включает в себя данные об устройстве, которые отправляются в личный кабинет;
* категория «Лицензия» — включает в себя данные, связанные с лицензией устройства;
* категория «Соединение» — включает в себя информацию о работе устройства с сетью;
* категория «Внутреннее хранилище» — включает в себя информацию о внутреннем хранилище;
* категория «Параметры сборки» — включает в себя информацию связанную со сборкой клиентского приложения, установленного на устройстве.
[[File:Кнопки_и_поля.png|thumb|center| Пример отображения кнопок и категорий с данными об устройстве|800px]]
=== '''Категория «Устройство»''' ===
Данная категория несет в себе следующую информацию:
* идентификатор (идентификатор устройства в базе данных);
* идентификатор устройства;
* версия клиента;
* название устройства;
* производитель;
* имя модели;
* серийный номер;
* платформа;
* наличие root-доступа;
* версия прошивки;
* ориентация;
* разрешение по ширине;
* разрешение по высоте;
* дата последнего снимка (скриншота)
* последний снимок (ссылка на хранилище со скриншотом)
* громкость;
* идентификатор группы (идентификатор группы устройств в базе данных);
* идентификатор компании;
* последнее изменение;
* создан.
[[File:Данные_об_устройстве_в_лк.png|thumb|center| Пример отображения параметров категории «Устройство»|800px]]
{{Note|Подробнее о некоторых параметрах раздела можно узнать [https://wiki.smartplayer.org/index.php/%D0%9F%D1%80%D0%BE%D1%81%D0%BC%D0%BE%D1%82%D1%80_%D1%82%D0%B5%D0%BC%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D1%83%D1%80%D1%8B_%D0%BF%D1%80%D0%BE%D1%86%D0%B5%D1%81%D1%81%D0%BE%D1%80%D0%B0_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0_%D0%B2_%D0%BB%D0%B8%D1%87%D0%BD%D0%BE%D0%BC_%D0%BA%D0%B0%D0%B1%D0%B8%D0%BD%D0%B5%D1%82%D0%B5/ru здесь] и [https://wiki.smartplayer.org/index.php/%D0%A1%D0%B5%D1%80%D0%B8%D0%B9%D0%BD%D1%8B%D0%B9_%D0%BD%D0%BE%D0%BC%D0%B5%D1%80_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0_Tizen_OS здесь]. |warn}}


=== '''Категория «Лицензия»''' ===
Данная категория несет в себе следующую информацию:
* идентификатор лицензии;
* тип лицензии;
* дата покупки.
[[File:Информация_о_лицензии_.png|thumb|center| Пример отображения параметров категории «Лицензии»|800px]]
=== '''Категория «Соединение»''' ===
Данная категория несет в себе следующую информацию:
* кнопка «Проверить соединение» (при нажатии добавляет дополнительные пункты в категорию, которые будут описаны ниже);
* IP-адрес (уникальный идентификатор устройства в сети);
* DNS 1 (первый адрес DNS);
* MAC-адрес (адрес в локальной сети);
* тип соединения (проводной Ethernet или беспроводной Wi-Fi);
* общая скорость между личным кабинетом, серверным и клиентским приложением. Измеряется в миллисекундах (мс). (отображается при нажатии на кнопку «Проверить соединение»);
* Скорость соединения между серверным приложением и клиентским приложением. Измеряется в миллисекундах (мс). (отображается при нажатии на кнопку «Проверить соединение»);
* Скорость соединения между серверным приложением и личным кабинетом. Измеряется в миллисекундах (мс). (отображается при нажатии на кнопку «Проверить соединение»).
[[File:Проверка_скорости_соединения.png|thumb|center| Пример отображения параметров категории «Соединение»|800px]]
{{Note|Подробнее о некоторых параметрах раздела можно узнать [https://wiki.smartplayer.org/index.php/%D0%A1%D0%B5%D1%82%D0%B5%D0%B2%D1%8B%D0%B5_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8_%D0%B2_%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%87%D0%BA%D0%B5_%D1%83%D1%81%D1%82%D1%80%D0%BE%D0%B9%D1%81%D1%82%D0%B2%D0%B0/ru здесь] и Подробнее о некоторых параметрах раздела можно узнать [https://wiki.smartplayer.org/index.php/C%D0%BA%D0%BE%D1%80%D0%BE%D1%81%D1%82%D1%8C_%D1%81%D0%BE%D0%B5%D0%B4%D0%B8%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F_%D0%B8_%D0%B7%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B8_%D1%84%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2 здесь]. |warn}}


=== '''Категория «Внутреннее хранилище»''' ===
Данная категория несет в себе следующую информацию:
* кнопка «Проверить соединение» (при нажатии добавляет дополнительный пункт в категорию, который будет обозначен ниже);
* используется клиентским приложением WhiteLabel
* зарезервировано клиентским приложением WhiteLabel для работы
* размер хранилища;
* используемый размер хранилища;
* размер свободного хранилища;
* скорость скачивания файлов с хранилища. Измеряется в миллисекундах (мс). (отображается при нажатии на кнопку «Проверить соединение»).
[[File:Проверка_соединения_хранилища.png|thumb|center| Пример отображения параметров категории «Внутреннее хранилище»|800px]]
=== '''Категория «Параметры сборки»''' ===
Данная категория несет в себе следующую информацию:
* тип дистрибутива;
* время сборки дистрибутива;
* хэш сборки дистрибутива (hash-сумма сборки дистрибутива).
* кнопка «Подробнее» (позволяет открыть дополнительные параметры связанные со сборкой дистрибутива)
[[File:Параметры_сборки.png|thumb|center| Пример отображения параметров категории «Параметры сборки»|800px]]
== '''Видеоинструкция''' ==
[https://vk.com/video-227547238_456239092 Обновленный дизайн страницы «Информация» устройства]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, их можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_новго_дизайна.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
</translate>

Файл:Время без перезагрузки устройств.png

2026-08-05T10:34:19Z

N.Bloshkin:

Red OS и SmartPlayer

2026-08-05T05:28:33Z

N.Bloshkin:

<languages/>
<translate>

== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].
== '''Отображение платформы в личном кабинете''' ==
После установки дистрибутива Red OS на устройства и добавления его в личный кабинет, пользователь сможет увидеть в разделе «Информация» для устройства, что используется Red OS.
[[File:Описание_платформы.png|thumb|center| Пример отображения описания платформы на устройстве |800px]]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_Red_Os.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
</translate>

Red OS и SmartPlayer/en

2026-08-05T05:27:01Z

N.Bloshkin: Новая страница: «== '''Description of the Situation''' == This article describes the preparation of the SmartPlayer client application distribution package for the RED OS operating system in the RPM package format. This distribution package is required to run the SmartPlayer client application on RED OS and subsequently display content on the playback device. RED OS uses RPM packages. A virtual machine build image is also prepared, which can be used to verify the operation o...»

== '''Description of the Situation''' ==
This article describes the preparation of the SmartPlayer client application distribution package for the RED OS operating system in the RPM package format. This distribution package is required to run the SmartPlayer client application on RED OS and subsequently display content on the playback device. RED OS uses RPM packages. A virtual machine build image is also prepared, which can be used to verify the operation of the SmartPlayer client application on RED OS.
== '''Purpose of the Distribution Package''' ==
The SmartPlayer client application distribution package for RED OS allows users to launch the client application on a device running RED OS and use it to display content. 
During testing with the operating system, the following content types were verified:
* 4K video;
* 8K video;
* images;
* audio;
* widgets;
* synchronized content.
== '''SmartPlayer Usage Scenario on RED OS''' ==
The intended usage scenario for the SmartPlayer client application on RED OS includes the following steps:
# Install the SmartPlayer client application.
# Launch the distribution package.
# Enter the device registration code.
# Assign a broadcast to the device.
== '''Materials Required for Installing RED OS''' ==
To prepare a test environment, the following RED OS distribution packages can be requested from the SmartPlayer technical support team:
* RED OS 8;
* RED OS 7.3;
Users can also refer to the following useful resources:
* [[https://redos.red-soft.ru/product/docs/ RED OS Product Documentation]];
* [[https://redos.red-soft.ru/base/ RED OS Knowledge Base]].
== '''Displaying the Platform in the Personal Account''' ==
After installing the RED OS distribution package on devices and adding them to the personal account, users can open the '''Information''' section for the device and see that it is running RED OS.
[[File:Описание_платформы.png|thumb|center| Example of the platform information displayed for a device |800px]]
== '''Additional Information''' ==
If this article does not help you use the functionality as intended or if you still have questions after reading it, you can ask them in the '''Discussions''' section at the top of the page.
[[File:Обсуждение_Red_Os.png|thumb|center| Example of the '''Discussions''' tab on a wiki page |800px]]

Translations:Red OS и SmartPlayer/Page display title/en

2026-08-05T05:26:33Z

N.Bloshkin: Новая страница: «RED OS and SmartPlayer»

RED OS and SmartPlayer

Translations:Red OS и SmartPlayer/1/en

2026-08-05T05:26:22Z

Red OS и SmartPlayer

2026-08-05T05:23:01Z

N.Bloshkin: Отметить эту версию для перевода

<translate>

== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].
== '''Отображение платформы в личном кабинете''' ==
После установки дистрибутива Red OS на устройства и добавления его в личный кабинет, пользователь сможет увидеть в разделе «Информация» для устройства, что используется Red OS.
[[File:Описание_платформы.png|thumb|center| Пример отображения описания платформы на устройстве |800px]]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_Red_Os.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
</translate>

Red OS и SmartPlayer

2026-08-05T05:22:22Z

N.Bloshkin:

<translate>
== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].
== '''Отображение платформы в личном кабинете''' ==
После установки дистрибутива Red OS на устройства и добавления его в личный кабинет, пользователь сможет увидеть в разделе «Информация» для устройства, что используется Red OS.
[[File:Описание_платформы.png|thumb|center| Пример отображения описания платформы на устройстве |800px]]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_Red_Os.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
</translate>

Red OS и SmartPlayer

2026-08-04T16:04:35Z

N.Bloshkin:

== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].
== '''Отображение платформы в личном кабинете''' ==
После установки дистрибутива Red OS на устройства и добавления его в личный кабинет, пользователь сможет увидеть в разделе «Информация» для устройства, что используется Red OS.
[[File:Описание_платформы.png|thumb|center| Пример отображения описания платформы на устройстве |800px]]
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_Red_Os.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]

Файл:Описание платформы.png

2026-08-04T16:04:29Z

N.Bloshkin:

Red OS и SmartPlayer

2026-08-04T16:02:13Z

N.Bloshkin:

== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].
== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обсуждение_Red_Os.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]

Файл:Обсуждение Red Os.png

2026-08-04T16:02:04Z

N.Bloshkin:

Запуск на Red OS

2026-08-04T16:01:27Z

N.Bloshkin: N.Bloshkin переименовал страницу Запуск на Red OS в Red OS и SmartPlayer

#перенаправление [[Red OS и SmartPlayer]]

Red OS и SmartPlayer

2026-08-04T16:01:27Z

N.Bloshkin: N.Bloshkin переименовал страницу Запуск на Red OS в Red OS и SmartPlayer

== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].

== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обусждение_расписаний.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]

Red OS и SmartPlayer

2026-08-04T16:00:45Z

N.Bloshkin: Новая страница: «== '''Описание ситуации''' == В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отоб...»

== '''Описание ситуации''' ==
В данной статье описана подготовка дистрибутива клиентского приложения SmartPlayer для операционной системы RED OS в формате RPM-пакета. Данный дистрибутив необходим для запуска клиентского приложения SmartPlayer на RED OS и дальнейшего отображения контента на устройстве воспроизведения. RED OS использует пакеты формата RPM. Также подготавливается сборочный образ для виртуальной машины, который можно использовать для проверки работы клиентского приложения SmartPlayer на RED OS.
== '''Назначение дистрибутива''' ==
Дистрибутив клиентского приложения SmartPlayer для RED OS должен позволить пользователю запускать клиентское приложение на устройстве под управлением RED OS и использовать его для отображения контента. 
В процессе взаимодействия с ОС были опробованы следующие типы контента:
* видео в формате 4K;
* видео в формате 8K;
* изображения;
* звук;
* виджеты;
* синхронизированный контент.
== '''Сценарий использования SmartPlayer на RED OS''' ==
Предполагаемый сценарий использования клиентского приложения SmartPlayer на RED OS включает следующие этапы:
# Установить клиентское приложение SmartPlayer.
# Запустить дистрибутив.
# Ввести код регистрации устройства.
# Назначить трансляцию на устройство.
== '''Материалы для установки RED OS''' ==
Для подготовки тестовой среды можно запросить у команды технической поддержки SmartPlayer следующие дистрибутивы для RED OS:
* RED OS 8:
* RED OS 7.3:
Также пользователь может ознакомиться с полезными материалами по ссылкам:
* [[https://redos.red-soft.ru/product/docs/ документация по продуктам RED OS]];
* [[https://redos.red-soft.ru/base/ база знаний RED OS]].

== '''Дополнительная информация''' ==
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
[[File:Обусждение_расписаний.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]

Android

2026-08-03T12:23:12Z

N.Bloshkin: /* Воспроизведение контента с нестандартным разрешением на Android OS Приставок */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

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

2026-08-03T12:23:10Z

N.Bloshkin: Новая страница: «=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''== {{Note|Для приставок под управлением Android OS|warn}} Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходи...»

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]

Android

2026-08-03T12:21:50Z

N.Bloshkin: /* Решение для Android 4.4 */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]

</translate>

== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-03T12:21:17Z

N.Bloshkin: /* Производители Android TV */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-03T12:21:04Z

N.Bloshkin:

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

==''' Производители Android TV''' ==
* Ugoos https://www.ugoos.ru/
* ShiningWorth http://www.shiningworth.com/
* Zidoo https://www.zidoo.tv/
* TCL https://www.tcl.com

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

При работе приложения в обычном режиме, без привелегий, обновление клиентского приложения доступно только с участием пользователя. 
1. Выкладываем на сервер новую версию приложения (обычно делает администратор) 
2. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Интеграция с производителем Dahua

2026-08-03T12:19:51Z

N.Bloshkin: Новая страница: «== ''' Dahua''' == {{Note|Производитель профессиональных панелей бренда Dahua — китайская государственная транснациональная компания Zhejiang Dahua Technology/ Компания является одним из крупнейших разработчиков систем видеонаблюдения и умных IoT-решений. Устройства отлича...»

== ''' Dahua''' ==
{{Note|Производитель профессиональных панелей бренда Dahua — китайская государственная транснациональная компания Zhejiang Dahua Technology/ Компания является одним из крупнейших разработчиков систем видеонаблюдения и умных IoT-решений. Устройства отличаются встроенным программным обеспечением для беспроводной трансляции, видеоконференцсвязи и совместной работы.|warn}}
Теперь клиентское приложение SmartPlayer для Android-устрйоств поддерживает работу с профессиональными панелями производителя «Dahua». Интеграция проводилась на устройстве [https://www.pult.ru/product/informatsionnyy-displey-dahua-dhi-ldh43-lai400l Dahua LDH43-LAI400L] В рамках клиентского приложения была реализована поддержка следующих опций на панелях Dahua:
# Выдача разрешений (разрешения выдаются не все).
# Смена таймзоны.
# Установка даты и времени.
# Обновление нашего приложения и установка сторонних.
# Включение и выключение экрана в спящем режиме.
# Регулировка яркости на уровне подсветки экрана.
# Смена ориентации.
# Снятие скриншота.
# Выключение устройства.
# Перезапуск устройства.

Android

2026-08-03T12:19:27Z

N.Bloshkin: /* Интеграция с производителем Dahua */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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


#Настроить сеть интернет на телефоне.
#Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
#Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
#После установки приложения 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. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-03T12:19:07Z

N.Bloshkin: /* Приставки на Android OS (Android Smart TV) */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работает 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек. Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапазонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== '''Интеграция с производителем Dahua''' ==
{{Note|Производитель профессиональных панелей бренда Dahua — китайская государственная транснациональная компания Zhejiang Dahua Technology/ Компания является одним из крупнейших разработчиков систем видеонаблюдения и умных IoT-решений. Устройства отличаются встроенным программным обеспечением для беспроводной трансляции, видеоконференцсвязи и совместной работы.|warn}}
Теперь клиентское приложение SmartPlayer для Android-устрйоств поддерживает работу с профессиональными панелями производителя «Dahua». Интеграция проводилась на устройстве [https://www.pult.ru/product/informatsionnyy-displey-dahua-dhi-ldh43-lai400l Dahua LDH43-LAI400L] В рамках клиентского приложения была реализована поддержка следующих опций на панелях Dahua:
# Выдача разрешений (разрешения выдаются не все).
# Смена таймзоны.
# Установка даты и времени.
# Обновление нашего приложения и установка сторонних.
# Включение и выключение экрана в спящем режиме.
# Регулировка яркости на уровне подсветки экрана.
# Смена ориентации.
# Снятие скриншота.
# Выключение устройства.
# Перезапуск устройства.

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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


#Настроить сеть интернет на телефоне.
#Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
#Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
#После установки приложения 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. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-03T12:18:36Z

N.Bloshkin: /* Приставки на Android OS (Android Smart TV) */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX ]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работае 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек.Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапозонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== '''Интеграция с производителем Dahua''' ==
{{Note|Производитель профессиональных панелей бренда Dahua — китайская государственная транснациональная компания Zhejiang Dahua Technology/ Компания является одним из крупнейших разработчиков систем видеонаблюдения и умных IoT-решений. Устройства отличаются встроенным программным обеспечением для беспроводной трансляции, видеоконференцсвязи и совместной работы.|warn}}
Теперь клиентское приложение SmartPlayer для Android-устрйоств поддерживает работу с профессиональными панелями производителя «Dahua». Интеграция проводилась на устройстве [https://www.pult.ru/product/informatsionnyy-displey-dahua-dhi-ldh43-lai400l Dahua LDH43-LAI400L] В рамках клиентского приложения была реализована поддержка следующих опций на панелях Dahua:
# Выдача разрешений (разрешения выдаются не все).
# Смена таймзоны.
# Установка даты и времени.
# Обновление нашего приложения и установка сторонних.
# Включение и выключение экрана в спящем режиме.
# Регулировка яркости на уровне подсветки экрана.
# Смена ориентации.
# Снятие скриншота.
# Выключение устройства.
# Перезапуск устройства.

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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


#Настроить сеть интернет на телефоне.
#Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
#Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
#После установки приложения 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. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-03T12:17:57Z

N.Bloshkin: /* Подробное описание возможностей */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX (Ugoos X4)]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работае 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек.Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапозонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}

== '''Интеграция с производителем Dahua''' ==
{{Note|Производитель профессиональных панелей бренда Dahua — китайская государственная транснациональная компания Zhejiang Dahua Technology/ Компания является одним из крупнейших разработчиков систем видеонаблюдения и умных IoT-решений. Устройства отличаются встроенным программным обеспечением для беспроводной трансляции, видеоконференцсвязи и совместной работы.|warn}}
Теперь клиентское приложение SmartPlayer для Android-устрйоств поддерживает работу с профессиональными панелями производителя «Dahua». Интеграция проводилась на устройстве [https://www.pult.ru/product/informatsionnyy-displey-dahua-dhi-ldh43-lai400l Dahua LDH43-LAI400L] В рамках клиентского приложения была реализована поддержка следующих опций на панелях Dahua:
# Выдача разрешений (разрешения выдаются не все).
# Смена таймзоны.
# Установка даты и времени.
# Обновление нашего приложения и установка сторонних.
# Включение и выключение экрана в спящем режиме.
# Регулировка яркости на уровне подсветки экрана.
# Смена ориентации.
# Снятие скриншота.
# Выключение устройства.
# Перезапуск устройства.

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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


#Настроить сеть интернет на телефоне.
#Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
#Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
#После установки приложения 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. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Android

2026-08-03T12:17:41Z

N.Bloshkin: /* Подробное описание возможностей */

<languages/>
<translate>


== Минимальные требования ==
* Операционная система: 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) ==
{{Note|Компания SmartPlayer поддерживает работу со своей приставкой SmartPlayer BOX, а также с приставками под управлением Android OS начиная с версии 5.0|warn}}
{| class="wikitable" style="text-align: center;
|+
|-
|Наименование приставки
|Перезагрузка
|Обновление приложения
|Скриншот с видеоролика
|Установка времени (тайм-зоны)
|Работа 24/7
|Наличие root доступа
|WiFi 2,4 / 5 ГГц
|Отключение автоматического обновления прошивки
|Удаление лишниx приложений
|Рекомендовано SmartPlayer
|Дополнительно


|-
|[https://smartplayer.ru/reklamniy-player-digital-signage SmartPlayer BOX (Ugoos X4)]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|—
|}
'''Исключения'''
Приставки от производителя Harper имеют проблемы с выбором ориентации. Данная проблема связана с особенностями прошивки. Прошивка поддерживает только горизонтальную ориентацию. Сейчас ведётся работа с производителем для решения данной проблемы.
=== Подробное описание возможностей ===
* "Перезагрузка" - перезагрузка устройства физически. Приложение SmartPlayer запустится автоматически после запуска операционной системы.
* "Обновление приложения" - с развитием клиентского приложения, компания SmartPlayer выпускает обновления для своего приложения, в котором могут быть исправлены ошибки, добавлена новая функциональность. Данная функция позволит обновить клиентское приложения удаленно, без физического участия администратора на точке установки устройства.
* "Скриншот с видеоролика" - позволяет снять снимок экрана устройства, когда оно проигрывает видеоролик. Данная функция относится только к видеороликам, если вы планируете показывать только картинки, скриншот будет получен с любого устройства.
* "Установка времени (тайм-зоны)" - в приставках, нет батарейки которая отвечает за внутренние часы устройства, в связи с чем приложение поддерживает актуальное время на приставки. Если у приставки есть выход в сеть интернет, то это функция неактуальная, она важна только в закрытых сетях (без выхода в сеть интернет)
* "Работа 24/7" - приставка работае 24 часа 7 дней в неделю.
* "Наличие root доступа" - это суперпользователь на приставки, у которого есть права на изменения системных настроек.Наличие root доступа, позволяет администрировать устройство приложению SmartPlayer без ограничений. Root доступ предоставляют производители приставок.
* "WiFi 2,4 / 5 ГГц" - WiFi может работать в двух диапозонах, обычно сети 5 ГГц менее загружены, что позволяет достигнуть более стабильного состояния сети
* "Отключение автоматического обновления прошивки" - производители выпускают обновления прошивки (операционной системы) для своих устройств, это функция позволяет администратору системы контролировать, когда будет произведено обновление.
* "Удаление лишниx приложений" - по-умолчанию производители приставок, устанавливают множество приложений. Некоторые приложения, могут делать нотификацию и мешать проигрыванию контента, при наличии этой функции SmartPlayer скроет ненужные приложения с приставки.
* "Рекомендовано SmartPlayer" - это значит, что приставка прошла тестирование в компании SmartPlayer и рекомендована для организации DigitalSignage проектов


{{Note| Все вышеперечисленные сведения являются результатом тестирования компании SmartPlayer. Даже одна модель может отличаться от партии к партии. |warn}}


{{Note| По-умолчанию поддерживаются все устройства начиная с версии Android 5.0.|warn}}

== '''Интеграция с производителем Dahua''' ==
{{Note|Производитель профессиональных панелей бренда Dahua — китайская государственная транснациональная компания Zhejiang Dahua Technology/ Компания является одним из крупнейших разработчиков систем видеонаблюдения и умных IoT-решений. Устройства отличаются встроенным программным обеспечением для беспроводной трансляции, видеоконференцсвязи и совместной работы.|warn}}
Теперь клиентское приложение SmartPlayer для Android-устрйоств поддерживает работу с профессиональными панелями производителя «Dahua». Интеграция проводилась на устройстве [https://www.pult.ru/product/informatsionnyy-displey-dahua-dhi-ldh43-lai400l Dahua LDH43-LAI400L] В рамках клиентского приложения была реализована поддержка следующих опций на панелях Dahua:
# Выдача разрешений (разрешения выдаются не все).
# Смена таймзоны.
# Установка даты и времени.
# Обновление нашего приложения и установка сторонних.
# Включение и выключение экрана в спящем режиме.
# Регулировка яркости на уровне подсветки экрана.
# Смена ориентации.
# Снятие скриншота.
# Выключение устройства.
# Перезапуск устройства.

== Режимы работы приложения SmartPlayer на устройстве ==
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения SmartPlayer на любое устройство с Android 5.0 и выше.
* Device Owner - выдается с помощью настроек разработчика установщиком приложения. Если на устройстве есть root доступ, приложение SmartPlayer автоматически повысит себе права до Device Owner.
* Signature - производитель прошивки, подписывает приложение ключом подписи от прошивки устройства. SmartPlayer предоставляет сборку без подписи, далее она подписывается производителем прошивки и при установки приложения на устройство оно получает привилегии по работе с операционной системой.
* Root - суперпользователь доступный для приложения, самый высокий уровень доступа для приложения. Root предоставляется производителем прошивки, обычно это устройства без сертификации Google.
* Интеграция с SDK производителя устройства - Некоторые производители Android OS устройств предоставляют свой SDK, который позволяет делать управление устройством в обход классической модели. Интеграция с SDK всегда требует времени, так как: необходимо получать ключи на интеграцию и дорабатывать приложение в условиях которые каждый производитель определяет самостоятельно.


{| class="wikitable"
|-
! Производитель устройства !! Наличие интеграции !! Режим работы
|-
| Phillips (проф. серия) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Phillips (коммерческие) || Да || [[Philips#IntergationPhilips|Информация по интеграции]]
|-
| Samsung (KNOX) || Да || Интеграция с SDK производителя устройства
|-
| TCL || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя. [[TCL| Настройка]]
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|-
| [[Novostar]] || Да || DeviceOwner. Интеграция с SDK в процессе выполнения.
|}


'''Все настройки вы можете сделать в ручном режиме, но обычно это неудовлетворяет потребностям b2b сектора. В таблице ниже представлены возможности приложения без участия пользователя на точке (администрирование через личный кабинет SmartPlayer).'''
{| class="wikitable"
|-
! Команда !! Обычный !! Device Owner !! Signature !! Root
|-
| Перезагрузка устройства || Нет || Да (c Android 7.0 и выше) || Да || Да
|-
| Скрыть(показать) все системные launchers || Нет || Нет || Нет || Да
|-
| Выключить устройство || Нет || Нет || Нет|| Да
|-
| Изменить ориентацию устройства || Да (на уровне приложения) || Да (на уровне приложения) || Да (на уровне системных настроек)|| Да (на уровне системных настроек)
|-
| Установить время и дату || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка тайм-зоны || Нет || Да (c Android 9.0 и выше) || Да || Да
|-
| Установка сторонних приложения || Нет || Нет || Нет || Да
|-
| Установка звука || Да || Да || Да || Да
|-
| Обновление приложения SmartPlayer с сервера || Нет || Да || Да || Да
|}


'''Кто и какой режим может выдать приложению.'''
{| class="wikitable"
|-
! Кто может дать доступ !! Обычный !! Device Owner !! Signature !! Root
|-
| Интегратор || Да || Да || Нет || Нет
|-
| Разработчик прошивки || Да || Да || Да || Да
|}


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



'''Выдача режима Device Owner (Владелец устройства). Данный функционал есть на AndroidOS. AndroidOS TV не поддерживает.'''</>


Для включения режима “владелец устройства” потребуется подключение к устройству через [https://developer.android.com/studio/command-line/adb ADB (Android Device Bridge)]. После установки соединения (через провод или по wifi без разницы). Для включения через провод, нужно активировать режим разработчика, для этого нужно: 7 раз нажать на название билда (или сборки), потом откроются настройки разработчика, где нужно включить опцию “Отладка по USB” и включить режим USB в MTP, по умолчанию ставится режим “Зарядка”, который не позволяет подключаться к девайсу. Если выбран путь подключения через WIFI то нужно на девайсе открыть порт 5555, через терминальную команду, сам терминал можно скачать из [https://play.google.com/store/apps/details?id=jackpal.androidterm&hl=ru&gl=US Google Play].


После подключения, проверяем девайс, командой: 
$ adb devices 
Должен быть вывод, аналогичный следующему: 
[[Файл:AdbDevices.jpg]] 
Включаем “Владельца девайса”. 
'''Для 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 файл.
При появлению уведомления нажать "Настройки" 
[[File:Android_1.jpg|400px]] 
Включить "Неизвестные источники" 
[[File:Android_2.jpg|400px]] 
В целях безопасности выбрать "Разрешить только эту установку". Нажать ОК. 
[[File:Android_3.jpg|400px]] 
Выбрать "Установить" 
[[File:Android_4.jpg|400px]] 
Дождаться завершения установки 
[[File:Android_5.jpg|400px]] 
Нажать "Открыть" 
[[File:Android_6.jpg|400px]] 
 
Дождаться появления PIN-кода. Ввести PIN-код в личном кабинете.

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


=== Установка приложения из apk файла ===
Если при установке появляется ошибка (может быть различный текст) и не появляется окно для разрешения установки из неизвестных источников. Сделать следующее:
* Android 5.0+ и до 8.0 (Android Oreo). Настройки -> Экран блокировки и защита -> Неизвестные источники -> (далее смотрите инструкцию выше)
* Android 8.0+ Настройки -> Приложения -> Дополнительные настройки (... в правом верхнем угле) -> Особые права доступа -> Установка неизвестных приложений -> Разрешить установку для необходимых приложений
*При установке возможно появление сообщения '''there was a problem parsing the package (ошибка при синтаксическом анализе пакета)'''. Это означает что клиентское приложение недокаченно, или при его загрузки возникли ошибки на носители.
[[File:There-is-a-Problem-Parsing-the-Package.png|561px]]
[[Файл:Ошибка синтактического анализа.jpg|250px]]


=== Регистрация устройства (первый запуск) ===
При регистрации устройства данные по 9 значному коду должны быть получены с сервера SmartPlayer. Если связи с сервером нет, будет показана ошибка вида
[[Файл:ErrorFirstConnectToServer.png|мини|центр]]


Данная ошибка говорит о том, что не удается соединиться с сервером. Адрес сервера указан в описании ошибки, решения:
* Проверить настройку сетевых параметров на устройстве
* Проверить доступность URL сервера с устройства, вбив в любом браузере строку которая описана в ошибке. В нашем случае это https://jenkins.smartplayer.org. Должен быть доступен сервер SmartPlayer, если он доступн браузером будет отображен UI
[[Файл:Screenshot 20220727 233118.png|мини|центр]]
* Если сервер в бразере доступен, а соединение так же не проходит. В корпоративных сетях может использоваться прокси для модификации пакетов по сети, отключите его.
* Если решить проблему самостоятельно не получилось, нужно предоставить [[DebugSmartPlayer|отладочную информацию]] приложения представителю SmartPlayer или на почту support@smartplayer.org.


После удачного соединения с сервером, будет показан UI для регистрации устройства
[[Файл:Screenshot 20220727 233412.png|мини|центр]]


===Выдача разрешений на снятие скриншота с видеоролика===
Если приложению не выданы привилегии, оно не сможет снять скриншот с видеоролика (ограничение безопасности на уровне операционной системы Android). Потребуется выдача разрешений вручном режиме на устройство, для этого:
* Выбрать (нажав на плитку в разделе устройства) целевое устройство в личном кабинете
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''отключить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства. 
[[Файл:Ansettings.jpg|мини|центр]]
* В правом меню устройства нажать подпункт меню с названием - Разрешения (см. скриншот) 
[[Файл:AndroidPermissionsScreen.jpg|мини|центр]]
* После нажатия будет показано окно, с выдачей разрешений. Нажмите кнопку разрешить, напротив "Разрешение на снятие скриншота:" 
[[Файл:GivePermissionScreen.jpg|мини|центр]] 
* После нажатия на кнопку "Разрешить", на устройстве будет показано системное диалоговое окно в котором нужно поставить галочку (Не показывать снова) и разрешить приложению захватывать экран устройства
[[Файл:Screenshot 20220727 230811.png|мини|центр]]
* Проверить, что разрешения выданы. Запустить видеоролик и попробовать снять скриншот через личный кабинет
* В правом меню устройства нажать подпункт меню с названием - Настройки и '''включить''' "Режим киоска", который находится в секции "Безопасность". Сохранить измененные настройки устройства.


== Запуск в вертикальной ориентации ==
SmartPlayer поддерживает вертикальную ориентации на части устройств. Чтобы её настроить на устройствах, на которых невозможно получить root-права, пользователю необходимо проделать следующие шаги:
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer
На устройствах с поддержкой и возможностью использовать root-права пользователь может настроить ориентацию в личном кабинете SmartPlayer. Для этого ему необходимо:
# Перейти в раздел «Устройства» личного кабинета.
# Выбрать нужно устройство кликом.
# В появившейся панели справа нажать на иконку «Редактировать устройство».
# Найти раздел «Ориентация» и выставить нужный тип ориентации.
# Сохранить изменения в настройках.
[[File:Настройки_ориентации_лк.png|thumb|center| Пример отображения настроек ориентации|800px]]

== Режим киоска ==
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 пискелей область). При включении будет показано сообщение, что режим киоска включен.
== '''Проигрывание контента в режиме синхронизации'''==
{{Note|Режим синхронизации - это режим работы устройств внутри личного кабинета SamrtPlayer, когда воспроизводимый контент синхронизируется между устройствами в рамках одной трансляции. |warn}}
=== '''Требования для корректной работы режима синхронизации''' ===
#Устройства должны быть подключены к RJ45 и быть в одной сети.
#Создать группу устройств, и переместить в нее устройства на которых требуется синхронизация контента
#Далее необходимо настроить данную группу: Настройка → платформа Android → Синхронизировать контент → Да → Сохранить изменения
#Устройства должны иметь одинаковые прошивки для корректной работы режима
#Допустимая задержка при синхронизации через Ethernet кабель - 100 м/с, через Wi-fi - 150 м/с.
#В трансляции, которая проигрывается в режиме синхронизации обязательно должна быть одна страница. Если устройство или несколько устройств не имеет/не получило IP - адрес, то синхронизация на устройствах работать не будет.
# Ролики нужно предварительно обработать в видеоредакторе и у них должен быть одинаковый fps.
# Для работы без сети, требуется, чтобы у устройств присутствовал IP. Это нужно для управления устройствами. Для получения IP устройства обязательно должны быть подключены к роутеру, иначе они останутся без ip и не смогут работать.
# Синхронизация на Андроид устройствах работает постранично. Главное — одинаковая длительность и количество страниц.
# Нужно отключить на устройство автоматическую корректировку времени, для того, чтобы при приведении времени к эталонной системе времени на устройстве не ломался режим синхронизации.
# Не рекомендуется синхронизация анимации не гарантируется, но возможна в рамках текущей реализации режима синхронизации (анимация не закладывалась при разработке) и может быть реализована в рамках устройств идентичной модели и конфигурации. Возможны проблемы при проигрывании анимации в режиме синхронизации.
#Если трансляция тяжелая для проигрывания (притормаживает или отображаются графические артефакты), рекомендуется облегчить трансляцию с помощью урезания или смены контента. Также можно использовать встроенный функционал SmartPlayer - «Видеоредактор».
#Существует крайне малая вероятность совпадения ID для двух групп устройств. В этом случае синхронизация может отработать некорректно, т.к. та группа устройств, в которой будет отсутствовать "Master"-устройство будет получать задачи от группы устройств в котором есть "Master". В таком случае синхронизация будет работать некорректно.
# Не рекомендуется проигрывать в режиме синхронизации трансляции со звуком. Если кейс требует звук, то рекомендуется оставлять аудио только на одном устройстве из группы.
# Реализация режима синхронизации не включает поддержку фоновой музыки.
# Проблемы с подтормаживанием режима синхронизации могут быть связаны со слабой конфигурацией сервера и отсутствием запаса мощности у него.
# Проверяйте «Схему синхронизации» чтобы понимать действительно включена ли синхронизация. Бывают случаи что режим «Синхронизации» не активирован.
# Проблемы при проигрывании могут быть связаны с сетью и плохим кабель-менеджментом. В случае когда устройства в режиме синхронизации находятся на большом расстоянии может быть большой пинг (ping) и устройства могут получать пакеты с данными с задержкой. От этого может быть рассинхронизация при проигрывании.
# Проигрывание GIF работает по индивидуальной логике. Они будут синхронизированы по моменту запуска и до следующего цикла могут быть не синхронизированы правильно.
# Если в синхронизации должен проигрываться очень большой ролик (например длительностью десять часов), то возможны отклонения при проигрывании, в связи с индивидуальной работой каждого устройства.
# Возможна нестабильность при работе режима синхронизации, если используется контент длительностью меньше пяти секунд. Это связано с особенностями реализации режима синхронизации на Android устройствах (устройству нужно до 5 секунд чтобы подготовить эвент к запуску, поэтому если текущей контент меньше по длительности, то устройство не успевает подготовить следующий страницу с контентом для синхронизации и получается что в трансляции контент выводиться не синхронно).
# Проигрывание объявлений в режиме синхронизации также может быть нестабильным, если длительность контента меньше шести секунд. Рекомендуется запускать два одинаковых контента в рамках одной страницы чтобы сумма проигрывания контента по времени получалась больше шести секунд.
# Чтобы избежать проблемы с рассинхронизацией рекомендуется размещать контент с малой длительностью на страницу с уже имеющимся контентом чтобы увеличить общую длительность контента до значения минимум шесть секунд.
# Если в рамках трансляции нужно постоянно играть по циклу контент менее шести секунд, то лучше поместить на страницу несколько контентов, чтобы длительность страницы попала в допустимую (минимум шесть секунд).Это обеспечит стабильность проигрывания на слабых устройствах Android.
==='''Особенности контента'''===
*Плейлист у 2х разных трансляции при использовании режима видеостены должен быть равен по времени
*У видео которые будут использоваться должен быть одинаковый FPS (количество кадров в секунду)
*Синхронизация возможна только с видео файлами. В случае использования изображения его необходимо предварительно перевести в видеоформат с помощью встроенного видеоредактора
*Если пользователю необходимо синхронизировать видеоконтент, с учетом позиции видео, а не только по параметру "Время начала", то необходимо создать трансляцию с одной зоной. Внутри этой трансляции контент должен быть только в формате видео и располагаться друг за другом - в таком случае видеоконтент будет синхронизироваться по позиции видео. Во всех остальных случаях видеоконтент будет стартовать одновременно и внутри видеоконтентов позиции синхронизироваться не будут.
*Видео в трансляциях должно быть одинаковым по времени. '''Пример'''. Две трансляции, суммарное время каждой 1 минута. Контент первой трансляции 2 видео по 30 секунд, контент второй трансляции 2 видео но так же 30 секунд. Если бы во второй трансляции было 2 видео, но видео 1 равно 10 секунд, видео 2 равно 50 секунд, то синхронизация бы отсутствовала.
* Стандартные параметры ролика для видеостены: разрешение 1920х1080, частота кадров 25, кодек h264, контейнер .mp4, без аудиодорожки
* Все видеоролики должны быть одного разрешения в плейлисте, который синхронизируется
* Одинаковый FPS у всех видеороликов в плейлисте, который синхронизируется
* Одинаковый битрейт у всех видеороликов в плейлисте, который синхронизируется
* Наличие (или отсутствие) аудиодорожки у всех видеороликов в плейлисте, который синхронизируется
* При проигрывании в режиме синхронизации видеороликов необходимо отключить музыку. Рекомендуется делать для реализации в которой синхронизации и ее аудио часть должны проигрываться как единое целое. Иначе с помощью аудио слышно переключение между роликами. В случае, если необходимо иметь фоновую музыку, то рекомендуется аудиодорожку добавлять на уровне трансляции. В таком случае прерываний при переключении не будет.
{{Note|Возможно (но не рекомендуется) синхронизировать разные модели устройств Android OS. |warn}}
*

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


#Настроить сеть интернет на телефоне.
#Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
#Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
#После установки приложения 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. Далее по документу [https://docs.google.com/document/d/1IMP41cPcqK1v6kCU7Jp42fKDuOytRLw2sDB8YdxXZtY/edit?usp=sharing Ручное обновление SmartPlayer]
=='''Аппаратные ограничения платформы'''==
На устройствах Android существуют следующие аппаратные ограничения:
# Получение root-прав на устройстве открывает доступ к большему количеству возможностей взаимодействия с устройством
# В зависимости от используемого устройства под управлением Android OS количество одновременно проигрываемых видео разнится. Данная функциональность зависит от используемых на устройствах декодерах
# Запрещено считывать MAC-адрес и IP - адрес устройства
{{Note|Список аппаратных ограничений на устройствах под управлением Android OS всегда разный. Данная ситуация связана с тем, что каждый производитель устройства может разрешить или заблокировать возможность использовать функционал доступный на платформе Android OS.|warn}}

=='''Воспроизведение контента с нестандартным разрешением на Android OS Приставок '''==
{{Note|Для приставок под управлением Android OS|warn}}
Для начала работы с нестандартным по разрешению контентом на приставке под управление Android OS, пользователю изначально необходимо авторизоваться в личном кабинете. 
Далее ему необходимо зайти в раздел личного кабинета "Трансляции" и перейти в категорию "Создать".
[[File:Раздел_лк.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете пользователя |800px]]
Следующим шагом пользователю необходимо создать трансляцию с любым вариантом ориентации: вертикальной или горизонтальной. Данный параметр зависит от настроек приставки. Справа внизу для применения настроек пользователю необходимо нажать кнопку "Сохранить".
[[File:Пример_трансляции.png|thumb|center| Пример отображения созданной трансляции в горизонтальной ориентации в разрешении 1920 Х 1080|800px]]
После описанных выше действий пользователь должен создать зону трансляции нажав на специальную иконку.
[[File:Иконка_зоны.png|thumb|center| Пример отображения иконки создания зоны в трансляции|800px]]
В процессе выбора зоны пользователю откроется тулбар справа, в которому можно будет указать параметры размеры зоны в пикселях. В строках "Ширина" и "Высота" пользователь должен указать нужные значения размера прописав их цифрами.
[[File:Высота_и_ширина.png|thumb|center| Пример отображения параметров "Ширина" и "Высота" в зоне размещения контента в трансляции|800px]]
Выставив параметры "Ширина" и "Высота" пользователь должен выбрать необходимы для проигрывания контент. Данное действие также делается в тулбаре справа.
[[File:Нужный_контент.png|thumb|center| Пример отображения выбора контента для трансляции в зоне|800px]]
Последним шагом для пользователя будет - установка трансляции на устройство. Все проделанные ранее действия приведут пользователю к корректному воспроизведению контента с нестандартным разрешением на устройствах под управлением Android OS.
[[File:Пример_рабочего_устройства.png|thumb|center| Пример настроенного и работающего устройства|800px]]
== '''Предустановленные настройки для медиа-потоков''' ==
В связи с большим количеством производителей с приставками под управлением Android OS, которые делают свои устройства индивидуальными даже внутри одной компании, часто возникают проблемы с воспроизведением контента. Чтобы во многом решить данные проблемы в процессе создания трансляции пользователь может использовать готовые пресеты настроек для устройства.
=== '''Алгоритм действий''' ===
Чтобы пользователь смог взаимодействовать с пресетами ему необходимо авторизоваться в личном кабинете и найти раздел "Трансляции". В разделе "Трансляции" необходимо выбрать категорию "Создать".
[[File:Создание_трансляции_в_ЛК.png|thumb|center| Пример отображения раздела "Трансляции" и категории "Создать" в личном кабинете|800px]]
Следующим шагом пользователю необходимо создать зону для контента в трансляции с помощью специальной иконки.
[[File:Доабвление_зоны_по_иконке.png|thumb|center| Пример отображения иконки "Добавить зону" при создании трансляции и отрисовки самой зоны на экране страницы|800px]]
Далее пользователю необходимо выбрать из списка контент в виде медиа-потока, который у него добавлен в личный кабинет.
[[File:Медиа_поток_в_трансляции.png|thumb|center| Пример отображения добавления нужного медиа-потока в зону трансляции|800px]]
Добавив медиа-поток в зону трансляции пользователю необходимо еще раз нажать на контент в зоне трансляции чтобы изменить отображение настроек в тулбаре справа с параметрами трансляции.
[[File:Тулюар_с_новыми_настройкам.png|thumb|center| Пример отображения тулбара с настройками для трансляции |800px]]
В открывшемся тулбаре пользователю необходимо выбрать блок "Настройки контента" и перейти в его раздел под названием "Android".
[[File:Настройки_контента_android.png|thumb|center| Пример отображения блока "Настройки контента" и раздела "Android" в тулбаре |800px]]
Открыв данный раздел, пользователь получит доступ к настройкам пресетов для устройств.
=== '''Список настроек''' ===
Блок работы с пресетами в разделе "Android" именуются как "Пресеты для стрима".
[[File:Пресеты_для_стрима.png|thumb|center| Пример отображения настроек в блоке "Пресеты для стрима" |800px]]
В этом блоке доступна для изменения только одна настройка - "Тип пресета".
Данная настройка позволяет выбрать из четырех видов пресетов:
* NetUP
* Ugoos 1
* Ugoos 2
* Ручные настройки
{{Note|По умолчанию остальные настройки в блоке "Пресеты для стрима" заблокированы для любого именного пресета. Вариант "ручные настройки" открывают доступ к настройкам расположенным ниже|warn}}
==== '''Подробнее о ручных настройках''' ====
В режиме "Ручных настроек" пользователь получает доступ ко всем настройкам, расположенным ниже, а именно:
# Поверхность отрисовки потока - позволяет выбрать возможности отрисовки со стороны производителя устройства. Доступно три варианта: surface - самый простой и легковесный вариант отрисовки для системы вариант; textures - более тяжелый вариант отрисовки для системы, позволяющий лучше обрабатывать графику, на мощных приставках; vlc_layout - совмещаем в себе оба решения и автоматически применяет подходящее с учетом параметров плеера и мощности устройства
# Настройки VLC - позволяет вручную прописать настройки для vlc-плеера. Подробная информация о том, как правильно указать настройки вручную для vlc можно просмотреть по следующим ссылкам: [https://wiki.videolan.org/Documentation:User_Guide/ ссылка 1], [https://wiki.videolan.org/Documentation:Command_line/ ссылка 2], [https://wiki.videolan.org/Documentation:Advanced_Use_of_VLC/ ссылка 3 ].
# Чекбокс/галочка по возможности использовать ExoPlayer - позволяет использовать ExoPlayer для проигрывания стрим-потока. Наиболее часто используется для потоков: rtp, rtsp, udp и hls.
После завершения всех настроек пользователю необходимо нажат на кнопку "Сохранить" посреди экрана и завершать настройку трансляции для проигрывания на устройстве.
{{Note|UDP-поток работает с ExoPlayer и может использовать мультикаст. Для стабильной работы UDP-потока рекомендуется использовать следующие настройки:
* MPEG-TS-контейнер;
* Кодек H 264.
|warn}}
== '''Вывод QR-кода и кода регистрации на устройства с маленьким экраном''' ==
Для того, чтобы корректно отображать QR-код и код регистрации на устройствах с маленьким экраном, было решено изменить расположение данных кодов на экране. 
В текущей реализации код регистрации был смещен в левый верхний угол и прописывается в нем мелким шрифтом, а QR - код был перемещен в центр экрана.
[[File:Изменение_отображения android.png|thumb|center| Пример нового отображений кода регистрации и QR - кода для регистрации устройств в личном кабинете SmartPlayer |800px]]
{{Note|Если пользователю все равно остается неудобен такой способ регистрации, то на платформе SmartPlayer есть альтернативный вариант. Существует функциональность позволяющая зарегистрировать устройство другим способом. Это функциональность называется "Черновики". Подробнее в статье - [[Функциональность "Черновики" для устройств]].|warn}}
== '''Индивидуальные решения''' ==
Для пользователей клиентского приложения SmartPlayer по специальному запросу была реализована поддержка версии 4.4 KitKat. 
Несмотря на созданное решение в виде клиентского приложения под данную версию, сотрудники технической поддержки и команда разработки SmartPlayer не рекомендуют использовать слабые и устаревшие устройства. 
Подробнее ознакомиться с возможностями клиентского приложения на базе Android OS 4.4 можно [https://wiki.smartplayer.org/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_Android_4.4 здесь]
== '''Использование PDF в качестве контента''' ==
Чтобы использовать PDF-файл на устройстве в качестве контента, ознакомьтесь со статьей по [https://wiki.smartplayer.org/index.php/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_PDF-%D1%84%D0%B0%D0%B9%D0%BB%D0%B0_%D0%B2_%D0%BA%D0%B0%D1%87%D0%B5%D1%81%D1%82%D0%B2%D0%B5_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0 ссылке]
== '''Решение для Android 4.4''' ==
Было проработано индивидуальное решение для Android 4.4, с описанием которого можно ознакомиться по [https://wiki.smartplayer.org/index.php/Android_4.4 ссылке]
</translate>
== '''Удаленное управление устройством на Android OS''' ==

[[Удаленное управление устройством на Android OS|Удаленное управление устройством на Android OS ]]

== '''Режим "Засыпания"''' ==
=== '''Алгоритм действий''' ===
Для начала, пользователь должен зарегистрироваться или авторизоваться в личном кабинете SmartPlayer. 
Следующим шагом пользователю необходимо перейти в раздел "Устройства".
[[File:Лк_устройства.png|thumb|center| Пример отображения раздела "Устройства" в личном кабинете|800px]]
В разделе "Устройства" необходимо выбрать нужное устройство и кликнуть по нему. Тем самым устройство будет выделено.
[[File:Выделенное_устройство.png|thumb|center| Пример отображения выбора устройства в личном кабинете |800px]]
После выделения устройства отображение страницы и появится тулбар с настройками устройства. Тулбар расположен с правой стороны. Переместившись к тулбару пользователь должен выбрать строку "Настройки".
[[File:Тулбар_настройки.png|thumb|center| Пример отображения строки "Настройки" в тулбаре |800px]]
Открыв страницу "Настройки" пользователь должен выбрать первую строку с названием "Автоматизация управления".
[[File:Автоматизация_управления.png|thumb|center| Пример отображения блока настроек "Автоматизация управления"|800px]]
После описанных ранее действий появится новое окно, в котором пользователю необходимо найти раздел "Общее". В разделе расположены таймеры включения и выключения устройства, под которыми расположен нужный пользователю чекбокс (галочка) с названием "Использовать спящий режим".
[[File:Чекбокс_спящий_режим.png|thumb|center| Пример отображения чекбокса "Использовать спящий режим" |800px]]
Активация данного чекбокса позволит использовать на устройствах режим "Засыпания".
{{Note|Для завершения настройки устройства необходима проскроллить страницу до конца и нажать на кнопку "Сохранить изменения".
[[File:Сохранить_изменения.png|thumb|center| Пример отображения кнопки "Сохранить изменения" |800px]]|warn}}
=== '''Отличие старой реализации от новой''' ===
Описанная выше информация о режиме засыпается является новой реализацией функционала. В ней был полностью изменен сам принцип работы "засыпания" устройства.
{| class="wikitable"
|+ Реализации спящего режима|-
! Старая !! Новая
|-
| Старая реализация использовала режима гибернации с использованием черной "маски", подсветка дисплея в котором оставалась активной. Это увеличивало расход энергии. Проверка системы проходила раз в 10 минут. Информация о громкости и яркости устройства при переходе в "спящий" режим не сохранялась. || В новой реализации устройство "засыпает" полноценно, закрывая видеоканал с сервером. С помощью чекбокса активируется "спящий" режим, который ранее можно было включить вручную через личный кабинет. Перед отключением сохраняет параметры яркости и громкости, чтобы после активации использовать их для корректного продолжения работы. Статус устройства в "спящем" режиме изменится с зеленой рамки на голубую.
|}
=== '''Реакция экрана и монитора при переходе в спящий режим''' ===
При переходе устройства в спящий режим система может использовать до трёх механизмов управления экраном и подключённым монитором. Доступность каждого механизма зависит от типа устройства, наличия root-прав и поддержки необходимых протоколов. Если устройство поддерживает несколько механизмов, они могут применяться одновременно.
# '''Отображение чёрного слоя.'''— клиентское приложение размещает поверх воспроизводимого контента практически непрозрачный чёрный слой. Данный механизм используется на устройствах без root-прав. При этом экран остаётся включённым, но отображаемый контент становится недоступен для просмотра.
# '''Отключение видеосигнала с помощью video mute.''' — клиентское приложение изменяет системную переменную и включает режим `video mute`. В результате передача видеосигнала на подключённый монитор прекращается. Данный механизм доступен только на устройствах с root-правами.
# '''Перевод монитора в спящий режим по HDMI-CEC.'''— данный механизм используется только на устройствах SmartBox с root-правами. Если устройство и подключённый монитор поддерживают протокол HDMI-CEC, клиентское приложение отправляет монитору команду перехода в спящий режим. Возможность использования данного механизма зависит от поддержки HDMI-CEC со стороны конкретной профессиональной панели.
=== '''Особенности работы с различными устройствами''' ===
Разные модели устройств и профессиональных панелей могут использовать различные аппаратные компоненты и API управления питанием. Поддержка перехода в спящий режим должна проверяться отдельно для каждой модели устройства и панели. В рамках такой проверки необходимо определить:
* наличие root-прав;
* возможность использования режима `video mute`;
* поддержку протокола HDMI-CEC;
* возможность отправки команды перехода в спящий режим;
* корректность работы таймера перехода в спящий режим.
{{Note|Фактическое поведение экрана и монитора зависит от аппаратных возможностей устройства и подключённой панели. Поддержка одного механизма не гарантирует поддержку остальных механизмов.|warn}}
=== '''Видеоинструкция''' ===
[https://vk.com/video-227547238_456239053 Режим засыпания на устройствах]

Решение проблем (Troubleshooting)

2026-08-03T10:32:49Z

N.Bloshkin: /* Windows */

<languages/>

<translate>

== Общие рекомендации ==

#В случае возникновения ошибок в работе проф. панелей или программного обеспечения SmartPlayer в первую очередь убедитесь в том, что вы используете одну из последних/рекомендованных версий прошивки.
##Samsung: На пульте ДУ нажмите кнопку "Menu". В появившемся меню выберите "Система" -> "Обращение в Samsung". Актуальные версии прошивок можно найти [[Актуальные_прошивки_Samsung|здесь]]. Также для отсечения большинства возможных проблем рекомендуется сделать Factory Reset. Для этого из выключенного состояния набрать на пульте ДУ комбинацию mute-1-8-2-PowerOn. В появившемся сервисном меню выбрать Option -> Factory Reset -> Factory Reset.
##LG:
###'''WebOS 2.0 / WebOS 3.0''' На пульте ДУ нажмите кнопку "Home", выберите System Information/Information. 
###'''WebOS 3.2 / WebOS 4.0''' На пульте ДУ нажмите кнопку "Home", выберите плитку S/W Version

Если в списке известных проблем вы не нашли вашу ситуацию, обратитесь в тех. поддержку SmartPlayer. 
Информация которая нам поможет максимально быстро решить вашу проблему:
#Используемый платформа/клиент: SSSP/Windows/Linux/Android.
#Версия OS или версия прошивки в случае с SSSP.
#Способ подключения Ethernet(RJ-45)/Wi-Fi/3G-4G или Offline режим.

Если планируете обратиться в тех. службу SmartPlayer, ознакомьтесь с [[DebugSmartPlayer|средствами отладки]].

== Известные проблемы ==

=== '''Tizen''' ===
==== '''[SSSP4/SSSP5/SSSP6] Невозможно установить приложение через URL Launcher.''' (Ошибки: Невозможно установить приложение через URL Launcher или Недостаточно памяти для загрузки средства запуска). ====

''Решение:''
*'''Использовать прошивку 2020 или новее.'''
*Зайти в меню с помощью пульта ДУ.
*Выбрать Система -> Общие -> Очистить хранилище.
*Перезагрузить панель.
==== '''[SSSP2 и SSSP3] Network connection lost.''' ====

''Решение: ''
*'''Прописать URL адрес с префиксом http://.'''
*sa2.org/ol/ - неправильно
*http://sa2.org/ol/ - правильно, в конце должен быть закрывающий '''/''' . URL http://sa2.org/ol/ приведен только в качестве примера, в зависимости от проекта представителем SmartPlayer будет выдан нужный URL
*Ошибка хаотичная и возникает на разных прошивках, для избежания проблем на старых прошивках, всегда нужно прописывать префикс http://.
==== '''[SSSP2 и SSSP3] Please Check your Network.''' ====

''Решение: ''
*'''Проверить (настроить при необходимости) соединение с интернетом'''
==== '''[Все устройства] Черный экран после установки и первого запуска приложения.''' ====

Если время указано на устройстве неверно, не пройдет подключение по https, так как сертификат на текущий год выпущен. Соединение не установится с сервером, как следствие код регистрации не будет показан (будет черный экран).
''Решение: ''
* проверить что время на проф. панели установлено верно (текущий год).
==== '''[SSSP2,SSSP3,SSSP4,SSSP5, SSSP6] Не удается найти файл установки.''' ====

[[File:Photo_2019-07-08_10-56-25.jpg|200px]] [[Файл:Сообщение от Tizen, когда нет интернета.jpg|200px]] 
''Решение:''
*'''Проверить наличие интернета на панели'''
*Для проверки доступа, через встроенный браузер (нажмите на пульте SOURCE -> Web Browser) попробовать перейти по ссылке http://sa2.org/. Должна отобразиться страница с надписью 403 Forbidden, это означает что доступ к ресурсу на котором расположено приложение есть. Если у Вас локальный сервер, используйте локальные urls для проверки наличия связи, выданные системным администратором.
==== '''[SSSP4 и SSSP5, SSSP6] Не обновляется клиентское приложение.''' ====

При старте проф. панель ждет сетевое соединение 30 секунд, если за это время не поднялась сеть, система запустит приложение в оффлайн режиме и обновление не произойдет.
Данная проблема чаще всего возникает при использовании портативных модемов, которые запитываются от USB. Как правило, такие модемы поднимают сеть, после того как приложение уже загружено и обновление не происходит.

''Решение:''

Выставить в настройках URL адреса (HOME - Настройки URL-адреса), максимально таймер бездействия, для sssp6 это 300c.
[[File:timer_wait_sssp6.jpg|250px]]
==== '''[SSSP2/3/4/5/6] Приложение уходит в оффлайн и не реагирует на действия с пульта.''' ====

При неправильной настройки роутера, в частности DHCP, панель может бесконечно терять и получать IP адрес, в следствие чего статус панели уходит в оффлайн, сама панель зависает. В данном случае, если есть нестабильный роутер самое правильное решение настроить на панели '''статичный''' IP адрес. Настройки - Сетевые настройки - Ручная настройка сети.
==== '''[SSSP2/3/4/5/6] Черная заставка Samsung показывается после N времени работы устройства ''' ====

[[Файл:Black screen samsung.png|200px]] 
Отключить в настройках системы параметр режим ожидания, спящий режим. 
''Решение:''
* Система - Регулятор мощности
* Система - Экономичный режим
==== '''[SSSP2/3/4/5/6] Устройство оффлайн(серая плитка) при активном сетевом соединении в личном кабинете SmartPlayer '''
В системе SmartPlayer экран может быть показан оффлайн (серый) при наличии следующих проблем c настройкой.
* На устройстве установлена неправильная дата и время (от текущей даты). Соединение происходит по защищенному протоколу HTTPS, устройство не пропускает соединение если даты сертификата не соответствуют дате установленной на устройстве.
** Решение. Установите текущую дату и время на устройстве.
* Убедитесь, что к провайдеру приложения (URL ссылки которую вбиваете) есть доступ из внутренней сети предприятия.
** Решение. На устройствах есть встроенный браузер, откройте ссылку (URL ссылки которую вбиваете) в браузере и убедитесь, что браузер откроет ссылку.
* Убедитесь, что на устройстве есть интернет соединение.
** Решение. Откройте настройки соединения и проверьте, что устройство получает проверку наличия интернет соединения.
На примере WebOS
 
[[Файл:Photo 2020-10-03 14-11-27.jpg|200px]]
====''' [SSSP4/5/6] Отображаются окна отладки приложения '''====
''Решение:'' Отключить режим разработчика на устройстве.
Нажмите Home на пульте, перейдите в "Запуск Url-адреса" и отключите "Режим разработчика"
[[Файл:DeveloperOptionsOnTizenOS.jpg|200px]]
==== '''[SSSP2 и SSSP3] Приложение не переустанавливается''' ====
''Решение: ''
*1. Прописать ссылку '''$DEL''' и нажать на URL Launcher
*2. Устройство перезагрузится
*3. Прописать новую ссылку с приложением
====''' Почему телевизор с поддержкой разрешения UltraHD (4K UHD с разрешением 3840 × 2160) в карточки устройства в личном кабинете SmartPlayer показывает разрешение FullHD (1920x1080) '''====
На устройствах OrsayOS, TizenOS, WebOS интерфейс приложения всегда отрисовывается в разрешении FullHD (1920x1080). Покупая телевизор с возможностью проигрывания UltraHD контента, значит что внутренний плеер устройства поддерживает проигрывание видеоролика с разрешением 3840 × 2160 и нужным fps, но интерфейс приложения будет рассчитываться относительно параметров 1920x1080. Так как данные для карточки устройства берутся от операционной системы, они показываются 1920x1080, так как система отрисовывает интерфейс в 1920x1080.
===='''Проигрывание видеороликов без черных гэпов и других артефактов '''====
Проигрывание плейлиста без черных гэпов между видеороликами, является важнейшей функцией в DigitalSignage, в тоже время данная функция сильно зависит от прошивки устройства и реализации на разных платформах (даже в рамках одно ос) различаются.
Для всех проф. панелей (WenOS2/3.0/3.2/4, Orsay2/3, Tizen2.4/3.0/4.0) идеальным вариантом будет:
'''A'''. Один fps для всех роликов в плейлисте. Можно сделать плейлист 25,30,60 fps но все ролики должны быть такого fps. Если миксовать fps это может работать (зависит от прошивки), но рекомендуется подготовить ролики, чтобы был один fps.
Идеально: 30fps → 30fps → 30fps.
Неидеально: 30fps → 25fps → 30fps.
'''B'''. Одно разрешение видеороликов. Можно сделать плейлист из 1920x1080, 1280x720, 3840 × 2160, но все ролики должны быть одного разрешения. Если миксовать, скорее всего будут артефакты в виде черных гэпов, искажений изображений первого кадра.
Идеально: 1920х1080 → 1920х1080 → 1920х1080.
Критично: 1920х1080 → 1280х720 → 1920х1080.
'''C'''. Горизонтальная ориентация работает стабильней, в отличии от вертикальной. Можно запускать перевернутый контент на 90 градусов, в вертикальном режиме, визуально будет достигнут вертикальный режим проигрывания. Для переворота видеоролика можно использовать встроенный видеоредактор в личном кабинете SmartPlayer.
Идеально: горизонтальная (landscape) ориентация.
Неидеально: вертикальная (portrait) ориентация.
'''D'''. Плейлист который проигрывается должен состоять только из видеороликов. Это обусловлено тем, что у проф. панелей отдельный API для проигрывания в бесшовном режиме. Если нужно проиграть картинку, её можно конвертировать в видеоролик используя встроенный видеоредактор в личном кабинете, при конвертировании в видеоролик картинке можно указать продолжительность.
Идеально: видео->видео->видео.
Неидеально: видео->картинка->видео.
'''E'''. Все видеофайлы в плейлисте должны использовать один контейнер и один кодек.
Идеально: mp4_H264->mp4_H264->mp4_H264.
Неидеально: mp4_H2645->mp4_H264->mp4_H264.
== '''WebOS''' ==
==== '''[WebOS 2/3/3.2/4.0/4.1] Выключается экран ''' ====

Проверьте настройки в разделе Power (Питание).
''Решение:''
* No Signal Power Off (15Min) выключите (ползунок должен быть серый)
* No IR Power Off (4 hour) выключите (ползунок должен быть серый)

[[Файл:Photo 2020-08-12 16-53-08.jpg|200px]]
==== '''[WebOS 2/3/3.2/4.0/4.1/6] Устройство оффлайн(серая плитка) при активном сетевом соединении в личном кабинете SmartPlayer ''' ====

В системе SmartPlayer экран может быть показан оффлайн (серый) при наличии следующих проблем c настройкой.
* На устройстве установлена неправильная дата и время (от текущей даты). Соединение происходит по защищенному протоколу HTTPS, устройство не пропускает соединение если даты сертификата не соответствуют дате установленной на устройстве.
** Решение. Установите текущую дату и время на устройстве.
* Убедитесь, что к провайдеру приложения (URL ссылки которую вбиваете) есть доступ из внутренней сети предприятия.
** Решение. На устройствах есть встроенный браузер, откройте ссылку (URL ссылки которую вбиваете) в браузере и убедитесь, что браузер откроет ссылку.
* Убедитесь, что на устройстве есть интернет соединение.
** Решение. Откройте настройки соединения и проверьте, что устройство получает проверку наличия интернет соединения.
На примере WebOS
 
[[Файл:Photo 2020-10-03 14-11-27.jpg|200px]]

====''' [WebOS 2/3/3.2/4.0/4.1/6] Отображается часть видеоролика на экране '''====
''Решение:'' Отключить режим видеостены в настройках устройства
Нажать на пульте настройки (кнопка с шестеренкой), выбрать EZ -> VideoWall -> Выключить
 
[[Файл:EzSettings.jpg|200px]] [[Файл:VideoWallOff.jpg|200px]]

====''' Почему телевизор с поддержкой разрешения UltraHD (4K UHD с разрешением 3840 × 2160) в карточки устройства в личном кабинете SmartPlayer показывает разрешение FullHD (1920x1080) '''====
На устройствах OrsayOS, TizenOS, WebOS интерфейс приложения всегда отрисовывается в разрешении FullHD (1920x1080). Покупая телевизор с возможностью проигрывания UltraHD контента, значит что внутренний плеер устройства поддерживает проигрывание видеоролика с разрешением 3840 × 2160 и нужным fps, но интерфейс приложения будет рассчитываться относительно параметров 1920x1080. Так как данные для карточки устройства берутся от операционной системы, они показываются 1920x1080, так как система отрисовывает интерфейс в 1920x1080.
===='''Проигрывание видеороликов без черных гэпов и других артефактов '''====
Проигрывание плейлиста без черных гэпов между видеороликами, является важнейшей функцией в DigitalSignage, в тоже время данная функция сильно зависит от прошивки устройства и реализации на разных платформах (даже в рамках одно ос) различаются.
Для всех проф. панелей (WenOS2/3.0/3.2/4, Orsay2/3, Tizen2.4/3.0/4.0) идеальным вариантом будет:
'''A'''. Один fps для всех роликов в плейлисте. Можно сделать плейлист 25,30,60 fps но все ролики должны быть такого fps. Если миксовать fps это может работать (зависит от прошивки), но рекомендуется подготовить ролики, чтобы был один fps.
Идеально: 30fps → 30fps → 30fps.
Неидеально: 30fps → 25fps → 30fps.
'''B'''. Одно разрешение видеороликов. Можно сделать плейлист из 1920x1080, 1280x720, 3840 × 2160, но все ролики должны быть одного разрешения. Если миксовать, скорее всего будут артефакты в виде черных гэпов, искажений изображений первого кадра.
Идеально: 1920х1080 → 1920х1080 → 1920х1080.
Критично: 1920х1080 → 1280х720 → 1920х1080.
'''C'''. Горизонтальная ориентация работает стабильней, в отличии от вертикальной. Можно запускать перевернутый контент на 90 градусов, в вертикальном режиме, визуально будет достигнут вертикальный режим проигрывания. Для переворота видеоролика можно использовать встроенный видеоредактор в личном кабинете SmartPlayer.
Идеально: горизонтальная (landscape) ориентация.
Неидеально: вертикальная (portrait) ориентация.
'''D'''. Плейлист который проигрывается должен состоять только из видеороликов. Это обусловлено тем, что у проф. панелей отдельный API для проигрывания в бесшовном режиме. Если нужно проиграть картинку, её можно конвертировать в видеоролик используя встроенный видеоредактор в личном кабинете, при конвертировании в видеоролик картинке можно указать продолжительность.
Идеально: видео->видео->видео.
Неидеально: видео->картинка->видео.
'''E'''. Все видеофайлы в плейлисте должны использовать один контейнер и один кодек.
Идеально: mp4_H264->mp4_H264->mp4_H264.
Неидеально: mp4_H2645->mp4_H264->mp4_H264.

==== '''[WEBOS] Приложение не устанавливается (ERROR, FAILED TRY AGAIN)''' ====
[[Файл:Webos installation failed.png|мини|альт=Webos installation failed]]
Самая вероятная причина - невозможность получить доступ к установочному файлу приложения
''Решение: ''
*Проверить правильность ссылки в поле Fully Qualified Domain Name.
*Если используется https, проверить правильность даты и времени на устройстве (необходимо для установки SSL соединения)
*Если используется https, проверить валидность сертификата SSL, проф. панели LG с WebOS "из коробки" поддерживают сертификаты не от всех поставщиков и могут не поддерживать самоподписанные сертификаты. Мы рекомендуем использовать сертификаты от GlobalSign
=== '''Windows''' ===
====''' Проблема со снятием скриншотов на локальных серверах '''====
{{Note|Данную проблему можно решить несколькими способами|warn}}
''Решение 1:'' 
При использовании HTTPS-сервера приложение на Windows не может установить соединение, так как в его хранилище отсутствует корневой сертификат, которым подписан сертификат сервера. На сервере сертификат присутствует, но на стороне клиента (в приложении) он не установлен. Это приводит к тому, что при попытке снятия скриншота приложение запрашивает сертификат и длительное время ожидает ответа при отсутствии глобальной сети. При сборке приложения необходимо включить «Глобальный сертификат», который установлен на сервере в дистрибутив в рамках процедуры развёртывания. 
''Решение 2:'' 
Установка пакета OpenSSL: Win64OpenSSL_Light-3_6_0.exe
</translate>