DebugSmartPlayer/pt: различия между версиями

Материал из SmartPlayer
(Новая страница: «==<span id="IntroduceDebugAndroidOffline"> Faça upload do log de operação (logs) de um dispositivo no sistema operacional Android no modo offline </span> == Se...»)
(Обновление для соответствия новой версии исходной страницы.)
 
(не показано 6 промежуточных версий 2 участников)
Строка 1: Строка 1:
<languages/>
<languages/>
==<span id="IntroduceDebugTools">Ferramentas de depuração </span> ==
==<span id="IntroduceDebugTools">Средства отладки</span>==
A plataforma SmartPlayer fornece muitas ferramentas para depuração quando ocorre uma anormalidade.  
SmartPlayer платформа предоставляет множества инструментов для отладки при возникновении нештатной ситуации.  


==<span id="DebugGetLogs">Recebendo registro do dispositivo (registros) </span> ==
==<span id="DebugGetLogs">Получение журнала с устройства (логи) </span>==
Cada aplicativo cliente grava um log de eventos em sua memória interna do dispositivo, se necessário, ele pode ser obtido e enviado para análise ao suporte técnico SmartPLayer, a fim de obter os logs mais úteis, faça o seguinte:
[[Файл:Get logs 1.png|мини]]
# Nas configurações do dispositivo (Selecionar dispositivo -> nas Configurações da barra de ferramentas à direita), quando estiver online (verde), ative o modo de registro de depuração ou rastreamento. Isso configurará o dispositivo para que ele grave mensagens mais detalhadas sobre seu trabalho.
[[Файл:Get logs 2.png|мини]]
# Tente reproduzir a situação anormal no dispositivo
Каждое клиентское приложение пишет журнал событий в свою внутреннею память устройства, при необходимости его можно получить и отправить для анализа в техническую поддержку SmartPLayer, чтобы получить максимально полезные логи сделайте следующие действия:
# Vá para o cartão do dispositivo (Selecione o dispositivo -> na barra de ferramentas à direita Informações) e baixe o arquivo com o log.
# В настройках устройства (Выбрать устройство -> В правом тулбаре Настройки), когда оно в онлайн статусе (зеленое) включите режим логирования Debug или Trace. Этим вы настроите устройство, чтобы оно писала более детальные сообщения по своей работе
Existem dois parâmetros:
# Постарайтесь воспроизвести нештатную ситуацию на устройстве
* '''atual''' - o arquivo com o log de eventos do dia atual será descarregado, como resultado de seu tamanho menor. Se a rede estiver instável, a melhor escolha.
# Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и выгрузите архив с журналом.
* '''full''' - o arquivo com o log de eventos por vários dias será descarregado. Pode transmitir uma grande quantidade de dados, a rede deve ser mais estável.


==<span id="ClearDevice">Limpando o dispositivo </span> ==
Существует два параметра:  
A limpeza do dispositivo permite excluir todos os dados do aplicativo registrados com o software SmartPlayer; essas ações redefinem o cache do aplicativo. Não é necessário registrar novamente o dispositivo. Vá para o cartão do dispositivo (Selecione o dispositivo -> Informações na barra de ferramentas à direita) e clique no ícone "limpar", você terá duas opções:
* '''Excluir todos os arquivos no dispositivo''' - esta opção para excluir arquivos de mídia baixados para reprodução offline de conteúdo. Na próxima vez que você iniciar o aplicativo, se a transmissão atual não estiver armazenada em cache no dispositivo, os arquivos serão baixados novamente.
* '''Limpar armazenamento local''' - esta opção irá deletar os metadados necessários para reprodução offline. Na próxima vez que você iniciar o aplicativo, se não houver metadados suficientes para a transmissão atual, eles serão recebidos do servidor SmartPlayer.


Dependendo do sistema operacional do aplicativo cliente, ele será reinicializado ou reiniciado.
* '''актуальные''' - выгрузится архив с журналом событий за текущий день, как следствие меньшего размера. Если сеть нестабильная, лучший выбор.
* '''полные''' - выгрузится архив с журналом событий за несколько дней. Может передавать большой объём данных, сеть должна быть стабильнее.


==<span id="IntroduceDebugAndroidOffline">
==<span id="GetFullInfoAboutDevice">Получение полных данных об устройстве </span>==
Faça upload do log de operação (logs) de um dispositivo no sistema operacional Android no modo offline </span> ==
Каждое клиентсое приложение содержит полные данные об устройстве, чтобы получить их сделайте следующие действия:
Se o dispositivo não se conectar ao servidor, verifique primeiro o acesso do dispositivo ao servidor. Para fazer isso, basta abrir o navegador embutido no dispositivo Android OS e dirigir no endereço do servidor. Se a conexão for para https://cms.smartplayer.org, digite https://api.smartplayer.org como resultado, a mensagem '''Cannot GET /''' deve aparecer, isso indica que o dispositivo "vê" o servidor.  
# Авторизоваться в личном кабинете с учетными данными
# Перейти в вкладку меню "Устройства"
# Выбрать устройстов (нажав на него или в списке), не галочкой
# Справа откроется меню устройства, выбрать пункт меню Инфорация
# В открытой карточки устройства нажать на значок "копировать в буфер обмена" (в правом верхнем углу)
 
[[Файл:Screenshot from 2024-07-02 13-44-24.png|мини|центр]]
 
Данные скопируются в буфер обмена, для дальнейшей вставки в нужный докмуент.
 
==<span id="DownloadBroadcast">Выгрузить трансляцию</span>==
Для анализа проигрывания трансляции её можно выгрузить из личного кабинета и передать для анализа в компанию SmartPlayer. Для этого сделайте следующие действия:
# Авторизоваться в личном кабинете
# Перейти в пункт меню "Трансляции"
# Выбрать нужную трансляцию
# В правом тулбаре нажать иконку - "Скачать"
 
[[Файл:Screenshot from 2024-07-02 13-51-41.png|мини|центр]]
 
После начала скачивания, в зависимости от размера трансляции ожидаем её скачивание на рабочий компьютер. Далее необходимо без модификации передать архив при заведении заявки на портале технической поддержки.
 
==<span id="ClearDevice">Очистка устройства</span>==
Очистка устройства, позволяет удалить все данные приложения записанные с помощью ПО SmartPlayer, данные действия сбрасывают кеш приложения. Повторная регистрация устройства - не потребуется. Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и нажмите значок "очистить", на выбор будет предложено два параметра:
* '''Удалить все файлы на устройстве''' - данный параметр удалить медиафайлы скаченный для оффлайн проигрывания контента. При следующем запуске приложения, если актуальная трансляция не закеширована на устройстве, произойдет повторное скачивание файлов.
* '''Очистить локальное хранилище''' - данный параметр удалить метаданные необходимые для проигрывания в оффлайн режиме. При следующем запуске приложения, если по актуальной трансляции не хватает метаданных, они будут получены с сервера SmartPlayer.
 
В зависимости от операционной системы клиентского приложения, оно будет или перезагружено или перезапущено.
 
==<span id="IntroduceDebugAndroidOffline">Выгрузить журнал работы (логи) устройства на Android OS в оффлайн режиме</span>==
Если устройства не подключается к серверу, проверьте вначале доступ устройства к серверу. Для этого достаточно, открыть встроенный браузер на Android OS устройстве и вбить адрес сервера. Если подключение идет к https://cms.smartplayer.org, то вбейте https://api.smartplayer.org в результате должно показаться сообщение '''Cannot GET /''', это говорит о том, что устройство "видит" сервер.  


Если после проверки устройство остается оффлайн в личном кабинете (серым), можно забрать логи локально с устройства для последующей передачи их в тех. поддержку SmartPlayer. Для этого установите (или воспользуйтесь стандартным) файловым менеджером (например: [https://play.google.com/store/apps/details?id=com.File.Manager.Filemanager&hl=ru&gl=US ES File Manager]), чтобы пройти по пути:<br> '''/sdcard/Android/data/org.smartplayer.android.client/files/Logs/*''' <br>
Если после проверки устройство остается оффлайн в личном кабинете (серым), можно забрать логи локально с устройства для последующей передачи их в тех. поддержку SmartPlayer. Для этого установите (или воспользуйтесь стандартным) файловым менеджером (например: [https://play.google.com/store/apps/details?id=com.File.Manager.Filemanager&hl=ru&gl=US ES File Manager]), чтобы пройти по пути:<br> '''/sdcard/Android/data/org.smartplayer.android.client/files/Logs/*''' <br>
Вставьте флешку (пердварительно отформатировав в fat32) в устройство и скопируйте содержимое всей папки. Далее передайте данные файлы в технический отдел SmartPlayer.
Вставьте флешку (предварительно отформатировав в fat32) в устройство и скопируйте содержимое всей папки. Далее передайте данные файлы в технический отдел SmartPlayer.


==<span id="selfIdentificationdevice">Определить к какой учетной записи принадлежит устройство (идетификация устройства)</span>==
==<span id="selfIdentificationdevice">Определить к какой учетной записи принадлежит устройство (идентификация устройства)</span>==
Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"1"''' на пульте, приложение покажет интерфейс в котором:  
Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"1"''' на пульте, приложение покажет интерфейс в котором:  
# Указано имя устройства (аналогично как в личном кабинете)
# Указано имя устройства (аналогично как в личном кабинете)
Строка 36: Строка 62:
Поддержка платформ: WebOS/SSSP/BrightSign
Поддержка платформ: WebOS/SSSP/BrightSign


==<span id="localDebugConsole">Отображение локальной консоли</span>==
==<span id="localDebugConsoleJS">Отображение локальной консоли</span>==
Иногда не понятно, что происходит с устройством и нет возможности получить логи через личный кабинет, тогда необходимо запустить локальную консоль отладки, для получения сообщений о проблеме. [[File:info.png|20px]] [[DebugSmartPlayer#IntroduceDebugAndroidOffline|В случае с Android OS]]
Иногда не понятно, что происходит с устройством и нет возможности получить логи через личный кабинет, тогда необходимо запустить локальную консоль отладки, для получения сообщений о проблеме. [[File:info.png|20px]] [[DebugSmartPlayer#IntroduceDebugAndroidOffline|В случае с Android OS]]
<br>
<br>
Для локальной консоли устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"Blue"''' на пульте, далее необходимо сфотографировать в хорошем разрешении (чтобы читались строки) и прислать фото в support@smartplayer.org.<br>
Начиная с версии v1.33.*, логирование на устройстве по умолчанию отключено. Для включения логирования нажмите на пульте кнопку '''"Green"''', далее откройте локальную консоль. <br>
 
Для открытия локальной консоли устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"Blue"''' на пульте, далее необходимо сфотографировать в хорошем разрешении (чтобы читались строки) и прислать фото в support@smartplayer.org или сотруднику тех. поддержки SmartPlayer <br>
 
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"Blue"''' на пульте <br>
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"Blue"''' на пульте <br>
Поддержка платформ: WebOS/SSSP/BrightSign <br>
Поддержка платформ: WebOS/SSSP/BrightSign <br>


[[Файл:InfoDeviceDebugConsole.png|обрамить]]
[[Файл:InfoDeviceDebugConsole.png]]


==<span id="localDebugConsoleBrowser">Получение отладочных сообщений от личного кабинета</span>==
==<span id="localDebugConsoleBrowser">Получение отладочных сообщений от личного кабинета</span>==
Для анализа, что происходит в личном кабинете достаточно предоставить информацию с двух вкладок инструментов отладки браузера (Network и Console). Откройте в браузере Google Chrome инструменты отладки, нажав F12, далее произведите действие которое вызывает непонятное поведение. После этого сфотографируйте в читаемом качестве вкладки Network и Console. Далее пришлите данные на support@smartplayer.org или ответственному человеку за поддержку в вашем случае.
Для анализа, что происходит в личном кабинете достаточно предоставить информацию с двух вкладок инструментов отладки браузера (Network и Console). Откройте в браузере Google Chrome инструменты отладки, нажав F12, далее произведите действие которое вызывает непонятное поведение. После этого скопируйте в текстовый файл вкладки Network и Console. Далее пришлите данные на support@smartplayer.org или ответственному человеку за поддержку в вашем случае в системе технической поддержки.
[[Файл:DebugConsoleBrowser.png|мини|центр]]


==<span id="howIcanGetServerUrl">Как узнать адрес / версию серверного в платформе и личного кабинета SmartPlayer</span>==
Для определения адреса серверного приложения, необходимо зайти в личный кабинет
[[Файл:Screenshot from 2024-06-03 17-56-18.jpg|безрамки|центр]]
и перейти в вкладку "Настройки", прокрутить вниз страницы и нажать гиперссылку "О программном обеспечении".
[[Файл:Screenshot from 2024-06-03 17-58-21.png|безрамки|центр]]


[[Файл:DebugConsoleBrowser.png|мини|центр]]
Вы попадете на страницу, где есть таблица и удобная кнопка чтобы её скопировать. Нажмите кнопку "Скопировать таблицу" и передайте информацию сотруднику запросившему её.
[[Файл:Screenshot from 2024-06-03 17-59-23.png|безрамки|центр]]

Текущая версия от 16:53, 6 октября 2024

Другие языки:

Средства отладки

SmartPlayer платформа предоставляет множества инструментов для отладки при возникновении нештатной ситуации.

Получение журнала с устройства (логи)

Каждое клиентское приложение пишет журнал событий в свою внутреннею память устройства, при необходимости его можно получить и отправить для анализа в техническую поддержку SmartPLayer, чтобы получить максимально полезные логи сделайте следующие действия:

  1. В настройках устройства (Выбрать устройство -> В правом тулбаре Настройки), когда оно в онлайн статусе (зеленое) включите режим логирования Debug или Trace. Этим вы настроите устройство, чтобы оно писала более детальные сообщения по своей работе
  2. Постарайтесь воспроизвести нештатную ситуацию на устройстве
  3. Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и выгрузите архив с журналом.

Существует два параметра:

  • актуальные - выгрузится архив с журналом событий за текущий день, как следствие меньшего размера. Если сеть нестабильная, лучший выбор.
  • полные - выгрузится архив с журналом событий за несколько дней. Может передавать большой объём данных, сеть должна быть стабильнее.

Получение полных данных об устройстве

Каждое клиентсое приложение содержит полные данные об устройстве, чтобы получить их сделайте следующие действия:

  1. Авторизоваться в личном кабинете с учетными данными
  2. Перейти в вкладку меню "Устройства"
  3. Выбрать устройстов (нажав на него или в списке), не галочкой
  4. Справа откроется меню устройства, выбрать пункт меню Инфорация
  5. В открытой карточки устройства нажать на значок "копировать в буфер обмена" (в правом верхнем углу)

Данные скопируются в буфер обмена, для дальнейшей вставки в нужный докмуент.

Выгрузить трансляцию

Для анализа проигрывания трансляции её можно выгрузить из личного кабинета и передать для анализа в компанию SmartPlayer. Для этого сделайте следующие действия:

  1. Авторизоваться в личном кабинете
  2. Перейти в пункт меню "Трансляции"
  3. Выбрать нужную трансляцию
  4. В правом тулбаре нажать иконку - "Скачать"

После начала скачивания, в зависимости от размера трансляции ожидаем её скачивание на рабочий компьютер. Далее необходимо без модификации передать архив при заведении заявки на портале технической поддержки.

Очистка устройства

Очистка устройства, позволяет удалить все данные приложения записанные с помощью ПО SmartPlayer, данные действия сбрасывают кеш приложения. Повторная регистрация устройства - не потребуется. Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и нажмите значок "очистить", на выбор будет предложено два параметра:

  • Удалить все файлы на устройстве - данный параметр удалить медиафайлы скаченный для оффлайн проигрывания контента. При следующем запуске приложения, если актуальная трансляция не закеширована на устройстве, произойдет повторное скачивание файлов.
  • Очистить локальное хранилище - данный параметр удалить метаданные необходимые для проигрывания в оффлайн режиме. При следующем запуске приложения, если по актуальной трансляции не хватает метаданных, они будут получены с сервера SmartPlayer.

В зависимости от операционной системы клиентского приложения, оно будет или перезагружено или перезапущено.

Выгрузить журнал работы (логи) устройства на Android OS в оффлайн режиме

Если устройства не подключается к серверу, проверьте вначале доступ устройства к серверу. Для этого достаточно, открыть встроенный браузер на Android OS устройстве и вбить адрес сервера. Если подключение идет к https://cms.smartplayer.org, то вбейте https://api.smartplayer.org в результате должно показаться сообщение Cannot GET /, это говорит о том, что устройство "видит" сервер.

Если после проверки устройство остается оффлайн в личном кабинете (серым), можно забрать логи локально с устройства для последующей передачи их в тех. поддержку SmartPlayer. Для этого установите (или воспользуйтесь стандартным) файловым менеджером (например: ES File Manager), чтобы пройти по пути:
/sdcard/Android/data/org.smartplayer.android.client/files/Logs/*
Вставьте флешку (предварительно отформатировав в fat32) в устройство и скопируйте содержимое всей папки. Далее передайте данные файлы в технический отдел SmartPlayer.

Определить к какой учетной записи принадлежит устройство (идентификация устройства)

Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку "1" на пульте, приложение покажет интерфейс в котором:

  1. Указано имя устройства (аналогично как в личном кабинете)
  2. Список учетных записей участвующих в компании, для которой зарегистрировано устройство
  3. Через какое время будет скрыта информация (в секундах)

Интерфейс можно скрыть, не дожидаясь таймера нажав "2" на пульте
Поддержка платформ: WebOS/SSSP/BrightSign

Отображение локальной консоли

Иногда не понятно, что происходит с устройством и нет возможности получить логи через личный кабинет, тогда необходимо запустить локальную консоль отладки, для получения сообщений о проблеме. В случае с Android OS
Начиная с версии v1.33.*, логирование на устройстве по умолчанию отключено. Для включения логирования нажмите на пульте кнопку "Green", далее откройте локальную консоль.

Для открытия локальной консоли устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку "Blue" на пульте, далее необходимо сфотографировать в хорошем разрешении (чтобы читались строки) и прислать фото в support@smartplayer.org или сотруднику тех. поддержки SmartPlayer

Интерфейс можно скрыть, не дожидаясь таймера нажав "Blue" на пульте
Поддержка платформ: WebOS/SSSP/BrightSign

Получение отладочных сообщений от личного кабинета

Для анализа, что происходит в личном кабинете достаточно предоставить информацию с двух вкладок инструментов отладки браузера (Network и Console). Откройте в браузере Google Chrome инструменты отладки, нажав F12, далее произведите действие которое вызывает непонятное поведение. После этого скопируйте в текстовый файл вкладки Network и Console. Далее пришлите данные на support@smartplayer.org или ответственному человеку за поддержку в вашем случае в системе технической поддержки.

Как узнать адрес / версию серверного в платформе и личного кабинета SmartPlayer

Для определения адреса серверного приложения, необходимо зайти в личный кабинет

и перейти в вкладку "Настройки", прокрутить вниз страницы и нажать гиперссылку "О программном обеспечении".

Вы попадете на страницу, где есть таблица и удобная кнопка чтобы её скопировать. Нажмите кнопку "Скопировать таблицу" и передайте информацию сотруднику запросившему её.

Источник — https://wiki.smartplayer.org/index.php?title=DebugSmartPlayer/pt&oldid=14280