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

Материал из SmartPlayer
(Новая страница: «If after checking the device remains offline in the personal account (gray), you can pick up the logs locally from the device for subsequent transfer to those. Sm...»)
(Новая страница: «==<span id="DebugGetLogs">Getting log from device (logs)</span>== мини мини Each client application writes an event log to its internal device memory, if necessary, it can be obtained and sent for analysis to SmartPLayer technical support, to get the most useful logs, do the following: # In the device settings (Select device -> In the right toolbar Settings), when it is in online status (green),...»)
 
(не показано 35 промежуточных версий 3 участников)
Строка 3: Строка 3:
SmartPlayer platform provides many tools for debugging when an abnormality occurs.  
SmartPlayer platform provides many tools for debugging when an abnormality occurs.  


==<span id="DebugGetLogs">
==<span id="DebugGetLogs">Getting log from device (logs)</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.
Each client application writes an event log to its internal device memory, if necessary, it can be obtained and sent for analysis to SmartPLayer technical support, to get the most useful logs, do the following:
# In the device settings (Select device -> In the right toolbar Settings), when it is in online status (green), enable the Debug or Trace logging mode. This will configure the device so that it writes more detailed messages about its operation
# Try to reproduce the abnormal situation on the device
# Try to reproduce the abnormal situation on the device
# Go to the device card (Select device -> In the right toolbar Information) and download the archive with the log.
# Go to the device card (Select device -> Info in the right toolbar) and download the archive with the log.
There are two parameters:
 
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.
* '''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.
* '''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="ClearDevice">
==<span id="GetFullInfoAboutDevice">Getting full device information </span>==
Cleaning the device </span> ==
Each client application contains full device information, to get it, do the following:
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:
# Log in to your account with your credentials
* '''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.
# Go to the "Devices" menu tab
* '''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.  
# 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|мини|центр]]
 
The data is copied to the clipboard for further pasting into the required document.
 
==<span id="DownloadBroadcast">Download broadcast</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:
# 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|мини|центр]]
 
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">Clearing the device</span>==
Clearing the device allows you to delete all application data recorded using the SmartPlayer software, these actions reset the application cache. Re-registration of 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 to choose from:
* '''Delete all files on the device''' - this option deletes media files downloaded for offline playback of content. The next time you start the application, if the current broadcast is not cached on the device, the files will be downloaded again.
* '''Clear local storage''' - this option deletes metadata required for offline playback. The next time you start the application, if there is not enough metadata for the current broadcast, they will be obtained from the SmartPlayer server.  


Depending on the operating system of the client application, it will either be rebooted or restarted.
Depending on the operating system of the client application, it will either be rebooted or restarted.


==<span id="IntroduceDebugAndroidOffline">Upload the operation log (logs) of a device on Android OS in offline mode </span> ==
==<span id="IntroduceDebugAndroidOffline">Download the log of the Android OS device in offline mode</span>==
If the device does not connect to the server, check the device's access to the server first. To do this, it is enough to open the built-in browser on the Android OS device and drive in the server address. If the connection goes to https://cms.smartplayer.org, then type in https://api.smartplayer.org as a result, the message '' 'Cannot GET /' '' should appear, this indicates that the device "sees" server.  
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.  


If after checking the device remains offline in the personal account (gray), you can pick up the logs locally from the device for subsequent transfer to those. SmartPlayer 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 go to:<br> '''/sdcard/Android/data/org.smartplayer.android.client/files/Logs/*''' <br>
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>
Insert the USB stick (previously formatted in fat32) into the device and copy the contents of the entire folder. Then transfer these files to the SmartPlayer technical department.
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.


==<span id="selfIdentificationdevice">Определить к какой учетной записи принадлежит устройство (идетификация устройства)</span>==
==<span id="selfIdentificationdevice">Determine which account the device belongs to (device identification)</span>==
Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"1"''' на пульте, приложение покажет интерфейс в котором:  
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:
# Указано имя устройства (аналогично как в личном кабинете)
# 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|обрамить]]


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


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


[[Файл:InfoDeviceDebugConsole.png|обрамить]]
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>


==<span id="localDebugConsoleBrowser">Получение отладочных сообщений от личного кабинета</span>==
The interface can be hidden without waiting for the timer by pressing '''"Blue"''' on the remote control <br>
Для анализа, что происходит в личном кабинете достаточно предоставить информацию с двух вкладок инструментов отладки браузера (Network и Console). Откройте в браузере Google Chrome инструменты отладки, нажав F12, далее произведите действие которое вызывает непонятное поведение. После этого сфотографируйте в читаемом качестве вкладки Network и Console. Далее пришлите данные на support@smartplayer.org или ответственному человеку за поддержку в вашем случае.
Supported platforms: WebOS/SSSP/BrightSign <br>


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


==<span id="localDebugConsoleBrowser">Receiving debug messages from your personal account </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 take an action that causes incomprehensible behavior. After that, take a photo in readable quality of the Network and Console tabs. Next, send the details to support@smartplayer.org or the person in charge of support in your case.
[[Файл: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>==
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|безрамки|центр]]
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|безрамки|центр]]
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|безрамки|центр]]

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

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

Debugging Tools

SmartPlayer platform provides many tools for debugging when an abnormality occurs.

Getting log from device (logs)

Each client application writes an event log to its internal device memory, if necessary, it can be obtained and sent for analysis to SmartPLayer technical support, to get the most useful logs, do the following:

  1. In the device settings (Select device -> In the right toolbar Settings), when it is in online status (green), enable the Debug or Trace logging mode. This will configure the device so that it writes more detailed messages about its operation
  2. Try to reproduce the abnormal situation on the device
  3. Go to the device card (Select device -> Info in the right toolbar) 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.

Getting full device information

Each client application contains full device information, to get it, do the following:

  1. Log in to your account with your credentials
  2. Go to the "Devices" menu tab
  3. Select a device (by clicking on it or in the list), without checking the box
  4. The device menu will open on the right, select the Information menu item
  5. In the open device card, click on the "copy to clipboard" icon (in the upper right corner)

The data is copied to the clipboard for further pasting into the required document.

Download broadcast

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:

  1. Log in to your personal account
  2. Go to the "Broadcasts" menu item
  3. Select the desired broadcast
  4. In the right toolbar, click the icon - "Download"

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.

Clearing the device

Clearing the device allows you to delete all application data recorded using the SmartPlayer software, these actions reset the application cache. Re-registration of 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 to choose from:

  • Delete all files on the device - this option deletes media files downloaded for offline playback of content. The next time you start the application, if the current broadcast is not cached on the device, the files will be downloaded again.
  • Clear local storage - this option deletes metadata required for offline playback. The next time you start the application, if there is not enough metadata for the current broadcast, they will be obtained from the SmartPlayer server.

Depending on the operating system of the client application, it will either be rebooted or restarted.

Download the log of the Android OS device in offline mode

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.

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: ES File Manager) to follow the path:
/sdcard/Android/data/org.smartplayer.android.client/files/Logs/*
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.

Determine which account the device belongs to (device identification)

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)
  2. List of accounts participating in the company for which the device is registered
  3. After what time the information will be hidden (in seconds)

The interface can be hidden without waiting for the timer by pressing "2" on the remote control
Platform Support: WebOS / SSSP / BrightSign

Displaying the local console

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. In the case of Android OS
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.

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

The interface can be hidden without waiting for the timer by pressing "Blue" on the remote control
Supported platforms: WebOS/SSSP/BrightSign

Receiving debug messages from your personal account

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 take an action that causes incomprehensible behavior. After that, take a photo in readable quality of the Network and Console tabs. Next, send the details to support@smartplayer.org or the person in charge of support in your case.

How to find out the address / version of the server in the platform and personal account SmartPlayer

To determine the address of the server application, you need to go to your personal account

and go to the "Settings" tab, scroll down the page and click the "About software" hyperlink.

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.