Детектор черного экрана: различия между версиями

Материал из SmartPlayer
Отметить эту версию для перевода
Нет описания правки
 
(не показано 12 промежуточных версий 2 участников)
Строка 2: Строка 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
=== '''Описание ситуации''' ===
{{Note|Версия документации по функционалу для системных администраторов доступна по [https://wiki.smartplayer.org/index.php/%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) ссылке]|warn}}
У пользователя начались проблемы с трансляциями. Во время воспроизведения трансляций на устройствах контент прерывается и появляется «чёрный экран. Из-за пользователь недоволен нашей работой и продуктом.
=== '''Описание функции''' ===
</translate>
Функция детектора предназначена для определения внештатных ситуаций таких как возникновение черных экранов на устройствах, при этом система не обязательно находится в состояние ошибки, возможны ситуации с неправильным планированием трансляции, ошибкой менеджера или проблемами с каналом связи которые приводят к невозможности закачки контента до момента старта трансляции. Детектор черных экранов может определить подобную ситуацию и послать уведомления на почту пользователя/администратора системы для скорейшего устранения проблемы.
<translate>
[[File:Пример черного экрана в ЛК.png|thumb|Пример отображения "Чёрного" экрана в личном кабинете пользователя|700px]]
<!--T:2-->
 
 
=== '''Причина''' ===
=== '''Причина''' ===
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать. <br>
В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать. <br>
Причины этой проблемы могут быть разными. От неподдерживаемых кодеков используемых в видео, до проблем с потерей соединения с сетью.<br>
Причины этой проблемы могут быть разными. От неподдерживаемых кодеков используемых в видео, до проблем с потерей соединения с сетью.<br>
Поэтому было решено сделать автоматизированное решение, которое поможет более оперативно оповещать и работать с этой проблемой.
Поэтому было решено сделать автоматизированное решение, которое поможет более оперативно оповещать и работать с этой проблемой.
</translate>
 
<translate>
<!--T:3-->
<!--T:3-->
=== '''Концепт решения''' ===
=== '''Концепт решения''' ===
Для решения проблемы и ее автоматизации было решено создать «Детектор черных экранов». Его функция – заранее предупреждать нас о случившейся на конкретном устройстве проблеме.  Этот функционал позволяет работать нам проактивно и не ждать оповещения о проблеме от клиента.
Для решения проблемы и ее автоматизации было решено создать «Детектор черных экранов». Его функция – заранее предупреждать нас о случившейся на конкретном устройстве проблеме.  Этот функционал позволяет работать нам проактивно и не ждать оповещения о проблеме от клиента.
{{Note|Данный функционал не доступен пользователю в личном кабинете. Обратитесь для его включения к системному администратору.|warn}}
{{Note|Данный функционал не доступен пользователю в личном кабинете. Обратитесь для его включения к системному администратору.|warn}}
</translate>
 
<translate>
<!--T:4-->
<!--T:4-->
=== '''Принципе действия''' ===
=== '''Принцип действия''' ===
Детектор работает со всеми компаниями, которые используют наше ПО. По умолчанию он выключен и включается только на конкретную компанию.<br>
Детектор работает со всеми компаниями, которые используют наше ПО. По умолчанию он выключен и включается только на конкретную компанию.<br>
   
   
У каждого компании работающей в нашем приложении есть свой персональный ID. Его можно найти в личном кабинете. К этому ID привязываются все устройства компании.<br>
У каждого компании работающей в нашем приложении есть свой персональный ID. Его можно найти в личном кабинете. К этому ID привязываются все устройства компании. Для запуска "детектора" - знание этого параметра необходимо.<br>
При возникновении ошибки с «чёрным» экраном, на одном или нескольких устройствах наш сервер отправляет «ивент» на эти устройства. Устройство этот «ивент» запускает. В момент запуска «ивента» «детектор» делает скриншот. И по этому скриншоту проверяется наличие «черного» экрана.<br>
При возникновении ошибки с «чёрным» экраном, на одном или нескольких устройствах наш сервер отправляет «ивент» на эти устройства. Устройство этот «ивент» запускает. В момент запуска «ивента» «детектор» делает скриншот. И по этому скриншоту проверяется наличие «черного» экрана.<br>
После запуска детектора возможно получить два вида ответа:
После запуска детектора возможно получить два вида ответа:
# После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
# После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
# После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент". Промежуток для повторной отправки составляет 10 секунд.
# После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент". Промежуток для повторной отправки составляет 10 секунд.
Если вариант «2» подтверждает наличие проблемы, то со стороны сервера отправляется уведомление на почту.  
В случае, если подтверждается второй вариант, то со стороны сервера отправляется уведомление на почту.  
{{Note|Указанная почта должна обязательно должна быть привязана к серверу, иначе уведомления о проблеме приходить не будут.|warn}}
{{Note|Указанная почта должна обязательно должна быть привязана к серверу, иначе уведомления о проблеме приходить не будут.|warn}}
Также пользователь может настроить отправку оповещений о черном экране через Telegram. Данное решение можно использовать настроив по инструкции [https://wiki.smartplayer.org/index.php/%D0%A3%D0%B2%D0%B5%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BE_%D1%87%D0%B5%D1%80%D0%BD%D0%BE%D0%BC_%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B5_%D1%87%D0%B5%D1%80%D0%B5%D0%B7_Telegram здесь]


<!--T:5-->
=== '''Итоговый результат''' ===
=== '''Итоговый результат''' ===
После получения информации о проблеме начинается оперативное ее решение. Таким образом мы всегда знаем о проблеме первые и не заставляем лишний раз беспокоиться наших клиентов.
После получения информации о проблеме начинается оперативное ее решение. Таким образом мы всегда знаем о проблеме первые и не заставляем лишний раз беспокоиться наших клиентов.
=== '''Подробности''' ===
Более подробно можно будет ознакомиться с проблемой в версии документа:
</translate>
</translate>

Текущая версия от 14:06, 15 января 2026

Версия документации по функционалу для системных администраторов доступна по ссылке

Описание функции

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

Пример отображения "Чёрного" экрана в личном кабинете пользователя


Причина

В устройствах, работающих на местах во время проигрывания контента, появляется «чёрный экран». При этом трансляция в личном кабинете продолжает работать.
Причины этой проблемы могут быть разными. От неподдерживаемых кодеков используемых в видео, до проблем с потерей соединения с сетью.
Поэтому было решено сделать автоматизированное решение, которое поможет более оперативно оповещать и работать с этой проблемой.

Концепт решения

Для решения проблемы и ее автоматизации было решено создать «Детектор черных экранов». Его функция – заранее предупреждать нас о случившейся на конкретном устройстве проблеме. Этот функционал позволяет работать нам проактивно и не ждать оповещения о проблеме от клиента.

Данный функционал не доступен пользователю в личном кабинете. Обратитесь для его включения к системному администратору.

Принцип действия

Детектор работает со всеми компаниями, которые используют наше ПО. По умолчанию он выключен и включается только на конкретную компанию.

У каждого компании работающей в нашем приложении есть свой персональный ID. Его можно найти в личном кабинете. К этому ID привязываются все устройства компании. Для запуска "детектора" - знание этого параметра необходимо.
При возникновении ошибки с «чёрным» экраном, на одном или нескольких устройствах наш сервер отправляет «ивент» на эти устройства. Устройство этот «ивент» запускает. В момент запуска «ивента» «детектор» делает скриншот. И по этому скриншоту проверяется наличие «черного» экрана.
После запуска детектора возможно получить два вида ответа:

  1. После запуска «ивента» черного экрана нет - система продолжает работу в штатном режиме.
  2. После запуска «ивента» чёрный экран обнаружен - сервер отправляет повторный, проверочный "ивент". Промежуток для повторной отправки составляет 10 секунд.

В случае, если подтверждается второй вариант, то со стороны сервера отправляется уведомление на почту.

Указанная почта должна обязательно должна быть привязана к серверу, иначе уведомления о проблеме приходить не будут.

Также пользователь может настроить отправку оповещений о черном экране через Telegram. Данное решение можно использовать настроив по инструкции здесь

Итоговый результат

После получения информации о проблеме начинается оперативное ее решение. Таким образом мы всегда знаем о проблеме первые и не заставляем лишний раз беспокоиться наших клиентов.