SmartPlayer - Вклад [ru]

"Детектор" черного экрана (Системный администратор)

2023-09-26T12:08:11Z

T.Tagiev: /* Алгоритм действия */

<languages/>
<translate>

== '''Описание ситуации''' ==
У пользователей появляются проблемы с трансляциями на устройствах. При воспроизведении контента на некоторых устройствах выводится «чёрный» экран. Эту проблему можно наблюдать в личном кабинете пользователя или на месте нахождения устройства.
</translate>
<translate>

== '''Причина''' ==
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать, но отображает только "Чёрный" экран. 
Эта ситуация возникает из-за различных ошибок при запуске трансляции. Причины таких проблем могут быть разными, и их очень сложно обнаружить. 
В качестве причины может выступать любое действие:
* Пользователь загружает видео, но это видео использует неподдерживаемый системой кодек. Тогда видео просто не может запуститься и показывает черный экран. Бывает проблемы, связанные с клиентским приложением (баг), и из-за этого начинаются проблемы с трансляцией.
* Пока есть наличие постоянной, стабильной сети – все работает отлично. Как только устройство теряет доступ к сети (по любой причине) – трансляция прерывается и появляется чёрный экран.
[[File:Пример черного экрана в ЛК.png|thumb|Пример отображения "Чёрного" экрана в личном кабинете пользователя|500px]]
=== '''Систематичность проблемы''' ===
"Чёрный" экран очень несложно отследить и подтвердить визуально. В этом случае хорошо помогает личный кабинет. 
Проблема ситуации в том, что проблема не несет в себе систематичности по времени и может появляться как раз в месяц, так и раз в несколько дней или часов. 
Период появления черного экрана определяется опытным путём и подтверждает по факту у точки. Поиск причины проблемы перекладывается на плечи технических специалистов.
</translate>
<translate>

== '''Концепт решения''' ==
Для решения проблемы было решено создать автоматический «Детектор» черного экрана. Он уведомляет о проблемах с контентом на устройстве и оповещает о случившейся ситуации в личном кабинете. 
{{Note|Данный функционал не доступен пользователю в личном кабинете. Его необходимо включать отдельно.|warn}}
=== '''Принцип действия''' ===
У каждого клиента/компании есть свой ID связанный с сервером. ID указан в личном кабинете и к нему привязываются все устройства компании. 
После запуска функционала сервер с определенным промежутком по времени отправляет на устройства «ивент». 
Запуская «ивент» устройство с помощью детектора проверяет наличие "черного" экрана, делая скриншот во время запуска. 
После запуска детектора возможно получить два определенных результата:
* После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
* После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент". 
'''Промежуток для повторной отправки "ивента" по умолчанию составляет 10 секунд.''' 
Если же и во второй раз отправляется скриншот "чёрного" экрана то со стороны сервера отправляется письмо на почту, о наличии проблемы.
{{Note|Указанная почта должна быть привязана к серверу.|warn}}

=== '''Подготовка ''' ===
Системный администратор должен настроить серверное приложение по двум параметрам:
* Запуск и функционирование детектора "чёрного" экрана
* Настройка отправки письма с ошибкой на почту
=== '''Принцип действия ''' ===
Если серверное приложение обнаружило черный экран, оно отправляет на почту письмо.
Итогом этой проверки станет сообщение на почту с оповещение о проблеме. 
Для подтверждения проверки работоспособности функционала через личный кабинет системный администратор может поставить черную картинку. Сервер продолжает отправляет оповещения пока проблема не будет исправлена или же пока не будет выключен функционал. 
Впоследствии системный администратор должен принять меры для устранения проблемы.
=== '''Тонкости и нюансы при работе функционала''' ===
1. Для правильного работы необходимо чтобы placeholder с белой точкой воспринимался как черный экран. Поэтому используется не абсолютная проверка. 
2. При наличии root прав на устройстве – детектор работает нормально. Но, если, на устройстве нет root прав, детектор не сможет сделать скриншот. 
'''Исключения:''' 
Скриншот доступен:
* Если приложение подписано «подписью разработчика» (уровень прав – Signage).
* Некоторые устройства (Vestel, Hikvision, Phillips) могут сделать скриншот без root прав из-за особенностей прошивки.
3. Если пользователь попробует сделать скриншот без root прав, то создается «пустой скриншот» с надписью «Идёт воспроизведение видео. Отсутствуют права для снятия скриншота». 
4. Информация от сервера к разработчикам отправляется через "ивент". Внутри отправленного «ивента» сервер ждет callback от разработчиков. 
5. Тайм – аут “Callback” по умолчанию на сервере составляет – 30 секунд.
</translate>
<translate>

== '''Реализация''' ==
=== '''Активация''' ===
По умолчанию детектор для всех компаний отключен на сервере, так как создает на него слишком большую нагрузку.
{{Note|Включается детектор только по запросу со стороны компании, у которой появилась проблема с чёрным экраном.|warn}}
=== '''Алгоритм действия''' ===
Вся работа будет вестись в два этапа. 
'''Первый этап - это запуск самого детектора'''. 
При запуске детектора нужно использовать id компании, который указан в личном кабинете. [[File:ID компании.png|thumb|Расположение ID компании в личном кабинете |300px]]
Для этого нужно зайти в профиль и развернуть подробную информацию о пользователе.
Системному администратору нужно подключиться на сервер, через '''Command Line Interface (CLI)'''. 
<div style="border: 1px solid #888; padding: 10px; margin: 10px 0; background-color: #f9f9f9;">
При включении CLI сервер получает определенные данные для настройки: 
Это:
* ID компании, для которой включаем детектор
* Можно передать платформу (или несколько платформ), для которой необходимо запустить мониторинг.
Например: передаем параметр "ANDROID" и мониторинг включается только для устройств "ANDROID".
* E-mail адрес или несколько адресов на которые должно отправляться уведомление о нештатной ситуации
* Указанное время хранения скриншотов (по умолчанию 3 дня)
</div>
Далее нужно перейти в серверное приложение и выполнить команду:
<code>docker exec -it smartplayer_backend_1 bash</code>
[[File:Команда docker.png|thumb|Команда"docker exec -it smartplayer_backend_1 bash" |300px]]
На этом этапе попадаем в нашем контейнере с серверным приложением. 
Следующей выполняем команду:
<code>./cli.js company enable-screen-monitor </code>[[File:Enable screen monitor.png|thumb|Команда"./cli.js company enable-screen-monitor" |300px]]
После очередного этапа система выдает вот такую строку:
Системное сообщение: <code>Input company ID and press Enter</code>[[File:Системное сообщение.png|thumb|Системное сообщение "Input company ID and press Enter:" |300px]]
Выполненная команда отобразит строку в которой просят ввести Id компании. 
После ввода ID появляется запрос на мониторинг всех платформ компании. В данном случае выбираем «ДА/Y»
[[File:Мониторинг всех платформ.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]
В последствии консоль потребует указать e-mail на который будут приходить оповещения о проблемах.
Это делается в строке: 
<code>Input_email and press enter</code>
[[File:Строка почты.png|thumb|Команда"Input_email_and_press_Enter:" |300px]]
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
Также можно указать интервал с которым будут приходить скриншоты (например 1 минута). Строка выглядит так: 
<code>Input check interval in minutes (m) or seconds (s) and press "Enter"</code> 
[[File:Интервал отправки сообщения.png|thumb|Здесь нужно указать время в минутах с префиксом (m) или в секундах с префиксом (S) |300px]]
Далее указываем время либо в секундах с префиксом (s) после числового значения, либо в минутах с префиксом (m) и применяем эту настройку через "Enter". Итогом всех манипуляций будет статус: 
<code>Company screen monitoring enabled</code> - выделена зеленым цветом. Это значит что детектор черного экрана запущен.
[[File:Запуск детектора.png|thumb|Оповещение о запуске Детектора выделено зелёным цветом |300px]]
Проверить настроенные уведомления можно с помощью команды <code>./cli.js company show-screen-monitor</code>
'''Отключить детектор черных экранов:''' <code>./cli.js company disable-screen-monitor</code>

=== '''Уведомления на почту''' ===
Второй этап настройка уведомления, которые приходят на почту. Настройка уведомления подробно прописана в отдельной инструкции [[Настройка отправки писем через серверное приложение SmartPlayer]]. 
{{Note|При получении сообщения о проблеме на почту, невозможно напрямую из этого уведомления сделать какие либо действия. К примеру «Перезагрузка экрана» или "Остановка трансляции" недоступна.|warn}}
=== '''Предфинальные действия''' ===
В зависимости от результата, системный администратор сможет корректно определить причину и предпринять конкретные действия для устранения ситуации. Если у него не получается решить проблему внутри своей среды или же проблема на нашей стороне, он должен обратиться к команде SmartPlayer. 
Это вариант удобен для всех. Так как поможет решить проблемы если они и с нашей стороны (например баг приложения), так и со стороны пользователя (например пользователь неправильно создал трансляцию).
=== '''Важная информация о которой не стоит забывать ''' ===
{{Note|'''Для перезапуска трансляции надо зайти в личный кабинет и перезапустить все вручную'''|warn}}
{{Note|'''Детектор черного экрана на данный момент работает только на Android версии 1.63.1'''|warn}}
</translate>
<translate>

== '''Итоговый результат''' ==
Системный администратор со стороны клиента начнёт решать проблему запустив и настроив функционал детектора.
Наличие детектора позволяет контролировать проблемную ситуацию с "Чёрным" экраном и оперативно работать с её исправлением. Это актуально как для нас, так и для системных администраторов со стороны пользователя.
Команда SmartPlayer и команда сотрудников со стороны клиента смогут оперативно взаимодействовать для решения проблемы. 
Рядовой пользователь минимизирует негативный опыт взаимодействия с нашим продуктом.
</translate>

"Детектор" черного экрана (Системный администратор)

2023-08-16T17:00:26Z

T.Tagiev: /* Алгоритм действия */

<languages/>
<translate>

== '''Описание ситуации''' ==
У пользователей появляются проблемы с трансляциями на устройствах. При воспроизведении контента на некоторых устройствах выводится «чёрный» экран. Эту проблему можно наблюдать в личном кабинете пользователя или на месте нахождения устройства.
</translate>
<translate>

== '''Причина''' ==
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать, но отображает только "Чёрный" экран. 
Эта ситуация возникает из-за различных ошибок при запуске трансляции. Причины таких проблем могут быть разными, и их очень сложно обнаружить. 
В качестве причины может выступать любое действие:
* Пользователь загружает видео, но это видео использует неподдерживаемый системой кодек. Тогда видео просто не может запуститься и показывает черный экран. Бывает проблемы, связанные с клиентским приложением (баг), и из-за этого начинаются проблемы с трансляцией.
* Пока есть наличие постоянной, стабильной сети – все работает отлично. Как только устройство теряет доступ к сети (по любой причине) – трансляция прерывается и появляется чёрный экран.
[[File:Пример черного экрана в ЛК.png|thumb|Пример отображения "Чёрного" экрана в личном кабинете пользователя|500px]]
=== '''Систематичность проблемы''' ===
"Чёрный" экран очень несложно отследить и подтвердить визуально. В этом случае хорошо помогает личный кабинет. 
Проблема ситуации в том, что он не несет в себе систематичности по времени и может появляться как раз в месяц, так и раз в несколько дней или часов. 
Период появления черного экрана определяется опытным путём и подтверждает по факту у точки. Поиск причины проблемы перекладывается на плечи технических специалистов.
</translate>
<translate>

== '''Концепт решения''' ==
Для решения проблемы было решено создать автоматический «Детектор» черного экрана. Он уведомляет о проблемах с контентом на устройстве и оповещает о случившейся ситуации в личном кабинете. 
{{Note|Данный функционал не доступен пользователю в личном кабинете. Его необходимо включать отдельно.|warn}}
=== '''Принцип действия''' ===
У каждого клиента/компании есть свой ID связанный с сервером. ID указан в личном кабинете и к нему привязываются все устройства компании. 
После запуска функционала сервер с определенным промежутком по времени отправляет на устройства «ивент». 
Запуская «ивент» устройство с помощью детектора проверяет наличие "черного" экрана, делая скриншот во время запуска. 
После запуска детектора возможно получить два определенных результата:
* После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
* После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент". 
'''Промежуток для повторной отправки "ивента" составляет 10 секунд.''' 
Если же и во второй раз отправляется черный экран, то со стороны сервера отправляется письмо на почту, о наличии проблемы.
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
=== '''Подготовка ''' ===
Системный администратор должен настроить серверное приложение по двум параметрам:
* Запуск и функционирование детектора "чёрного" экрана
* Настройка отправки письма с ошибкой на почту
=== '''Принцип действия ''' ===
Если серверное приложение обнаружило черный экран, оно отправляет на почту письмо.
Итогом этой проверки станет сообщение на почту с оповещение о проблеме. 
Для подтверждения проверки работоспособности функционала через личный кабинет системный администратор может поставить черную картинку. Сервер продолжает отправляет оповещения пока проблема не будет исправлена или же пока не будет выключен функционал. 
Впоследствии системный администратор должен принять меры для устранения проблемы.
=== '''Тонкости и нюансы при работе функционала''' ===
1. Для правильного работы необходимо чтобы placeholder с белой точкой воспринимался как черный экран. Поэтому используется не абсолютная проверка. 
2. При наличии root прав на устройстве – детектор работает нормально. Но, если, на устройстве нет root прав, детектор не сможет сделать скриншот. 
'''Исключения:''' 
Скриншот доступен:
* Если приложение подписано «подписью разработчика» (уровень прав – Signage).
* Некоторые устройства (Vestel, Hikvision, Phillips) могут сделать скриншот без root прав из-за особенностей прошивки.
3. Если пользователь попробует сделать скриншот без root прав, то создается «пустой скриншот» с надписью «Идёт воспроизведение видео. Отсутствуют права для снятия скриншота». 
4. Информация от сервера к разработчикам отправляется через "ивент". Внутри отправленного «ивента» сервер ждет callback от разработчиков. 
5. Тайм – аут “Callback” по умолчанию на сервере составляет – 30 секунд.
</translate>
<translate>

== '''Реализация''' ==
=== '''Активация''' ===
По умолчанию детектор для всех компаний отключен на сервере, так как создает на него слишком большую нагрузку.
{{Note|Включается детектор только по запросу со стороны компании, у которой появилась проблема с чёрным экраном.|warn}}
=== '''Алгоритм действия''' ===
Вся работа будет вестись в два этапа. 
'''Первый этап - это запуск самого детектора'''. 
При запуске детектора нужно использовать id компании, который указан в личном кабинете. [[File:ID компании.png|thumb|Расположение ID компании в личном кабинете |300px]]
Для этого нужно зайти в профиль и развернуть подробную информацию о пользователе.
Системному администратору нужно подключиться на сервер, через '''Command Line Interface (CLI)'''. 
<div style="border: 1px solid #888; padding: 10px; margin: 10px 0; background-color: #f9f9f9;">
При включении CLI сервер получает определенные данные для настройки: 
Это:
* ID компании, для которой включаем детектор
* Можно передать платформу (или несколько платформ), для которой необходимо запустить мониторинг.
Например: передаем параметр "ANDROID" и мониторинг включается только для устройств "ANDROID".
* E-mail адрес или несколько адресов на которые должно отправляться уведомление о нештатной ситуации
* Указанное время хранения скриншотов (по умолчанию 3 дня)
</div>
Далее нужно перейти в серверное приложение и выполнить команду:
<code>docker exec -it smartplayer_backend_1 bash</code>
[[File:Команда docker.png|thumb|Команда"docker exec -it smartplayer_backend_1 bash" |300px]]
На этом этапе попадаем в нашем контейнере с серверным приложением. 
Следующей выполняем команду:
<code>./cli.js company enable-screen-monitor </code>[[File:Enable screen monitor.png|thumb|Команда"./cli.js company enable-screen-monitor" |300px]]
После очередного этапа система выдает вот такую строку:
Системное сообщение: <code>Input company ID and press Enter</code>[[File:Системное сообщение.png|thumb|Системное сообщение "Input company ID and press Enter:" |300px]]
Выполненная команда отобразит строку в которой просят ввести Id компании. 
После ввода ID появляется запрос на мониторинг всех платформ компании. В данном случае выбираем «ДА/Y»
[[File:Мониторинг всех платформ.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]
В последствии консоль потребует указать e-mail на который будут приходить оповещения о проблемах.
Это делается в строке: 
<code>Input_email and press enter</code>
[[File:Строка почты.png|thumb|Команда"Input_email_and_press_Enter:" |300px]]
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
Также можно указать интервал с которым будут приходить скриншоты (например 1 минута). Строка выглядит так: 
<code>Input check interval in minutes (m) or seconds (s) and press "Enter"</code> 
[[File:Интервал отправки сообщения.png|thumb|Здесь нужно указать время в минутах с префиксом (m) или в секундах с префиксом (S) |300px]]
Далее указываем время либо в секундах с префиксом (s) после числового значения, либо в минутах с префиксом (m) и применяем эту настройку через "Enter". Итогом всех манипуляций будет статус: 
<code>Company screen monitoring enabled</code> - выделена зеленым цветом. Это значит что детектор черного экрана запущен.
[[File:Запуск детектора.png|thumb|Оповещение о запуске Детектора выделено зелёным цветом |300px]]
Проверить настроенные уведомления можно с помощью команды <code>./cli.js company show-screen-monitor</code>

=== '''Уведомления на почту''' ===
Второй этап настройка уведомления, которые приходят на почту. Настройка уведомления подробно прописана в отдельной инструкции [[Настройка отправки писем через серверное приложение SmartPlayer]]. 
{{Note|При получении сообщения о проблеме на почту, невозможно напрямую из этого уведомления сделать какие либо действия. К примеру «Перезагрузка экрана» или "Остановка трансляции" недоступна.|warn}}
=== '''Предфинальные действия''' ===
В зависимости от результата, системный администратор сможет корректно определить причину и предпринять конкретные действия для устранения ситуации. Если у него не получается решить проблему внутри своей среды или же проблема на нашей стороне, он должен обратиться к команде SmartPlayer. 
Это вариант удобен для всех. Так как поможет решить проблемы если они и с нашей стороны (например баг приложения), так и со стороны пользователя (например пользователь неправильно создал трансляцию).
=== '''Важная информация о которой не стоит забывать ''' ===
{{Note|'''Для перезапуска трансляции надо зайти в личный кабинет и перезапустить все вручную'''|warn}}
{{Note|'''Детектор черного экрана на данный момент работает только на Android версии 1.63.1'''|warn}}
</translate>
<translate>

== '''Итоговый результат''' ==
Системный администратор со стороны клиента сможет запустить и настроить функционал детектора и начать решать проблему.
Наличие детектора позволяет контролировать проблемную ситуацию с "Чёрным" экраном и оперативно работать с её исправлением. Это актуально как для нас, так и для сотрудников клиента.
Команда SmartPlayer и команда сотрудников со стороны клиента смогут оперативно взаимодействовать для решения проблемы. 
Рядовой пользователь минимизирует негативный опыт взаимодействия с нашим продуктом.
</translate>

"Детектор" черного экрана (Системный администратор)

2023-08-15T06:17:37Z

T.Tagiev: /* Алгоритм действия */

<languages/>
<translate>

== '''Описание ситуации''' ==
У пользователей появляются проблемы с трансляциями на устройствах. При воспроизведении контента на некоторых устройствах выводится «чёрный» экран. Эту проблему можно наблюдать в личном кабинете пользователя или на месте нахождения устройства.
</translate>
<translate>

== '''Причина''' ==
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать, но отображает только "Чёрный" экран. 
Эта ситуация возникает из-за различных ошибок при запуске трансляции. Причины таких проблем могут быть разными, и их очень сложно обнаружить. 
В качестве причины может выступать любое действие:
* Пользователь загружает видео, но это видео использует неподдерживаемый системой кодек. Тогда видео просто не может запуститься и показывает черный экран. Бывает проблемы, связанные с клиентским приложением (баг), и из-за этого начинаются проблемы с трансляцией.
* Пока есть наличие постоянной, стабильной сети – все работает отлично. Как только устройство теряет доступ к сети (по любой причине) – трансляция прерывается и появляется чёрный экран.
[[File:Пример черного экрана в ЛК.png|thumb|Пример отображения "Чёрного" экрана в личном кабинете пользователя|500px]]
=== '''Систематичность проблемы''' ===
"Чёрный" экран очень несложно отследить и подтвердить визуально. В этом случае хорошо помогает личный кабинет. 
Проблема ситуации в том, что он не несет в себе систематичности по времени и может появляться как раз в месяц, так и раз в несколько дней или часов. 
Период появления черного экрана определяется опытным путём и подтверждает по факту у точки. Поиск причины проблемы перекладывается на плечи технических специалистов.
</translate>
<translate>

== '''Концепт решения''' ==
Для решения проблемы было решено создать автоматический «Детектор» черного экрана. Он уведомляет о проблемах с контентом на устройстве и оповещает о случившейся ситуации в личном кабинете. 
{{Note|Данный функционал не доступен пользователю в личном кабинете. Его необходимо включать отдельно.|warn}}
=== '''Принцип действия''' ===
У каждого клиента/компании есть свой ID связанный с сервером. ID указан в личном кабинете и к нему привязываются все устройства компании. 
После запуска функционала сервер с определенным промежутком по времени отправляет на устройства «ивент». 
Запуская «ивент» устройство с помощью детектора проверяет наличие "черного" экрана, делая скриншот во время запуска. 
После запуска детектора возможно получить два определенных результата:
* После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
* После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент". 
'''Промежуток для повторной отправки "ивента" составляет 10 секунд.''' 
Если же и во второй раз отправляется черный экран, то со стороны сервера отправляется письмо на почту, о наличии проблемы.
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
=== '''Подготовка ''' ===
Системный администратор должен настроить серверное приложение по двум параметрам:
* Запуск и функционирование детектора "чёрного" экрана
* Настройка отправки письма с ошибкой на почту
=== '''Принцип действия ''' ===
Если серверное приложение обнаружило черный экран, оно отправляет на почту письмо.
Итогом этой проверки станет сообщение на почту с оповещение о проблеме. 
Для подтверждения проверки работоспособности функционала через личный кабинет системный администратор может поставить черную картинку. Сервер продолжает отправляет оповещения пока проблема не будет исправлена или же пока не будет выключен функционал. 
Впоследствии системный администратор должен принять меры для устранения проблемы.
=== '''Тонкости и нюансы при работе функционала''' ===
1. Для правильного работы необходимо чтобы placeholder с белой точкой воспринимался как черный экран. Поэтому используется не абсолютная проверка. 
2. '''Актуально только при проигрывании видео.''' При наличии root прав на устройстве – детектор работает нормально. Но, если, на устройстве нет root прав, детектор не сможет сделать скриншот. 
'''Исключения:''' 
Скриншот доступен:
* Если приложение подписано «подписью разработчика» (уровень прав – Signage).
* Некоторые устройства (Vestel, Hikvision, Phillips) могут сделать скриншот без root прав из-за особенностей прошивки.
3. Если пользователь попробует сделать скриншот без root прав, то создается «пустой скриншот» с надписью «Идёт воспроизведение видео. Отсутствуют права для снятия скриншота». 
4. Информация от сервера к разработчикам отправляется через "ивент". Внутри отправленного «ивента» сервер ждет callback от разработчиков. 
5. Тайм – аут “Callback” по умолчанию на сервере составляет – 30 секунд.
</translate>
<translate>

== '''Реализация''' ==
=== '''Активация''' ===
По умолчанию детектор для всех компаний отключен на сервере, так как создает на него слишком большую нагрузку.
{{Note|Включается детектор только по запросу со стороны компании, у которой появилась проблема с чёрным экраном.|warn}}
=== '''Алгоритм действия''' ===
Вся работа будет вестись в два этапа. 
'''Первый этап - это запуск самого детектора'''. 
При запуске детектора нужно использовать id компании, который указан в личном кабинете. [[File:ID компании.png|thumb|Расположение ID компании в личном кабинете |300px]]
Для этого нужно зайти в профиль и развернуть подробную информацию о пользователе.
Системному администратору нужно подключиться на сервер, через '''Command Line Interface (CLI)'''. 
<div style="border: 1px solid #888; padding: 10px; margin: 10px 0; background-color: #f9f9f9;">
При включении CLI сервер получает определенные данные для настройки: 
Это:
* ID компании, для которой включаем детектор
* Можно передать платформу (или несколько платформ), для которой необходимо запустить мониторинг.
Например: передаем параметр "ANDROID" и мониторинг включается только для устройств "ANDROID".
* E-mail адрес или несколько адресов на которые должно отправляться уведомление о нештатной ситуации
* Указанное время хранения скриншотов (по умолчанию 3 дня)
</div>
Далее нужно перейти в серверное приложение и выполнить команду:
<code>docker exec -it smartplayer_backend_1 bash</code>
[[File:Команда docker.png|thumb|Команда"docker exec -it smartplayer_backend_1 bash" |300px]]
На этом этапе попадаем в нашем контейнере с серверным приложением. 
Следующей выполняем команду:
<code>./cli.js company enable-screen-monitor </code>[[File:Enable screen monitor.png|thumb|Команда"./cli.js company enable-screen-monitor" |300px]]
После очередного этапа система выдает вот такую строку:
Системное сообщение: <code>Input company ID and press Enter</code>[[File:Системное сообщение.png|thumb|Системное сообщение "Input company ID and press Enter:" |300px]]
Выполненная команда отобразит строку в которой просят ввести Id компании. 
После ввода ID появляется запрос на мониторинг всех платформ компании. В данном случае выбираем «ДА/Y»
[[File:Мониторинг всех платформ.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]
В последствии консоль потребует указать e-mail на который будут приходить оповещения о проблемах.
Это делается в строке: 
<code>Input_email and press enter</code>
[[File:Строка почты.png|thumb|Команда"Input_email_and_press_Enter:" |300px]]
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
Также можно указать интервал с которым будут приходить скриншоты (например 1 минута). Строка выглядит так: 
<code>Input check interval in minutes (m) or seconds (s) and press "Enter"</code> 
[[File:Интервал отправки сообщения.png|thumb|Здесь нужно указать время в минутах с префиксом (m) или в секундах с префиксом (S) |300px]]
Далее указываем время либо в секундах с префиксом (s) после числового значения, либо в минутах с префиксом (m) и применяем эту настройку через "Enter". Итогом всех манипуляций будет статус: 
<code>Company screen monitoring enabled</code> - выделена зеленым цветом. Это значит что детектор черного экрана запущен.
[[File:Запуск детектора.png|thumb|Оповещение о запуске Детектора выделено зелёным цветом |300px]]

=== '''Уведомления на почту''' ===
Второй этап настройка уведомления, которые приходят на почту. Настройка уведомления подробно прописана в отдельной инструкции [[Настройка отправки писем через серверное приложение SmartPlayer]]. 
{{Note|При получении сообщения о проблеме на почту, невозможно напрямую из этого уведомления сделать какие либо действия. К примеру «Перезагрузка экрана» или "Остановка трансляции" недоступна.|warn}}
=== '''Предфинальные действия''' ===
В зависимости от результата, системный администратор сможет корректно определить причину и предпринять конкретные действия для устранения ситуации. Если у него не получается решить проблему внутри своей среды или же проблема на нашей стороне, он должен обратиться к команде SmartPlayer. 
Это вариант удобен для всех. Так как поможет решить проблемы если они и с нашей стороны (например баг приложения), так и со стороны пользователя (например пользователь неправильно создал трансляцию).
=== '''Важная информация о которой не стоит забывать ''' ===
{{Note|'''Для перезапуска трансляции надо зайти в личный кабинет и перезапустить все вручную'''|warn}}
{{Note|'''Детектор черного экрана на данный момент работает только на Android версии 1.63.1'''|warn}}
</translate>
<translate>

== '''Итоговый результат''' ==
Системный администратор со стороны клиента сможет запустить и настроить функционал детектора и начать решать проблему.
Наличие детектора позволяет контролировать проблемную ситуацию с "Чёрным" экраном и оперативно работать с её исправлением. Это актуально как для нас, так и для сотрудников клиента.
Команда SmartPlayer и команда сотрудников со стороны клиента смогут оперативно взаимодействовать для решения проблемы. 
Рядовой пользователь минимизирует негативный опыт взаимодействия с нашим продуктом.
</translate>

FAQ

2023-08-07T06:18:20Z

T.Tagiev:

<languages/>
<translate>

*Q: Можно ли установить серверную часть Smartplayer внутри сети организации?
*A: Да, у нас есть такая опция.


*Q: На какие платформы можно поставить серверную часть Smartplayer?
*A: Нативно на Linux или Windows Server. Также можно использовать Docker или VMWare ESXi.


*Q: Работает ли клиентское приложение в случае отсутствия соединения с интернетом?
*A: Безусловно. Все клиентские приложения SmartPlayer сохраняют весь контент, расписания, трансляции, статистику и т.д. во внутреннюю память. Соединение с сетью необходимо только для обновления контента и выгрузки статистики. Хотя эти действия также могут быть выполнены с помощью флешки, в случае если на объекте установки нет интернета.


*Q: Поддерживаете ли вы работу с фоновой музыкой?
*A: Поддерживаем. В том числе и используя проф. дисплеи. Т.е. вы можете выводить видео контент и фоновую музыку с одного устройства.


*Q: Какие типы контента поддерживает SmartPlayer?
*A: В общем случае: изображения (JPG, PNG), видео (MP4) частота кадров 25, кодек h264, HTML5 контент (сайты и offline виджеты), фоновую музыку (MP3), потоковое видео (RTP). В случае Windows/Linux/Android клиентов приложение поддерживает все форматы видео для которых есть кодеки в системе. Если вам необходим конкретный формат файлов, то вы можете написать нам и мы проверим работоспособность и производительность системы с этим контентом.


*Q: Где взять ссылки на клиентские приложения?
*A: Во вкладке Дистрибутивы в Личном Кабинете. Если вы не нашли необходимого вам дистрибутива, то обратитесь к вашему менеджеру в SmartPlayer или напишите на почту tech@smartplayer.org


*Q: Как узнать версию системы?
*A: Версию клиентского приложения для конкретного устройства можно посмотреть на вкладке [[Устройства]], выбрав конкретное устройство и нажав на пункт информация в [[панель управления]]. Версию Smart Manager (система управления). Можно посмотреть в разделе [[Настройки]] внизу страницы.


*Q: Как выйти из режима киоска на устройстве?
*A: Во вкладке устройства. Выберите нужно устройство (Windows или Android). Нажмите на пункт "Настройки". Далее переведите настройку "Режим киоска" в положение "Выключить". Также для каждой версии существует магическая комбинация, чтобы отключить режим непосредственно с устройства.


*Q: Можно ли управлять телевизором, подключенным к плееру через HDMI CEC, включать, выключать, регулировать громкость и другие общие функции?
*A: На текущий момент нет, но данный функционал есть в нашем RoadMap и будет реализован в ближайшее время.

*Q: Можно ли включить устройство удаленно по сети
*A: Можно, но есть ограничения: [[WakeOnLan|Включение устройство по сети]] - включение устройства, из выключенного состояния по сетевой технологии WakeOnLan
</translate>

Integrations

2023-07-26T04:42:12Z

T.Tagiev:

<languages/>
<translate>

В данном разделе представлены '''не все''' возможные прошивки производителей, если какой-то модели не хватает свяжитесь с нами по [mailto:support@smartplayer.org support@smartplayer.org] или через менеджера проекта. Вы можете установить ПО SmartPlayer на платформу производителей, даже если тут нет прошивки под конкретную модель. Установка актуальных прошивок является хорошей практикой при запуске проекта, но не является критично обязательной. В редких случаях (на старых прошивок), ПО может не запуститься, тогда следует обновить прошивку.


{| class="wikitable"
|colspan="6" style="padding: 20px" | <h2>[[File:samsung-logo.png|100px]] Актуальный список прошивок Samsung</h2>
|-
|style="padding: 10px" |Модель
|style="padding: 10px" |Платформа
|style="padding: 10px" |ID платформы
|style="padding: 10px" |Прошивка не ниже
|style="padding: 10px" |Ссылка
|-
|QHB(43/50/55/65/75), QMB (43/50/55/65/75), QBB (43/50/55/65/75), QMB-N (65), QBB-N (55/65/75), QMB-T (43/55), OHB (24), OHB-S (46)
|Tizen
|SSSP 10
|1090.2
|[https://firmwaries.hb.bizmrg.com/Samsung/1675225903823_S-PTMWWC_1090.2_USB.zip ссылка]
|-
|-
|QMN/QBN/QEN/OMN/OHN/
OMN-D/OHN-D/QMR/QBR/QBR-N/SHR
|Tizen 4.0
|SSSP 6
|2390.0
|[https://firmwaries.hb.bizmrg.com/Samsung/1675659043379_T-KTM2ELAKUC-2390.0_USB.zip ссылка]
|-
|-
|QMH/QHH/QBH/QBH-N/DBJ
|Tizen 3.0
|SSSP 5
|2140.2
|[https://hb.bizmrg.com/firmwaries/Samsung/QMH_QHH_QBH_QBH-N_DBJ_Main_WW_T-KTMLAKUC_2140.2_USB.zip ссылка]
|-
|PMF/PHF/PMH
|Tizen 2.4
|SSSP 4
|2160.1
|[https://firmwaries.hb.bizmrg.com/Samsung/1677050420404_T-HKMLAKUC-2160.1_USB.zip ссылка]
|-
|SBB-SSF
|Tizen 2.4
|SSSP 4
|2090.2
|[https://firmwaries.hb.bizmrg.com/Samsung/1622594416285_TB-HMSCFDWWC-2090.2_USB.zip ссылка]
|-
|-
|DBE/DME/DHE
|Orsay
|SSSP 3
|1047.0
|[https://hb.bizmrg.com/firmwaries/Samsung/DBE_DME_DHE_UDE-P_DME-BR_Main_T-GFSLE2AKUC_1047.0_USB.zip ссылка]
|-
|-
|SHF
|Orsay
|SSSP 3
|1015.0
|[https://hb.bizmrg.com/firmwaries/Samsung/SHF_Main_WW_T-GFSSHFAKUC_1015.0_USB.zip ссылка]
|-
|DB10D
|Orsay
|SSSP 2
|1018.1
|[https://hb.bizmrg.com/firmwaries/Samsung/DB10D_WW(except%20N.America,Korea)Main_T-GFSLD1DWWC_1018.1_USB.zip ссылка]
|-
|-
|DB22D
|Orsay
|SSSP 2
|1047.0
|[https://hb.bizmrg.com/firmwaries/Samsung/DBD(22)_WW(except%20N.America,Korea)_Main_T-GFSLDDWWC_1047.0_USB.zip ссылка]
|-
|DBD
|Orsay
|SSSP 2
|1047.0
|[https://hb.bizmrg.com/firmwaries/Samsung/DBD(32,40,48,55)_DMD(32)_DM(32)DS_DSD(32)_WW(except%20N.America,Korea)_Main_T-GFSLDDWWC_1047.0_USB.zip ссылка]
|-
|-
|OMD(46,55.75)/UDDP(46)
|Orsay
|SSSP 2
|1051.0
|[https://firmwaries.hb.bizmrg.com/Samsung/OMD(46,55.75)_UDDP(46)_WW(except%20N.America,Korea)Main_T-GFSLDWWC_1051.0_USB.zip ссылка]
|-
|-
|DMD/DSD(40,48,55,65,75)/DHD(40,48,55)/UED
|Orsay
|SSSP 2
|1051.0
|[https://hb.bizmrg.com/firmwaries/Samsung/DMD_DSD(40,48,55,65,75)_DHD(40,48,55)_UED_WW(except%20N.America,Korea)Main_T-GFSLDWWC_1051.0_USB.zip ссылка]
|-
|UM46N-E
|colspan="2"|Панель без SystemOnChip для запуска необходим внешний плеер
|colspan="2"|[https://hb.bizmrg.com/firmwaries/Samsung/L-UDEMWWAC-1030.0.bin Эта прошивка для калибровки видеостен]
|-
|}


{| class="wikitable"
|colspan="6" style="padding: 20px" | <h2>[[File:lg-logo.png|80px]] Актуальный список прошивок LG</h2>
|-
|style="padding: 10px" |Модель
|style="padding: 10px" |Платформа
|style="padding: 10px" |ID платформы
|style="padding: 10px" |Прошивка не ниже
|style="padding: 10px" |Ссылка
|-
|colspan="6" style="padding: 15px" align="center"|WebOS 4.1
|-
|-
|22SM3G, 43/49/55/65UH5F, 49/55/65UH7F, 43/50/55/65/75/86UL3G, 43/49/55/65UM3DF, 43/49/55/65/75/86/98UM3DG, 43/49/55/65UM3F
|WebOS
|4.1
| 03.24.20
|[https://firmwaries.hb.bizmrg.com/LG/22SM3G_UMDF_UH5F_UH7F_UL3G_03.24.20.epk ссылка]
|-
|colspan="6" style="padding: 15px" align="center"|WebOS 4.0
|-
|-
|86BH5F, 88BH7F, 88BH7G
|WebOS
|4.0
| 04.54.10
|[https://firmwaries.hb.bizmrg.com/LG/88BH7F_04.54.10.epk ссылка]
|-
|43/49/55SH7E, 32/43/49/55SM5KE, 49/55/65/75/86/98UH5E, 75/86/98UH5F, 86UH5PE, 75/86/98UM3E, 98UM3F, WP400/WP401/WP402
|WebOS
|4.0
| 04.11.40
|[https://firmwaries.hb.bizmrg.com/LG/SH7E_SM5KE_UH5E_WP400_04.11.40.epk ссылка]
|-
|49/55VH7E,
49/55VM5E
|WebOS
|4.0
| 03.04.10
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS4.0_Signage/VH7E/VH7E_VM5E_03.04.10.epk ссылка]
|-
|WP400
|WebOS
|4.0
| 03.20.70
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS4.0_Signage/WP400/WP400_03.20.70.epk ссылка]
|-
|55XE4F
|WebOS
|4.0
| 4.21.50
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS4.0_Signage/XE4F/55XE4F_4.21.50.epk ссылка]
|-
|colspan="6" style="padding: 15px" align="center"|WebOS 3.2 (3.0+)
|-
|-
|55EF5E
|WebOS
|3.2 (3.0+)
| 4.30.33
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/55EF5E/55EF5E_4.30.33.epk ссылка]
|-
|55EG5CD
|WebOS
|3.2 (3.0+)
| 04.02.20
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/SM5(K)D_EG5CD/SM5D_EJ5D_EG5CD-04.02.20.epk ссылка]
|-
|55EG5CE
|WebOS
|3.2 (3.0+)
| 4.31.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/55EG5CE/55EG5CE%20_4.31.30.epk ссылка]
|-
|55EJ5D
|WebOS
|3.2 (3.0+)
| 04.02.20
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/SM5(K)D_EG5CD/SM5D_EJ5D_EG5CD-04.02.20.epk ссылка]
|-
|55EJ5E
|WebOS
|3.2 (3.0+)
| 4.30.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/55EJ5E/55EJ5E_4.30.30.epk ссылка]
|-
|65EV5E/65EJ5E
|WebOS
|3.2 (3.0+)
| 04.30.11
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/65EV5E_EJ5E/65EV5E_EJ5E_04.30.11.epk ссылка]
|-
|32/43/49/55/65SM5D,
32/43/49/55/65SM5KD
|WebOS
|3.2 (3.0+)
| 4.04.82
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/SM5(K)D_EG5CD/SM5KD_4.04.82.epk ссылка]
|-
|32/43/49/55 TA3E
|WebOS
|3.2 (3.0+)
| 04.10.40
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/TA3E/TA3E_04.10.40.epk ссылка]
|-
|86TR3D, 86TR3E,
55/65/75TC3D
|WebOS
|3.2 (3.0+)
| 03.80.40
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/86TR3D/86TR3D_TC3D_03.80.40.epk ссылка]
|-
|55SVH7E
|WebOS
|3.2 (3.0+)
| 4.40.70
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/55SVH7E/55SVH7E_4.40.70.epk ссылка]
|-
|49VL5D
|WebOS
|3.2 (3.0+)
| 3.30.80
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/49VL5D/49VL5D_3.30.80.epk ссылка]
|-
|55VX1D
|WebOS
|3.2 (3.0+)
| 3.30.70
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/5VX1D/5VX1D_3.30.70.epk ссылка]
|-
|WP320
|WebOS
|3.2 (3.0+)
| 3.50.90
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.2_Signage/webOS_Box/WP320_3.50.90.epk ссылка]
|-
|colspan="6" style="padding: 15px" align="center"|WebOS 3.0
|-
|-
|65EE5PC
|WebOS
|3.0
| 03.10.21
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/65EE5PC/65EE5PC_03.10.21.epk ссылка]
|-
|55EF5C, 55EV5C
|WebOS
|3.0
| 03.71.20
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/55EF5C_55EV5C/55EF5C_55EV5C_03.71.20.epk ссылка]
|-
|55EH5C
|WebOS
|3.0
| 03.00.15
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/EH5C/EH5C_03.00.15.epk ссылка]
|-
|55EJ5C
|WebOS
|3.0
| 03.30.67
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/EJ5C/EJ5C_03.30.67.epk ссылка]
|-
|65EV5C
|WebOS
|3.0
| 03.12.90
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/65EV5C/65EV5C_03.12.90.epk ссылка]
|-

|42/49/55LS73C;
42/49/55LS75C;
42/49/55LS73D
|WebOS
|3.0
| 04.74.20
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/LS73C_LS73D_LS75C/LS73C_LS73D_LS75C_04.74.20.epk ссылка]
|-
|42/49/55LS75C
|WebOS
|3.0
| 04.74.20
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/LS73C_LS73D_LS75C/LS73C_LS73D_LS75C_04.74.20.epk ссылка]
|-
|42/49/55LS73D
|WebOS
|3.0
| 04.74.20
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/LS73C_LS73D_LS75C/LS73C_LS73D_LS75C_04.74.20.epk ссылка]
|-
|43/49/55SM3C; 32/43/49/55/65SM5C;
32/43/49/55/65SM5KC
|WebOS
|3.0
| 04.74.50
|[http://signup.lge.com//Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/SM5C/4.74.50/SM5C_UH5C_04.74.50.epk ссылка]
|-
|XS4F-BH
|WebOS
|3.0
| 05.35.43
|[https://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XS4F/XS4F_5.35.43.epk ссылка]
|-
|55TC3CD
|WebOS
|3.0
| 5.20.40
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/55TC3CD/55TC3CD_5.20.40.epk ссылка]
|-
|49/55/65UH5C
|WebOS
|3.0
| 04.74.50
|[http://signup.lge.com//Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/SM5C/4.74.50/SM5C_UH5C_04.74.50.epk ссылка]
|-
|55XE3C
|WebOS
|3.0
| 04.21.10
|[http://signup.lge.com/Update/Update_Release/Monitor/15.webOS3.0_Signage/MR_Major/starfish-secured-m16-deua4id-12-04.21.10-prodkey_usb_V3_SECURED.epk v. 04.21.10]
|-
|55XE3C
|WebOS
|3.0
| 04.73.60
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XE3C_XF3C_XS2C/XE3C_XF3C_XS2C-04.73.60.epk v. 04.73.60]
|-
|49XEB3E
|WebOS
|3.0
| 5.40.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/49XEB3E/49XEB3E_v5.40.30.epk ссылка]
|-
|75XF3C
|WebOS
|3.0
| 04.21.10
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/MR_Major/starfish-secured-m16-deua4id-12-04.21.10-prodkey_usb_V3_SECURED.epk ссылка]
|-
|49/55XF3D
|WebOS
|3.0
| 5.32.70
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XF3D_E_XS2E/XF3D_XF3E_XS2E_5.32.70.epk ссылка]
|-
|55XF3E
|WebOS
|3.0
| 5.32.70
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XF3D_E_XS2E/XF3D_XF3E_XS2E_5.32.70.epk ссылка]
|-
|75XF3ES
|WebOS
|3.0
| 5.70.50
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XF3D_E_XS2E/75XF3ES/75XF3ES_5.70.50.epk ссылка]
|-
|75XS2C
|WebOS
|3.0
| 04.30.90
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/SM5C/4.30.90/SM3C_5C_5KC_LS73C_75C_65UH5C_75XS2C_v04.30.90.epk ссылка]
|-
|49/55XS2D
|WebOS
|3.0
| 05.00.50
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XS2D/XS2D-05.00.50.epk ссылка]
|-
|49/55/75XS2E
|WebOS
|3.0
| 05.34.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XF3D_E_XS2E/495575_XS2E_05.34.30.epk ссылка]
|-
|49/55XS4F
|WebOS
|3.0
| 05.35.41
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS3.0_Signage/XS4F/XS4F_05.35.41.epk ссылка]
|-
|colspan="6" style="padding: 15px" align="center"|WebOS 2.0
|-
|-
|86BH5C - Ultra Stretch Model
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-
|88BH7D - Ultra Stretch Model
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-
|98LS95D
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-


|43/49/55SM3B
|WebOS
|2.0
| 03.90.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/SM5B/SM5B_SM5KB_SM3B_VH7B_VH7C_VM5B_VM5C_UH5B_03.90.30.epk ссылка]
|-


|75UH5C
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-
|86UH5C
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-
|75UM3C
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-
|-
|32/43/49/55/65SM5B; 32/43/49/55/65SM5KB; 49/55/65UH5B; 22SM3B;
43/49/55SM3B; 75UH5C; 55VM5B;
55VH7B - Video Wall Model ; 49VH7C; 49VM5C;
|WebOS
|2.0
| 03.90.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/SM5B/SM5B_SM5KB_SM3B_VH7B_VH7C_VM5B_VM5C_UH5B_03.90.30.epk ссылка]
|-


|84WS70B(M)D
|WebOS
|2.0
| 03.70.30
|[http://signup.lge.com/Update/Update_Release/IDEngineering/Signage/webOS2.0_Signage/h15/UH5(P)CD_UM3CD_BH5CD_%2088BH7D_84WS70M(B)D_98LS95D_03.70.30.epk ссылка]
|-
|}


{| class="wikitable"
|colspan="6" style="padding: 20px" | <h2>[[File:Benq-logo-new.png|100px]] Актуальный список прошивок BenQ</h2>
|-
|style="padding: 10px" |Модель
|style="padding: 10px" |Платформа
|style="padding: 10px" |ID платформы
|style="padding: 10px" |Прошивка не ниже
|style="padding: 10px" |Ссылка
|-
|colspan="6" style="padding: 15px" align="center"|Android
|-
|-
| BH2401; BH2801; BH3501; BH3801; BH3801D;
ST4301K; ST5501K
| Android
|
| 1.0.2.5
|[https://firmwaries.hb.bizmrg.com/BenQ/BH3801N/BH3801N_Firmware%20upgrade_OTA_V1.0.2.5_WW.zip ссылка]
|-
|}


{| class="wikitable"
|colspan="6" style="padding: 20px" | <h2>[[File:Philips-logo.png|100px]] Актуальный список прошивок Philips</h2>
|-
|style="padding: 10px" |Модель
|style="padding: 10px" |Платформа
|style="padding: 10px" |ID платформы
|style="padding: 10px" |Прошивка не ниже
|style="padding: 10px" |Ссылка
|-
|colspan="6" style="padding: 15px" align="center"|Android
|-
|-
| BDL3550Q
| Android
|
| 2.03
|[https://firmwaries.hb.bizmrg.com/BDL/update.zip ссылка]
|-
|}

</translate>

SmartPlayer

2023-07-17T13:48:20Z

T.Tagiev: /* Работа с системой */

<languages/>
<translate>
== SmartPlayer == 


Современное кроссплатформенное российское решение для централизованного управления сетями Digital Signage обладающее широким функционалом. 
Официальный сайт https://smartplayer.ru/


* [https://reestr.digital.gov.ru/reestr/311078/?sphrase_id=1606411 Входит в Реестр Российского ПО]
* [https://navigator.sk.ru/orn/1124240 Участник Сколково ]


[[Файл:SpBanner.jpg|frameless|border|500px|центр]]

== Описание системы == 
Система для централизованного управления мультимедийными устройствами (в местах продаж, офисах, аэропортах).


SmartPlayer состоит из серверного приложения, а также клиентов системы под различные ОС:
* Samsung Orsay (Samsung Smart Signage Platform 2-3)
* Samsung Tizen (Samsung Smart Signage Platform 4-7+)
* LG WebOS 2.0+
* BrightSign OS
* Windows
* Linux
* Android
* Raspbian (Raspberry Pi3, Raspberry Pi4)


Система предполагает два типа установки:
*Облако
*'''[[Local_Server|Локальная установка на площадке заказчика]]'''


Личный кабинет системы обладает следующими возможностями:
#Загрузка контента в облако и разделением по рекламодателям.
#Создание рекламных кампаний/трансляций в том числе со сложным многозонным контентом
#Добавление устройств по коду активации экрана с привязкой к адресу установки устройства, тэгам, типам устройств.
#Создание расписаний по рекламодателям и таргетирование расписаний на устройства.
#Формирование отчетов по рекламным кампаниям и устройствам.


'''Вся работа с личным кабинетом осуществляется через браузер(поддерживается мобильная верстка).
{| class="wikitable"
|-
! Версия браузера !! Поддержка
|-
| Chrome 66 и выше || Да
|-
| Opera 52 и выше || Да
|-
| Firefox 59 и выше || Да
|-
| Safari 11.1 и выше || Да
|-
| IE 11 (с последними обновлениями) || Могут быть ограничения при работе. Устаревший браузер от компании Microsoft, обновитесь до Microsoft Edge.
|-
| Microsoft Edge || Да
|}

== Работа с системой ==

Подробно описание функционала доступно в соответствующих разделах.


=== Быстрый старт ===
Для того, чтобы начать работать с платформой '''SmartPlayer''' выполните два простых действия:
#Зайдите в ваш личный кабинет с данными предоставленными представителем SmartPlayer.
#Установите одно из наших клиентских приложений (можно скачать в разделе [[Distributives|Дистрибутивы]]).


<h3>Работа с личным кабинетом</h3>
Зайдите в личный кабинет SmartPlayer использую полученную вами ссылку и данные (логин и пароль) для доступа. 


'''О там как создать вашу первую трансляцию и отправить её на устройство читайте '''[[Getting_started|ЗДЕСЬ]]'''.''' 
Подробно ознакомиться с возможностями и интерфейсом системы можно в разделе "Интерфейс системы".
О том как установить клиентские приложения на конкретное устройство читайте в разделе про конкретную ОС/Устройств.


<h3>Установка и настройка клиентского приложения</h3>
*'''[[SSSP|SSSP (Tizen)]]''' - Samsung Smart Signage Platform. Профессиональные панели Samsung со встроенным плеером (System on Chip). В том числе новейшая серия проф. дисплеев с ОС '''Tizen'''. 
*'''[[WebOS]]''' - клиент для профессиональных панелей LG c платформой WebOS.
**'''[[WebOS_Signage]]''' - клиент для профессиональных панелей LG c платформой WebOS.
**'''[[WebOS_ProCentric]]''' - клиент для гостиничных телевизоров LG c платформой WebOS.
*'''[[Windows]]''' - клиент под ОС Windows.
*'''[[Linux]]''' - клиент под ОС Linux.
**'''[[AstraLinux]]''' - клиент под Astra Linux
*'''[[Android]]''' - общая информация по работе с Android ОС. Рекомендуемые Android TV(приставки).
**'''[[Philips]]''' - клиент для профессиональных панелей и коммерческих ТВ Philips c ОС Android.
**'''[[HikVision]]''' - клиент для профессиональных панелей HikVision c ОС Android.
**'''[[Hisense]]''' - клиент для профессиональных панелей Hisense c ОС Android.
**'''[[Vestel]]''' - клиент для профессиональных панелей Vestel c ОС Android.
**'''[[BenQ]]''' - клиент для профессиональных панелей BenQ c ОС Android.
**'''[[TCL]]''' - клиент для телевизоров TCL c ОС Android.
**'''[[Ugoos]]'''
***'''[[Ugoos AM3]]''' - полупрофессиональный плеер (Android TV) под ОС Android.
***'''[[Ugoos X3 Cube]]''' - полупрофессиональный плеер (Android TV) под ОС Android.

*'''[[BrightSign OS]]''' - клиент для профессиональных плееров с операционной системой BrighSign OS от компании [https://www.brightsign.biz/ BrightSign]
*'''[[Raspberry Pi 3-4]]''' - клиент для одноплатных компьютеров Raspberry с Raspbian OS
*'''[[NEC]]''' - профессиональные панели NEC со встроенным плеером Raspberry


После настройки и запуска приложения, на клиентском устройстве должен появится [[код активации]]. На этом этапе настройка клиентской части закончена. Все остальные действия можно осуществлять через личный кабинет.


<h3>FAQ</h3>
Ответы на часто задаваемые вопросы можно найти здесь: [[FAQ]] и тут [[Knowledge_base]]
#[[WakeOnLan|Включение устройство по сети]] - включение устройства, из выключенного состояния по сетевой технологии WakeOnLan

== Примеры создания трансляций (кейсы) == 
#[[Basic_Broadcast|Простая трансляция на весь экран]]
#[[Multi_Broadcast|Мультизонная трансляция]]
#[[Broadcast+Music|Видео трансляция + фоновая музыка]]
#[[Campaigns|Рекламные кампании]] - решение для Рекламных Агентств
#[[Videowall|Видеостена]]
#[[Radio|Радио]] - решение для управление фоновой музыкой
#[[Links|Ссылки]] - решения для проигрывание онлайн трансляций, интернет-радио и определенных веб-страниц
#[[SyncPlaylistWithDifferentContents|Синхронизация плейлистов]] - синхронное проигрывание для Видеостен, Менюбордов
#[[PlayVolumeAndVideo|Проигрывание звука и видеоряда]] - одновременное проигрывание видеоконтента и отдельной аудиодорожки (фоновая музыка)
#[[TouchBroadcast|Создание интерактивных трансляций]] - создание интерактивных сценариев своими руками с помощью встроенного функционала трансляций
#[[TouchContent|Воспроизведение интерактивного контента]] - навигация, интерактивные приложения, каталоги
#[[SmartFolder|Умная Папка (SmartFolder)]] - автоматическая обновление контента из папки, если вы добавляете файл в папку, то он автоматически рассылается на все связанные устройства

== Примеры использования виджетов == 
[[Widgets|Виджеты]] - мини приложения для отображения различной информации из внешних источников (погода, пробки, новости) или для интеграции со сторонними системами (динамические цены, сомелье)

== Интерфейс системы == 
Здесь вы можете прочитать про основные модули системы и особенности интерфейса. 
[[Basic_Interface|Общий обзор интерфейса системы]]


<h3>Основные модули системы:</h3>


[[Dashboard|Обзор]] - общая информация о платформе в виде дашборда 
[[Устройства]] - работа с устройствами и группами, мониторинг, удалённое управление 
[[Рекламодатели|Контент]] - создание рекламодателей/папок, загрузка контента 
[[Отчёты]] - просмотр отчётов Proof of Play по различным параметрам, статистика по работе устройств 
[[Пользователи]] - создание новых пользователей и ролей (управления правами доступа) 
[[История]] - позволяет отслеживать все действия пользователей в Личном Кабинете 
[[Настройки]] - настройки системы 
[[Distributives|Дистрибутивы]] - раздел с ссылками и инструкциями на дистрибутивы для различных ОС 
[[Downloads|Загрузки]] - информация о прогрессе загрузки контента в личный кабинет и на клиентские устройства 


'''Также в зависимости от ваших задач может быть выбран один из модулей организации проигрывании контента:''' 
[[Контент на устройства]] - создание упрощенной (однозонной) трансляции. Подходит для простых проектов. Создаётся с помощью мастера в 3 шага 
[[Трансляции]] - работа с трансляциями, подходит для организации систем Digital Signage любой сложности, с мультизональностью, триггерами и динамическим контентом 
[[Расписание]] - составление расписаний проигрывания для устройств и групп, модуль используется автоматически с модулями [[Трансляции]] и [[Контент на устройства]] 
[[Campaigns|Рекламные кампании]] - работа с рекламными кампаниями. Оптимальный выбор для рекламных агентств. Позволяет работать с интеллектуальным планировщиком, выбирать частоту выходов конкретного контента, либо работать с рекламными блоками произвольной длинны 


<h3>Дополнительные модули системы:</h3>
[[Справочники]] - раздел позволяющий пользователю работать с виджетами в упрощенном и более приятном виде. 
[[Videoanalytics|Видеоаналитика]] - технология, использующая методы компьютерного зрения для автоматизированного получения различных данных на основании анализа последовательности изображений, поступающих с видеокамер в режиме реального времени или из архивных записей. 
[[Gas_board|Стелы АЗС]] - управление стелами АЗС 

== Поддерживаемые платформы == 
В этом разделе вы можете ознакомиться со списком платформ на которых работают наши плееры. 
* [[SSSP|SSSP(Orsay OS, Tizen OS)]]
* [[Windows]]
* [[Linux]] 
* [[Android]] 
* [[WebOS]] 
* [[BrightSign OS]] 
* [[Raspberry Pi 3-4]] 

== Актуальные версии прошивок == 
*[[Integrations|Актуальные прошивки]]

==Нештатные ситуации (Troubleshooting)== 
# Описание наиболее частых нештатных ситуаций и их решения доступно в этом разделе [[Troubleshooting]] ознакомьтесь с ним 
# Если не нашли своего случая в предыдущем разделе, воспользуйтесь средствами отладки [[DebugSmartPlayer|Средства отладки]] 
# Если решить ситуацию самостоятельно не получается, обратитесь в службу поддержки SmartPlayer по адресу [mailto:support@smartplayer.org support@smartplayer.org] или вашему менеджеру в компании.



*[[Smart Manager (личный кабинет)]]


*[[Smart Manager: Рекламный режим]]


*[[OS Android]]


*[[OS Windows]]


*[[OS Samsung]]
**[[OS Tizen]]
**[[OS Orsay]]


*[[OS WebOS (LG)]]


*[[OS Linux]] -->
</translate>

Android

2023-07-04T09:19:14Z

T.Tagiev:

<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) ==
'''Важно!''' '''''Если приставки нет в рекомендуемых, свяжитесь, пожалуйста, с представителями SmartPlayer и проконсультируйтесь по совместимости и поддерживаемой функциональности'''''


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

|-
|[https://ugoos.com/x3-tv-box-family-series-devices-based-on-android-9-0/ Ugoos X3 Box Family Series (Cube, Pro, Plus)]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|Яндекс.Маркет, Amazon

|-
|[http://www.tanix-box.com/project-view/tanix-tx9s-android-tv-box-amlogic-s912-2gb-ram-8gb-storage/ Tanix TX9S]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да '''
|Яндекс.Маркет, Amazon

|-
|[https://perfeo.ru/perfeo-smart-tv-box-pristavka-matrix-android-9-0-amlogic-s905x2-2g-16gb-bluetooth-4-1-pf-a4553.html Perfeo Matrix]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да (в качестве бюджетного решения)'''
|[https://market.yandex.ru/product--mediapleer-perfeo-matrix/664970545?cpa=0 Яндекс.Маркет]
|-
|[https://ugoos.ru/android-pristavki/X2_Cube?sort=p.price&order=ASC&limit=100 X2 CUBE]
[http://wiki.smartplayer.org/index.php/X2CUBE Инструкция по настройке]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да (в качестве бюджетного решения)'''
|[https://market.yandex.ru/product--mediapleer-ugoos-x2-cube/521429197 Яндекс.Маркет]
[https://ugoos.ru/android-pristavki/X2_Cube?sort=p.price&order=ASC&limit=100 Оф. сайт]
|-
|[http://ugoos.ru/android-pristavki?product_id=151 Ugoose AM3 2Gb/16Gb]
[http://wiki.smartplayer.org/index.php/Ugoos_AM3 Инструкция по настройке]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Да
|В разработке
|В разработке
|<div style="color: green">'''Да (в качестве профессионального решения)'''
|[https://market.yandex.ru/product--mediapleer-ugoos-am3/1725096421?track=tabs Яндекс.Маркет]
[http://ugoos.ru/android-pristavki?product_id=151 Оф. сайт]
[https://www.ixbt.com/live/kyrie1965/android-boks-ugoos-am3-na-amlogic-s912_2.html Обзор]
|-
|[https://smartpristavka.ru/tv-pristavki/ipc002.html INVIN IPC002 1Gb/8Gb]
|Да
|Да
|Да
|Да
|Да
|Да
|Да/Нет
|В разработке
|В разработке
|<div style="color: green">'''Да (в качестве бюджетного решения)'''
|[https://market.yandex.ru/product--mediapleer-invin-ipc002/260979011?track=tabs Яндекс.Маркет]
|-
|[https://smartpristavka.ru/tv-pristavki/w95.html W95 1Gb/8Gb]
|Да
|Да
|В разработке
|Да
|Да
|Да
|Да/Нет
|В разработке
|В разработке
|<div style="color: green">'''Да (в качестве бюджетного решения)'''
|[https://market.yandex.ru/product--mediapleer-invin-w95/1803351317?track=tabs Яндекс Маркет]
|-
|[https://www.mi.com/ru/mibox/ Xiaomi Mi Box International Version]
Требуется обновить до Android 8.0 через настройки в системе.
|Нет
|Нет
|Да
|Нет
|Да
|Нет
|Да/Да
|Нет
|Нет
|<div style="color: red">'''Нет'''
|[https://market.yandex.ru/product--mediapleer-xiaomi-mi-box-international-version/1717471370 Яндекс Маркет]
|-
|[https://smartpristavka.ru/tv-pristavki/w5.html Invin W5 2Gb/16Gb]
|Да
|Да
|Нет
|Да
|Нет
|Да
|Да/Нет
|В разработке
|В разработке
|<div style="color: red">'''Нет'''
|[https://market.yandex.ru/product--mediapleer-invin-w5-2gb-16gb/1883519846 Яндекс Маркет]
|}


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


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


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


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

== Режимы работы приложения SmartPlayer на устройстве == 
'''Приложение на устройстве может иметь разные привилегии, в зависимости от этого можно управлять устройством'''
* Обычный - по умолчанию при установки приложения 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 у производителя.
|-
| BenQ (проф. серия) || Да || Signature
|-
| Xiaomi || Нет || Попытки запросить SDK у производителя по горячей линии, не дали результата. Готовы интегрироваться при наличии SDK у производителя.
|-
| HIKVISION || Да || 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 поддерживает вертикальную ориентации на части устройств.
#Зайти в настройки приставки
#Настройки изображения
#Выбрать пункт rotating screen
#Установить приложение SmartPlayer

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


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


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

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


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


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

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


#Настроить сеть интернет на телефоне.
#Проверить доступность новой прошивки на телефон (Настройки - Система - Обновление системы). Если есть новая прошивка, обновить её.
#Отключить режим блокировки у телефона. (Настройки - Безопасность - Блокировка эрана - Нет)
#После установки приложения 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]

</translate>