https://wiki.smartplayer.org/index.php?action=history&feed=atom&title=%22%D0%94%D0%B5%D1%82%D0%B5%D0%BA%D1%82%D0%BE%D1%80%22_%D1%87%D0%B5%D1%80%D0%BD%D0%BE%D0%B3%D0%BE_%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0_%28%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%29%2Fru"Детектор" черного экрана (Системный администратор)/ru - История изменений2026-05-02T06:44:01ZИстория изменений этой страницы в викиMediaWiki 1.45.1https://wiki.smartplayer.org/index.php?title=%22%D0%94%D0%B5%D1%82%D0%B5%D0%BA%D1%82%D0%BE%D1%80%22_%D1%87%D0%B5%D1%80%D0%BD%D0%BE%D0%B3%D0%BE_%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0_(%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80)/ru&diff=18560&oldid=prevFuzzyBot: Обновление для соответствия новой версии исходной страницы.2026-01-15T12:38:13Z<p>Обновление для соответствия новой версии исходной страницы.</p>
<a href="https://wiki.smartplayer.org/index.php?title=%22%D0%94%D0%B5%D1%82%D0%B5%D0%BA%D1%82%D0%BE%D1%80%22_%D1%87%D0%B5%D1%80%D0%BD%D0%BE%D0%B3%D0%BE_%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0_(%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80)/ru&diff=18560&oldid=9621">Внесённые изменения</a>FuzzyBothttps://wiki.smartplayer.org/index.php?title=%22%D0%94%D0%B5%D1%82%D0%B5%D0%BA%D1%82%D0%BE%D1%80%22_%D1%87%D0%B5%D1%80%D0%BD%D0%BE%D0%B3%D0%BE_%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0_(%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%8B%D0%B9_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80)/ru&diff=9621&oldid=prevFuzzyBot: Обновление для соответствия новой версии исходной страницы.2023-08-08T13:31:03Z<p>Обновление для соответствия новой версии исходной страницы.</p>
<p><b>Новая страница</b></p><div>== '''Описание ситуации''' ==<br />
У пользователей появляются проблемы с трансляциями на устройствах. При воспроизведении контента на некоторых устройствах выводится «чёрный» экран. Эту проблему можно наблюдать в личном кабинете пользователя или на месте нахождения устройства.<br />
== '''Причина''' ==<br />
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать, но отображает только "Чёрный" экран.<br><br />
Эта ситуация возникает из-за различных ошибок при запуске трансляции. Причины таких проблем могут быть разными, и их очень сложно обнаружить.<br><br />
В качестве причины может выступать любое действие: <br />
* Пользователь загружает видео, но это видео использует неподдерживаемый системой кодек. Тогда видео просто не может запуститься и показывает черный экран. Бывает проблемы, связанные с клиентским приложением (баг), и из-за этого начинаются проблемы с трансляцией.<br />
* Пока есть наличие постоянной, стабильной сети – все работает отлично. Как только устройство теряет доступ к сети (по любой причине) – трансляция прерывается и появляется чёрный экран.<br />
[[File:Пример черного экрана в ЛК.png|thumb|Пример отображения "Чёрного" экрана в личном кабинете пользователя|500px]]<br />
=== '''Систематичность проблемы''' ===<br />
"Чёрный" экран очень несложно отследить и подтвердить визуально. В этом случае хорошо помогает личный кабинет.<br><br />
Проблема ситуации в том, что он не несет в себе систематичности по времени и может появляться как раз в месяц, так и раз в несколько дней или часов.<br><br />
Период появления черного экрана определяется опытным путём и подтверждает по факту у точки. Поиск причины проблемы перекладывается на плечи технических специалистов.<br />
== '''Концепт решения''' ==<br />
Для решения проблемы было решено создать автоматический «Детектор» черного экрана. Он уведомляет о проблемах с контентом на устройстве и оповещает о случившейся ситуации в личном кабинете.<br><br />
{{Note|Данный функционал не доступен пользователю в личном кабинете. Его необходимо включать отдельно.|warn}} <br />
=== '''Принцип действия''' ===<br />
У каждого клиента/компании есть свой ID связанный с сервером. ID указан в личном кабинете и к нему привязываются все устройства компании.<br> <br />
После запуска функционала сервер с определенным промежутком по времени отправляет на устройства «ивент».<br><br />
Запуская «ивент» устройство с помощью детектора проверяет наличие "черного" экрана, делая скриншот во время запуска.<br><br />
После запуска детектора возможно получить два определенных результата:<br />
* После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.<br />
* После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент".<br><br />
'''Промежуток для повторной отправки "ивента" составляет 10 секунд.'''<br><br />
Если же и во второй раз отправляется черный экран, то со стороны сервера отправляется письмо на почту, о наличии проблемы.<br />
{{Note|Указанная почта должна быть привязана к серверу.|warn}}<br />
=== '''Подготовка ''' ===<br />
Системный администратор должен настроить серверное приложение по двум параметрам:<br />
* Запуск и функционирование детектора "чёрного" экрана<br />
* Настройка отправки письма с ошибкой на почту<br />
=== '''Принцип действия ''' ===<br />
Если серверное приложение обнаружило черный экран, оно отправляет на почту письмо.<br />
Итогом этой проверки станет сообщение на почту с оповещение о проблеме. <br><br />
Для подтверждения проверки работоспособности функционала через личный кабинет системный администратор может поставить черную картинку. Сервер продолжает отправляет оповещения пока проблема не будет исправлена или же пока не будет выключен функционал.<br><br />
Впоследствии системный администратор должен принять меры для устранения проблемы.<br />
=== '''Тонкости и нюансы при работе функционала''' ===<br />
1. Для правильного работы необходимо чтобы placeholder с белой точкой воспринимался как черный экран. Поэтому используется не абсолютная проверка.<br><br />
2. '''Актуально только при проигрывании видео.''' При наличии root прав на устройстве – детектор работает нормально. Но, если, на устройстве нет root прав, детектор не сможет сделать скриншот.<br><br />
'''Исключения:'''<br><br />
Скриншот доступен:<br />
* Если приложение подписано «подписью разработчика» (уровень прав – Signage).<br />
* Некоторые устройства (Vestel, Hikvision, Phillips) могут сделать скриншот без root прав из-за особенностей прошивки.<br />
3. Если пользователь попробует сделать скриншот без root прав, то создается «пустой скриншот» с надписью «Идёт воспроизведение видео. Отсутствуют права для снятия скриншота».<br><br />
4. Информация от сервера к разработчикам отправляется через "ивент". Внутри отправленного «ивента» сервер ждет callback от разработчиков.<br><br />
5. Тайм – аут “Callback” по умолчанию на сервере составляет – 30 секунд.<br />
== '''Реализация''' ==<br />
=== '''Активация''' ===<br />
По умолчанию детектор для всех компаний отключен на сервере, так как создает на него слишком большую нагрузку.<br />
{{Note|Включается детектор только по запросу со стороны компании, у которой появилась проблема с чёрным экраном.|warn}}<br />
=== '''Алгоритм действия''' ===<br />
Вся работа будет вестись в два этапа.<br><br />
'''Первый этап - это запуск самого детектора'''.<br><br />
При запуске детектора нужно использовать id компании, который указан в личном кабинете. [[File:ID компании.png|thumb|Расположение ID компании в личном кабинете |300px]]<br />
Для этого нужно зайти в профиль и развернуть подробную информацию о пользователе.<br />
Системному администратору нужно подключиться на сервер, через '''Command Line Interface (CLI)'''.<br><br />
<div style="border: 1px solid #888; padding: 10px; margin: 10px 0; background-color: #f9f9f9;"><br />
При включении CLI сервер получает определенные данные для настройки:<br><br />
Это:<br />
* ID компании, для которой включаем детектор<br />
* Можно передать платформу (или несколько платформ), для которой необходимо запустить мониторинг.<br />
Например: передаем параметр "ANDROID" и мониторинг включается только для устройств "ANDROID".<br />
* E-mail адрес или несколько адресов на которые должно отправляться уведомление о нештатной ситуации<br />
* Указанное время хранения скриншотов (по умолчанию 3 дня)<br />
</div><br />
Далее нужно перейти в серверное приложение и выполнить команду:<br />
<code>docker exec -it smartplayer_backend_i bash</code><br />
[[File:Команда docker.png|thumb|Команда"docker exec -it smartplayer_backend_i bash" |300px]]<br />
На этом этапе попадаем в нашем контейнере с серверным приложением.<br><br />
Следующей выполняем команду:<br />
<code>Enable screen - screen monitor </code>[[File:Enable screen monitor.png|thumb|Команда"docker exec -it smartplayer_backend_i bash" |300px]]<br />
После очередного этапа система выдает вот такую строку: <br />
Системное сообщение: <code>Input company ID and press Enter</code>[[File:Системное сообщение.png|thumb|Системное сообщение "Input company ID and press Enter:" |300px]]<br />
Выполненная команда отобразит строку в которой просят ввести Id компании.<br><br />
После ввода ID появляется запрос на мониторинг всех платформ компании. В данном случае выбираем «ДА/Y»<br />
[[File:Мониторинг всех платформ.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]<br />
В последствии консоль потребует указать e-mail на который будут приходить оповещения о проблемах.<br />
Это делается в строке:<br><br />
<code>Input_email and press enter</code><br />
[[File:Строка почты.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]<br />
{{Note|Указанная почта должна быть привязана к серверу.|warn}}<br />
Также можно указать интервал с которым будут приходить скриншоты (например 1 минута). Строка выглядит так:<br><br />
<code>Input check interval in minutes (m) or seconds (s) and press "Enter"</code><br><br />
[[File:Интервал отправки сообщения.png|thumb|Здесь нужно указать время в минутах с префиксом (m) или в секундах с префиксом (S) |300px]]<br />
Далее указываем время либо в секундах с префиксом (s) после числового значения, либо в минутах с префиксом (m) и применяем эту настройку через "Enter". Итогом всех манипуляций будет статус:<br><br />
<code>Company screen monitoring enabled</code> - выделена зеленым цветом. Это значит что детектор черного экрана запущен.<br />
[[File:Запуск детектора.png|thumb|Оповещение о запуске Детектора выделено зелёным цветом |300px]]<br />
=== '''Уведомления на почту''' ===<br />
Второй этап настройка уведомления, которые приходят на почту. Настройка уведомления подробно прописана в отдельной инструкции [[Настройка отправки писем через серверное приложение SmartPlayer]].<br><br />
{{Note|При получении сообщения о проблеме на почту, невозможно напрямую из этого уведомления сделать какие либо действия. К примеру «Перезагрузка экрана» или "Остановка трансляции" недоступна.|warn}}<br />
=== '''Предфинальные действия''' ===<br />
В зависимости от результата, системный администратор сможет корректно определить причину и предпринять конкретные действия для устранения ситуации. Если у него не получается решить проблему внутри своей среды или же проблема на нашей стороне, он должен обратиться к команде SmartPlayer.<br><br />
Это вариант удобен для всех. Так как поможет решить проблемы если они и с нашей стороны (например баг приложения), так и со стороны пользователя (например пользователь неправильно создал трансляцию).<br />
=== '''Важная информация о которой не стоит забывать ''' ===<br />
{{Note|'''Для перезапуска трансляции надо зайти в личный кабинет и перезапустить все вручную'''|warn}}<br />
{{Note|'''Детектор черного экрана на данный момент работает только на Android версии 1.63.1'''|warn}}<br />
== '''Итоговый результат''' ==<br />
Системный администратор со стороны клиента сможет запустить и настроить функционал детектора и начать решать проблему.<br />
Наличие детектора позволяет контролировать проблемную ситуацию с "Чёрным" экраном и оперативно работать с её исправлением. Это актуально как для нас, так и для сотрудников клиента.<br />
Команда SmartPlayer и команда сотрудников со стороны клиента смогут оперативно взаимодействовать для решения проблемы. <br><br />
Рядовой пользователь минимизирует негативный опыт взаимодействия с нашим продуктом.</div>FuzzyBot