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

Материал из SmartPlayer
(Новая страница: «The interface can be hidden without waiting for the timer by pressing '''"Blue"''' on the remote control <br> Supported platforms: WebOS/SSSP/BrightSign <br>»)
(Обновление для соответствия новой версии исходной страницы.)
Строка 1: Строка 1:
<languages/>
<languages/>
==<span id="IntroduceDebugTools">Debugging Tools </span> ==
==<span id="IntroduceDebugTools">Средства отладки</span>==
SmartPlayer platform provides many tools for debugging when an abnormality occurs.  
SmartPlayer платформа предоставляет множества инструментов для отладки при возникновении нештатной ситуации.  


==<span id="DebugGetLogs">
==<span id="DebugGetLogs">Получение журнала с устройства (логи) </span>==
Receiving log from device (logs) </span> ==
[[Файл:Get logs 1.png|мини]]
Each client application writes an event log to its internal memory of the device, if necessary, it can be obtained and sent for analysis to SmartPLayer technical support, in order to get the most useful logs, do the following:
[[Файл:Get logs 2.png|мини]]
# In the device settings (Select device -> In the right toolbar Settings), when it is online (green), enable the Debug or Trace logging mode. This will configure the device so that it writes more detailed messages about its work.
Каждое клиентское приложение пишет журнал событий в свою внутреннею память устройства, при необходимости его можно получить и отправить для анализа в техническую поддержку SmartPLayer, чтобы получить максимально полезные логи сделайте следующие действия:
# Try to reproduce the abnormal situation on the device
# В настройках устройства (Выбрать устройство -> В правом тулбаре Настройки), когда оно в онлайн статусе (зеленое) включите режим логирования Debug или Trace. Этим вы настроите устройство, чтобы оно писала более детальные сообщения по своей работе
# Go to the device card (Select device -> In the right toolbar Information) and download the archive with the log.
# Постарайтесь воспроизвести нештатную ситуацию на устройстве
# Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и выгрузите архив с журналом.


There are two parameters:  
Существует два параметра:  


* '''current''' - the archive with the event log for the current day will be unloaded, as a result of its smaller size. If the network is unstable, the best choice.
* '''актуальные''' - выгрузится архив с журналом событий за текущий день, как следствие меньшего размера. Если сеть нестабильная, лучший выбор.
* '''full''' - the archive with the event log for several days will be unloaded. It can transmit a large amount of data, the network should be more stable.
* '''полные''' - выгрузится архив с журналом событий за несколько дней. Может передавать большой объём данных, сеть должна быть стабильнее.


==<span id="GetFullInfoAboutDevice">Getting full device information </span>==
==<span id="GetFullInfoAboutDevice">Получение полных данных об устройстве </span>==
Each client application contains full device information, to get it, do the following:
Каждое клиентсое приложение содержит полные данные об устройстве, чтобы получить их сделайте следующие действия:
# Log in to your account with your credentials
# Авторизоваться в личном кабинете с учетными данными
# Go to the "Devices" menu tab
# Перейти в вкладку меню "Устройства"
# Select a device (by clicking on it or in the list), without checking the box
# Выбрать устройстов (нажав на него или в списке), не галочкой
# The device menu will open on the right, select the Information menu item
# Справа откроется меню устройства, выбрать пункт меню Инфорация
# In the open device card, click on the "copy to clipboard" icon (in the upper right corner)
# В открытой карточки устройства нажать на значок "копировать в буфер обмена" (в правом верхнем углу)


[[Файл:Screenshot from 2024-07-02 13-44-24.png|мини|центр]]
[[Файл:Screenshot from 2024-07-02 13-44-24.png|мини|центр]]


The data is copied to the clipboard for further pasting into the required document.
Данные скопируются в буфер обмена, для дальнейшей вставки в нужный докмуент.


==<span id="DownloadBroadcast">Download broadcast</span>==
==<span id="DownloadBroadcast">Выгрузить трансляцию</span>==
To analyze the broadcast playback, you can download it from your personal account and send it to SmartPlayer for analysis. To do this, do the following:
Для анализа проигрывания трансляции её можно выгрузить из личного кабинета и передать для анализа в компанию SmartPlayer. Для этого сделайте следующие действия:  
# Log in to your personal account
# Авторизоваться в личном кабинете
# Go to the "Broadcasts" menu item
# Перейти в пункт меню "Трансляции"
# Select the desired broadcast
# Выбрать нужную трансляцию
# In the right toolbar, click the icon - "Download"
# В правом тулбаре нажать иконку - "Скачать"


[[Файл:Screenshot from 2024-07-02 13-51-41.png|мини|центр]]
[[Файл:Screenshot from 2024-07-02 13-51-41.png|мини|центр]]


After the download starts, depending on the size of the broadcast, we wait for it to download to the working computer. Then you need to transfer the archive without modification when you open a request on the technical support portal.
После начала скачивания, в зависимости от размера трансляции ожидаем её скачивание на рабочий компьютер. Далее необходимо без модификации передать архив при заведении заявки на портале технической поддержки.


==<span id="ClearDevice">
==<span id="ClearDevice">Очистка устройства</span>==
Cleaning the device </span> ==
Очистка устройства, позволяет удалить все данные приложения записанные с помощью ПО SmartPlayer, данные действия сбрасывают кеш приложения. Повторная регистрация устройства - не потребуется. Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и нажмите значок "очистить", на выбор будет предложено два параметра:  
Cleaning the device, allows you to delete all application data recorded using the SmartPlayer software, these actions reset the application cache. Re-registering the device is not required. Go to the device card (Select device -> Information in the right toolbar) and click the "clear" icon, you will be offered two options:
* '''Удалить все файлы на устройстве''' - данный параметр удалить медиафайлы скаченный для оффлайн проигрывания контента. При следующем запуске приложения, если актуальная трансляция не закеширована на устройстве, произойдет повторное скачивание файлов.  
* '''Delete all files on the device''' - this option to delete media files downloaded for offline playback of content. The next time you launch the application, if the current broadcast is not cached on the device, the files will be downloaded again.
* '''Очистить локальное хранилище''' - данный параметр удалить метаданные необходимые для проигрывания в оффлайн режиме. При следующем запуске приложения, если по актуальной трансляции не хватает метаданных, они будут получены с сервера SmartPlayer.  
* '''Clear local storage''' - this option will delete the metadata required for offline playback. The next time you launch the application, if there is not enough metadata for the current broadcast, it will be received from the SmartPlayer server.  


Depending on the client application's operating system, it will either reboot or restart.
В зависимости от операционной системы клиентского приложения, оно будет или перезагружено или перезапущено.


==<span id="IntroduceDebugAndroidOffline">Download the log of the Android OS device in offline mode</span>==
==<span id="IntroduceDebugAndroidOffline">Выгрузить журнал работы (логи) устройства на Android OS в оффлайн режиме</span>==
If the device does not connect to the server, first check the device's access to the server. To do this, simply open the built-in browser on the Android OS device and enter the server address. If the connection goes to https://cms.smartplayer.org, then enter https://api.smartplayer.org as a result, the message '''Cannot GET /''' should appear, this means that the device "sees" the server.  
Если устройства не подключается к серверу, проверьте вначале доступ устройства к серверу. Для этого достаточно, открыть встроенный браузер на Android OS устройстве и вбить адрес сервера. Если подключение идет к https://cms.smartplayer.org, то вбейте https://api.smartplayer.org в результате должно показаться сообщение '''Cannot GET /''', это говорит о том, что устройство "видит" сервер.  


If after checking the device remains offline in your account (gray), you can collect logs locally from the device for subsequent transfer to SmartPlayer technical support. To do this, install (or use the standard) file manager (for example: [https://play.google.com/store/apps/details?id=com.File.Manager.Filemanager&hl=ru&gl=US ES File Manager]) to follow the path:<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>
Insert the flash drive (pre-formatted in fat32) into the device and copy the contents of the entire folder. Then transfer these files to the SmartPlayer technical department.
Вставьте флешку (предварительно отформатировав в fat32) в устройство и скопируйте содержимое всей папки. Далее передайте данные файлы в технический отдел SmartPlayer.


==<span id="selfIdentificationdevice">Determine which account the device belongs to (device identification)</span>==
==<span id="selfIdentificationdevice">Определить к какой учетной записи принадлежит устройство (идентификация устройства)</span>==
To identify the device from the remote control, you need to unlock the device (if the remote control is locked) and press the '''"1"''' button on the remote control, the application will show an interface in which:
Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"1"''' на пульте, приложение покажет интерфейс в котором:  
# The device name is indicated (similar to the personal account)
# Указано имя устройства (аналогично как в личном кабинете)
# List of accounts participating in the company for which the device is registered
# Список учетных записей участвующих в компании, для которой зарегистрировано устройство
# After what time the information will be hidden (in seconds)
# Через какое время будет скрыта информация (в секундах)
[[Файл:InfoDevice.png|250px|обрамить]]
[[Файл:InfoDevice.png|250px|обрамить]]


The interface can be hidden without waiting for the timer by pressing '''"2"''' on the remote control <br>
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"2"''' на пульте <br>
Supported platforms: WebOS/SSSP/BrightSign
Поддержка платформ: WebOS/SSSP/BrightSign


==<span id="localDebugConsoleJS">Displaying the local console</span>==
==<span id="localDebugConsoleJS">Отображение локальной консоли</span>==
Sometimes it is not clear what is happening with the device and there is no way to get logs through your personal account, then you need to run the local debug console to get messages about the problem. [[File:info.png|20px]] [[DebugSmartPlayer#IntroduceDebugAndroidOffline|In the case of Android OS]]
Иногда не понятно, что происходит с устройством и нет возможности получить логи через личный кабинет, тогда необходимо запустить локальную консоль отладки, для получения сообщений о проблеме. [[File:info.png|20px]] [[DebugSmartPlayer#IntroduceDebugAndroidOffline|В случае с Android OS]]
<br>
<br>
Starting with version v1.33.*, logging on the device is disabled by default. To enable logging, press the '''"Green"''' button on the remote, then open the local console. <br>  
Начиная с версии v1.33.*, логирование на устройстве по умолчанию отключено. Для включения логирования нажмите на пульте кнопку '''"Green"''', далее откройте локальную консоль. <br>  


To open the local console of the device from the remote control, you need to unlock the device (if the remote control is locked) and press the '''"Blue"''' button on the remote control, then you need to take a photo in good resolution (so that the lines are readable) and send the photo to support@smartplayer.org or to a SmartPlayer technical support employee <br>
Для открытия локальной консоли устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"Blue"''' на пульте, далее необходимо сфотографировать в хорошем разрешении (чтобы читались строки) и прислать фото в support@smartplayer.org или сотруднику тех. поддержки SmartPlayer <br>


The interface can be hidden without waiting for the timer by pressing '''"Blue"''' on the remote control <br>
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"Blue"''' на пульте <br>
Supported platforms: WebOS/SSSP/BrightSign <br>
Поддержка платформ: WebOS/SSSP/BrightSign <br>


[[Файл:InfoDeviceDebugConsole.png]]
[[Файл:InfoDeviceDebugConsole.png]]


==<span id="localDebugConsoleBrowser">Receiving debug messages from your personal account</span>==
==<span id="localDebugConsoleBrowser">Получение отладочных сообщений от личного кабинета</span>==
To analyze what is happening in your personal account, it is enough to provide information from two tabs of the browser debugging tools (Network and Console). Open the debugging tools in the Google Chrome browser by pressing F12, then perform the action that causes the incomprehensible behavior. After that, copy the Network and Console tabs into a text file. Then send the data to support@smartplayer.org or to the person responsible for support in your case in the technical support system.
Для анализа, что происходит в личном кабинете достаточно предоставить информацию с двух вкладок инструментов отладки браузера (Network и Console). Откройте в браузере Google Chrome инструменты отладки, нажав F12, далее произведите действие которое вызывает непонятное поведение. После этого скопируйте в текстовый файл вкладки Network и Console. Далее пришлите данные на support@smartplayer.org или ответственному человеку за поддержку в вашем случае в системе технической поддержки.
[[Файл:DebugConsoleBrowser.png|мини|центр]]
[[Файл:DebugConsoleBrowser.png|мини|центр]]


==<span id="howIcanGetServerUrl">How to find out the address / version of the server in the platform and personal account SmartPlayer</span>==
==<span id="howIcanGetServerUrl">Как узнать адрес / версию серверного в платформе и личного кабинета SmartPlayer</span>==
To determine the address of the server application, you need to go to your personal account
Для определения адреса серверного приложения, необходимо зайти в личный кабинет
[[Файл:Screenshot from 2024-06-03 17-56-18.jpg|безрамки|центр]]
[[Файл:Screenshot from 2024-06-03 17-56-18.jpg|безрамки|центр]]
and go to the "Settings" tab, scroll down the page and click the "About software" hyperlink.
и перейти в вкладку "Настройки", прокрутить вниз страницы и нажать гиперссылку "О программном обеспечении".
[[Файл:Screenshot from 2024-06-03 17-58-21.png|безрамки|центр]]
[[Файл:Screenshot from 2024-06-03 17-58-21.png|безрамки|центр]]


You will be taken to a page with a table and a button to copy it. Click the "Copy table" button and pass the information to the employee who requested it.
Вы попадете на страницу, где есть таблица и удобная кнопка чтобы её скопировать. Нажмите кнопку "Скопировать таблицу" и передайте информацию сотруднику запросившему её.
[[Файл:Screenshot from 2024-06-03 17-59-23.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/en&oldid=14279