"Детектор" черного экрана (Системный администратор)/en - История изменений

FuzzyBot: Обновление для соответствия новой версии исходной страницы.

2026-01-15T12:38:20Z

Обновление для соответствия новой версии исходной страницы.

N.Bloshkin: Новая страница: «== '''Final Outcome:''' == The client's system administrator will be able to launch and set up the black screen detector functionality and start resolving the problem. Having Having the detector allows monitoring the problematic situation with the "Black" screen and promptly work on its correction. This is relevant both for us and for the client's employees. The SmartPlayer team and the client-side employee team will be able to interact quickly to solve the...»

2023-08-08T14:54:39Z

Новая страница: «== '''Final Outcome:''' == The client's system administrator will be able to launch and set up the black screen detector functionality and start resolving the problem. Having Having the detector allows monitoring the problematic situation with the "Black" screen and promptly work on its correction. This is relevant both for us and for the client's employees. The SmartPlayer team and the client-side employee team will be able to interact quickly to solve the...»

Внесённые изменения

N.Bloshkin: Новая страница: «== '''Solution Concept''' == To address the issue, it was decided to create an automatic "Black Screen Detector". It notifies of problems with content on the device and alerts about the occurred situation in the personal account.
{{Note|This functionality is not available to the user in the personal account and needs to be activated separately.|warn}} === '''Operating Principle''' === Every client/company has its own ID associated with the server. This I...»

2023-08-08T14:45:48Z

Новая страница: «== '''Solution Concept''' == To address the issue, it was decided to create an automatic "Black Screen Detector". It notifies of problems with content on the device and alerts about the occurred situation in the personal account.<br> {{Note|This functionality is not available to the user in the personal account and needs to be activated separately.|warn}} === '''Operating Principle''' === Every client/company has its own ID associated with the server. This I...»

← Предыдущая версия		Версия от 17:45, 8 августа 2023
Строка 12:		Строка 12:
	The challenge with this situation is that it doesn't have a consistent frequency; it can occur once a month, or once every few days or even hours.<br>		The challenge with this situation is that it doesn't have a consistent frequency; it can occur once a month, or once every few days or even hours.<br>
	The period when the black screen appears is determined empirically and is confirmed on-site. The responsibility of finding the cause of the problem falls on technical specialists.		The period when the black screen appears is determined empirically and is confirmed on-site. The responsibility of finding the cause of the problem falls on technical specialists.
	~~<div lang="ru" dir="ltr" class="mw-content-ltr">~~		== '''Solution Concept''' ==
	== '''~~Концепт решения~~''' ==		To address the issue, it was decided to create an automatic "Black Screen Detector". It notifies of problems with content on the device and alerts about the occurred situation in the personal account.<br>
	~~Для решения проблемы было решено создать автоматический «Детектор» черного экрана~~. ~~Он уведомляет о проблемах с контентом на устройстве и оповещает о случившейся ситуации в личном кабинете~~.<br>		{{Note\|This functionality is not available to the user in the personal account and needs to be activated separately.\|warn}}
	{{Note\|~~Данный функционал не доступен пользователю в личном кабинете. Его необходимо включать отдельно~~.\|warn}}		=== '''Operating Principle''' ===
	=== '''~~Принцип действия~~''' ===		Every client/company has its own ID associated with the server. This ID is indicated in the personal account, and all the company's devices are linked to it.<br>
	~~У каждого клиента~~/~~компании есть свой~~ ID ~~связанный с сервером~~. ID ~~указан в личном кабинете и к нему привязываются все устройства компании~~.<br>		After activating the functionality, the server sends an "event" to the devices at specific time intervals.<br>
	~~После запуска функционала сервер с определенным промежутком по времени отправляет на устройства «ивент»~~.<br>		When initiating the "event", the device checks for the presence of a "black" screen using the detector, taking a screenshot during the launch.<br>
	~~Запуская «ивент» устройство с помощью детектора проверяет наличие~~ "~~черного~~" ~~экрана~~, ~~делая скриншот во время запуска~~.<br>		After launching the detector, two specific results can be obtained:
	~~После запуска детектора возможно получить два определенных результата~~:		* After initiating the "event", no black screen is detected - the system continues to operate in normal mode.
	* ~~После запуска «ивента» черного экрана нет~~ - ~~система продолжает работу в штатном режиме~~.		* After initiating the "event", a black screen is detected - the server sends a secondary, verification "event".<br>
	* ~~После запуска «ивента» чёрный экран обнаружен~~ - ~~сервер отправляет повторный~~, ~~проверочный~~ "~~ивент~~".<br>		'''The interval for resending the "event" is 10 seconds.'''<br>
	'''~~Промежуток для повторной отправки~~ "~~ивента~~" ~~составляет~~ 10 ~~секунд~~.'''<br>		If a black screen is detected again during the second check, the server sends an email alerting about the issue.
	~~Если же и во второй раз отправляется черный экран, то со стороны сервера отправляется письмо на почту~~, ~~о наличии проблемы~~.		{{Note\|The specified email should be linked to the server.\|warn}}
	{{Note\|~~Указанная почта должна быть привязана к серверу~~.\|warn}}		=== '''Preparation ''' ===
	=== '''~~Подготовка~~ ''' ===		The system administrator must configure the server application based on two parameters:
	~~Системный администратор должен настроить серверное приложение по двум параметрам~~:		* Launch and operation of the "black screen" detector
	* ~~Запуск и функционирование детектора~~ "~~чёрного~~" ~~экрана~~		* Setting up email alerts for detected errors
	* ~~Настройка отправки письма с ошибкой на почту~~		=== '''Operating Principle ''' ===
	=== '''~~Принцип действия~~ ''' ===		If the server application detects a black screen, it sends an email. The result of this check will be an email notification about the issue.<br>
	~~Если серверное приложение обнаружило черный экран~~, ~~оно отправляет на почту письмо~~.		To confirm the functionality check via the personal account, the system administrator can set a black picture. The server continues to send notifications until the problem is resolved or the functionality is turned off. <br>
	~~Итогом этой проверки станет сообщение на почту с оповещение о проблеме~~. <br>		Subsequently, the system administrator must take measures to resolve the issue.
	Для подтверждения проверки работоспособности функционала через личный кабинет системный администратор может поставить черную картинку. Сервер продолжает отправляет оповещения пока проблема не будет исправлена или же пока не будет выключен функционал.<br>		=== '''Nuances and Subtleties in Functional Operation''' ===
	~~Впоследствии системный администратор должен принять меры для устранения проблемы~~.		1. For correct operation, it is necessary for the placeholder with a white dot to be perceived as a black screen. Therefore, an absolute check is not used.<br>
	=== '''~~Тонкости и нюансы при работе функционала~~''' ===		2. '''It's relevant only during video playback. ''' If there are root rights on the device, the detector works fine. However, if there are no root rights on the device, the detector won't be able to take a screenshot.<br>
	1. ~~Для правильного работы необходимо чтобы~~ placeholder ~~с белой точкой воспринимался как черный экран~~. ~~Поэтому используется не абсолютная проверка~~.<br>		'''Exceptions:'''<br>
	2. '''~~Актуально только при проигрывании видео~~.''' ~~При наличии~~ root ~~прав на устройстве – детектор работает нормально~~. ~~Но, если~~, ~~на устройстве нет~~ root ~~прав~~, ~~детектор не сможет сделать скриншот~~.<br>		Screenshot is available:
	'''~~Исключения~~:'''<br>		* If the application is signed with the "developer's signature" (rights level – Signage).
	~~Скриншот доступен~~:		* Some devices (Vestel, Hikvision, Phillips) can take a screenshot without root rights due to firmware features.
	* ~~Если приложение подписано «подписью разработчика»~~ (~~уровень прав~~ – Signage).		3. If a user tries to take a screenshot without root rights, an "empty screenshot" is created with the inscription "Video is playing. No rights to take a screenshot".<br>
	* ~~Некоторые устройства~~ (Vestel, Hikvision, Phillips) ~~могут сделать скриншот без~~ root ~~прав из-за особенностей прошивки~~.		4. Information from the server to the developers is sent through an "event". Inside the sent "event", the server awaits a callback from the developers.<br>
	3. ~~Если пользователь попробует сделать скриншот без~~ root ~~прав~~, ~~то создается «пустой скриншот» с надписью «Идёт воспроизведение видео~~. ~~Отсутствуют права для снятия скриншота»~~.<br>		5. The default "Callback" timeout on the server is 30 seconds.
	4. ~~Информация от сервера к разработчикам отправляется через~~ "~~ивент~~". ~~Внутри отправленного «ивента» сервер ждет~~ callback ~~от разработчиков~~.<br>
	5. ~~Тайм – аут “Callback” по умолчанию на сервере составляет –~~ 30 ~~секунд~~.
	~~</div>~~
	<div lang="ru" dir="ltr" class="mw-content-ltr">		<div lang="ru" dir="ltr" class="mw-content-ltr">
	== '''Реализация''' ==		== '''Реализация''' ==

N.Bloshkin: Новая страница: «== '''Cause''' == On devices operating on-site, a "black screen" appears during content playback. Meanwhile, the broadcast in the personal account continues to run but only displays a "black" screen.
This situation arises due to various errors when starting the broadcast. The reasons for such problems can vary and are very difficult to detect.
Any of the following actions can be a cause: * A user uploads a video, but this video uses a codec unsuppor...»

2023-08-08T14:33:18Z

Новая страница: «== '''Cause''' == On devices operating on-site, a "black screen" appears during content playback. Meanwhile, the broadcast in the personal account continues to run but only displays a "black" screen.<br> This situation arises due to various errors when starting the broadcast. The reasons for such problems can vary and are very difficult to detect.<br> Any of the following actions can be a cause: * A user uploads a video, but this video uses a codec unsuppor...»

← Предыдущая версия		Версия от 17:33, 8 августа 2023
Строка 1:		Строка 1:
	== '''Situation Description''' ==		== '''Situation Description''' ==
	Users are experiencing issues with broadcasts on their devices. When playing content on some devices, a "black" screen appears. This problem can be observed in the user's personal account or at the device's location.		Users are experiencing issues with broadcasts on their devices. When playing content on some devices, a "black" screen appears. This problem can be observed in the user's personal account or at the device's location.
	~~<div lang="ru" dir="ltr" class="mw-content-ltr">~~		== '''Cause''' ==
	== '''~~Причина~~''' ==		On devices operating on-site, a "black screen" appears during content playback. Meanwhile, the broadcast in the personal account continues to run but only displays a "black" screen.<br>
	~~В устройствах~~, ~~работающих на местах во время проигрывания контента, появляется «чёрный экран»~~. ~~При этом трансляция в личном кабинете продолжает работать~~, ~~но отображает только~~ "~~Чёрный~~" ~~экран~~.<br>		This situation arises due to various errors when starting the broadcast. The reasons for such problems can vary and are very difficult to detect.<br>
	~~Эта ситуация возникает из-за различных ошибок при запуске трансляции~~. ~~Причины таких проблем могут быть разными, и их очень сложно обнаружить~~.<br>		Any of the following actions can be a cause:
	~~В качестве причины может выступать любое действие~~:		* A user uploads a video, but this video uses a codec unsupported by the system. As a result, the video simply cannot start and displays a black screen. There are issues related to the client application (a bug), leading to broadcast problems
	* ~~Пользователь загружает видео~~, ~~но это видео использует неподдерживаемый системой кодек~~. ~~Тогда видео просто не может запуститься и показывает черный экран~~. ~~Бывает проблемы, связанные с клиентским приложением~~ (~~баг~~), ~~и из-за этого начинаются проблемы с трансляцией.~~		* As long as there is a consistent, stable network, everything works fine. However, as soon as the device loses network access (for any reason), the broadcast is interrupted, and a black screen appears.
	* ~~Пока есть наличие постоянной~~, ~~стабильной сети – все работает отлично~~. ~~Как только устройство теряет доступ к сети~~ (~~по любой причине~~) ~~– трансляция прерывается и появляется чёрный экран~~.		[[File:Пример черного экрана в ЛК.png\|thumb\|An example of displaying a "Black" screen in the user's personal account\|500px]]
	[[File:Пример черного экрана в ЛК.png\|thumb\|~~Пример отображения~~ "~~Чёрного~~" ~~экрана в личном кабинете пользователя~~\|500px]]		=== '''Frequency of the Problem''' ===
	=== '''~~Систематичность проблемы~~''' ===		It's very easy to detect and visually confirm the "black" screen. In such cases, the personal account is very helpful.<br>
	"~~Чёрный~~" ~~экран очень несложно отследить и подтвердить визуально~~. ~~В этом случае хорошо помогает личный кабинет~~.<br>		The challenge with this situation is that it doesn't have a consistent frequency; it can occur once a month, or once every few days or even hours.<br>
	~~Проблема ситуации в том, что он не несет в себе систематичности по времени и может появляться как раз в месяц~~, ~~так и раз в несколько дней или часов~~.<br>		The period when the black screen appears is determined empirically and is confirmed on-site. The responsibility of finding the cause of the problem falls on technical specialists.
	~~Период появления черного экрана определяется опытным путём и подтверждает по факту у точки~~. ~~Поиск причины проблемы перекладывается на плечи технических специалистов~~.
	~~</div>~~
	<div lang="ru" dir="ltr" class="mw-content-ltr">		<div lang="ru" dir="ltr" class="mw-content-ltr">
	== '''Концепт решения''' ==		== '''Концепт решения''' ==

N.Bloshkin: Новая страница: «Black Screen Detector (System Administrator)»

2023-08-08T14:26:43Z

Новая страница: «Black Screen Detector (System Administrator)»

Новая страница

== '''Situation Description''' ==
Users are experiencing issues with broadcasts on their devices. When playing content on some devices, a "black" screen appears. This problem can be observed in the user's personal account or at the device's location.
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Причина''' ==
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать, но отображает только "Чёрный" экран.<br>
Эта ситуация возникает из-за различных ошибок при запуске трансляции. Причины таких проблем могут быть разными, и их очень сложно обнаружить.<br>
В качестве причины может выступать любое действие:
* Пользователь загружает видео, но это видео использует неподдерживаемый системой кодек. Тогда видео просто не может запуститься и показывает черный экран. Бывает проблемы, связанные с клиентским приложением (баг), и из-за этого начинаются проблемы с трансляцией.
* Пока есть наличие постоянной, стабильной сети – все работает отлично. Как только устройство теряет доступ к сети (по любой причине) – трансляция прерывается и появляется чёрный экран.
[[File:Пример черного экрана в ЛК.png|thumb|Пример отображения "Чёрного" экрана в личном кабинете пользователя|500px]]
=== '''Систематичность проблемы''' ===
"Чёрный" экран очень несложно отследить и подтвердить визуально. В этом случае хорошо помогает личный кабинет.<br>
Проблема ситуации в том, что он не несет в себе систематичности по времени и может появляться как раз в месяц, так и раз в несколько дней или часов.<br>
Период появления черного экрана определяется опытным путём и подтверждает по факту у точки. Поиск причины проблемы перекладывается на плечи технических специалистов.
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Концепт решения''' ==
Для решения проблемы было решено создать автоматический «Детектор» черного экрана. Он уведомляет о проблемах с контентом на устройстве и оповещает о случившейся ситуации в личном кабинете.<br>
{{Note|Данный функционал не доступен пользователю в личном кабинете. Его необходимо включать отдельно.|warn}}
=== '''Принцип действия''' ===
У каждого клиента/компании есть свой ID связанный с сервером. ID указан в личном кабинете и к нему привязываются все устройства компании.<br>
После запуска функционала сервер с определенным промежутком по времени отправляет на устройства «ивент».<br>
Запуская «ивент» устройство с помощью детектора проверяет наличие "черного" экрана, делая скриншот во время запуска.<br>
После запуска детектора возможно получить два определенных результата:
* После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
* После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент".<br>
'''Промежуток для повторной отправки "ивента" составляет 10 секунд.'''<br>
Если же и во второй раз отправляется черный экран, то со стороны сервера отправляется письмо на почту, о наличии проблемы.
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
=== '''Подготовка ''' ===
Системный администратор должен настроить серверное приложение по двум параметрам:
* Запуск и функционирование детектора "чёрного" экрана
* Настройка отправки письма с ошибкой на почту
=== '''Принцип действия ''' ===
Если серверное приложение обнаружило черный экран, оно отправляет на почту письмо.
Итогом этой проверки станет сообщение на почту с оповещение о проблеме. <br>
Для подтверждения проверки работоспособности функционала через личный кабинет системный администратор может поставить черную картинку. Сервер продолжает отправляет оповещения пока проблема не будет исправлена или же пока не будет выключен функционал.<br>
Впоследствии системный администратор должен принять меры для устранения проблемы.
=== '''Тонкости и нюансы при работе функционала''' ===
1. Для правильного работы необходимо чтобы placeholder с белой точкой воспринимался как черный экран. Поэтому используется не абсолютная проверка.<br>
2. '''Актуально только при проигрывании видео.''' При наличии root прав на устройстве – детектор работает нормально. Но, если, на устройстве нет root прав, детектор не сможет сделать скриншот.<br>
'''Исключения:'''<br>
Скриншот доступен:
* Если приложение подписано «подписью разработчика» (уровень прав – Signage).
* Некоторые устройства (Vestel, Hikvision, Phillips) могут сделать скриншот без root прав из-за особенностей прошивки.
3. Если пользователь попробует сделать скриншот без root прав, то создается «пустой скриншот» с надписью «Идёт воспроизведение видео. Отсутствуют права для снятия скриншота».<br>
4. Информация от сервера к разработчикам отправляется через "ивент". Внутри отправленного «ивента» сервер ждет callback от разработчиков.<br>
5. Тайм – аут “Callback” по умолчанию на сервере составляет – 30 секунд.
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Реализация''' ==
=== '''Активация''' ===
По умолчанию детектор для всех компаний отключен на сервере, так как создает на него слишком большую нагрузку.
{{Note|Включается детектор только по запросу со стороны компании, у которой появилась проблема с чёрным экраном.|warn}}
=== '''Алгоритм действия''' ===
Вся работа будет вестись в два этапа.<br>
'''Первый этап - это запуск самого детектора'''.<br>
При запуске детектора нужно использовать id компании, который указан в личном кабинете. [[File:ID компании.png|thumb|Расположение ID компании в личном кабинете |300px]]
Для этого нужно зайти в профиль и развернуть подробную информацию о пользователе.
Системному администратору нужно подключиться на сервер, через '''Command Line Interface (CLI)'''.<br>
<div style="border: 1px solid #888; padding: 10px; margin: 10px 0; background-color: #f9f9f9;">
При включении CLI сервер получает определенные данные для настройки:<br>
Это:
* ID компании, для которой включаем детектор
* Можно передать платформу (или несколько платформ), для которой необходимо запустить мониторинг.
Например: передаем параметр "ANDROID" и мониторинг включается только для устройств "ANDROID".
* E-mail адрес или несколько адресов на которые должно отправляться уведомление о нештатной ситуации
* Указанное время хранения скриншотов (по умолчанию 3 дня)
</div>
Далее нужно перейти в серверное приложение и выполнить команду:
<code>docker exec -it smartplayer_backend_i bash</code>
[[File:Команда docker.png|thumb|Команда"docker exec -it smartplayer_backend_i bash" |300px]]
На этом этапе попадаем в нашем контейнере с серверным приложением.<br>
Следующей выполняем команду:
<code>Enable screen - screen monitor </code>[[File:Enable screen monitor.png|thumb|Команда"docker exec -it smartplayer_backend_i bash" |300px]]
После очередного этапа система выдает вот такую строку:
Системное сообщение: <code>Input company ID and press Enter</code>[[File:Системное сообщение.png|thumb|Системное сообщение "Input company ID and press Enter:" |300px]]
Выполненная команда отобразит строку в которой просят ввести Id компании.<br>
После ввода ID появляется запрос на мониторинг всех платформ компании. В данном случае выбираем «ДА/Y»
[[File:Мониторинг всех платформ.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]
В последствии консоль потребует указать e-mail на который будут приходить оповещения о проблемах.
Это делается в строке:<br>
<code>Input_email and press enter</code>
[[File:Строка почты.png|thumb|Здесь нужно запустить мониторинг платформ нажав "ДА/Y" |300px]]
{{Note|Указанная почта должна быть привязана к серверу.|warn}}
Также можно указать интервал с которым будут приходить скриншоты (например 1 минута). Строка выглядит так:<br>
<code>Input check interval in minutes (m) or seconds (s) and press "Enter"</code><br>
[[File:Интервал отправки сообщения.png|thumb|Здесь нужно указать время в минутах с префиксом (m) или в секундах с префиксом (S) |300px]]
Далее указываем время либо в секундах с префиксом (s) после числового значения, либо в минутах с префиксом (m) и применяем эту настройку через "Enter". Итогом всех манипуляций будет статус:<br>
<code>Company screen monitoring enabled</code> - выделена зеленым цветом. Это значит что детектор черного экрана запущен.
[[File:Запуск детектора.png|thumb|Оповещение о запуске Детектора выделено зелёным цветом |300px]]
=== '''Уведомления на почту''' ===
Второй этап настройка уведомления, которые приходят на почту. Настройка уведомления подробно прописана в отдельной инструкции [[Настройка отправки писем через серверное приложение SmartPlayer]].<br>
{{Note|При получении сообщения о проблеме на почту, невозможно напрямую из этого уведомления сделать какие либо действия. К примеру «Перезагрузка экрана» или "Остановка трансляции" недоступна.|warn}}
=== '''Предфинальные действия''' ===
В зависимости от результата, системный администратор сможет корректно определить причину и предпринять конкретные действия для устранения ситуации. Если у него не получается решить проблему внутри своей среды или же проблема на нашей стороне, он должен обратиться к команде SmartPlayer.<br>
Это вариант удобен для всех. Так как поможет решить проблемы если они и с нашей стороны (например баг приложения), так и со стороны пользователя (например пользователь неправильно создал трансляцию).
=== '''Важная информация о которой не стоит забывать ''' ===
{{Note|'''Для перезапуска трансляции надо зайти в личный кабинет и перезапустить все вручную'''|warn}}
{{Note|'''Детектор черного экрана на данный момент работает только на Android версии 1.63.1'''|warn}}
</div>
<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''Итоговый результат''' ==
Системный администратор со стороны клиента сможет запустить и настроить функционал детектора и начать решать проблему.
Наличие детектора позволяет контролировать проблемную ситуацию с "Чёрным" экраном и оперативно работать с её исправлением. Это актуально как для нас, так и для сотрудников клиента.
Команда SmartPlayer и команда сотрудников со стороны клиента смогут оперативно взаимодействовать для решения проблемы. <br>
Рядовой пользователь минимизирует негативный опыт взаимодействия с нашим продуктом.
</div>