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

Материал из SmartPlayer
Нет описания правки
(Отметить эту версию для перевода)
 
Строка 1: Строка 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:25-->
==<span id="IntroduceDebugTools">Средства отладки</span>==
==<span id="IntroduceDebugTools">Средства отладки</span>==
SmartPlayer платформа предоставляет множества инструментов для отладки при возникновении нештатной ситуации.  
SmartPlayer платформа предоставляет множества инструментов для отладки при возникновении нештатной ситуации.  


<!--T:26-->
==<span id="DebugGetLogs">Получение журнала с устройства (логи) </span>==
==<span id="DebugGetLogs">Получение журнала с устройства (логи) </span>==
[[Файл:Get logs 1.png|мини]]
[[Файл:Get logs 1.png|мини]]
Строка 12: Строка 14:
# Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и выгрузите архив с журналом.
# Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и выгрузите архив с журналом.


<!--T:27-->
Существует два параметра:  
Существует два параметра:  


<!--T:28-->
* '''актуальные''' - выгрузится архив с журналом событий за текущий день, как следствие меньшего размера. Если сеть нестабильная, лучший выбор.
* '''актуальные''' - выгрузится архив с журналом событий за текущий день, как следствие меньшего размера. Если сеть нестабильная, лучший выбор.
* '''полные''' - выгрузится архив с журналом событий за несколько дней. Может передавать большой объём данных, сеть должна быть стабильнее.
* '''полные''' - выгрузится архив с журналом событий за несколько дней. Может передавать большой объём данных, сеть должна быть стабильнее.


<!--T:29-->
==<span id="GetFullInfoAboutDevice">Получение полных данных об устройстве </span>==
==<span id="GetFullInfoAboutDevice">Получение полных данных об устройстве </span>==
Каждое клиентсое приложение содержит полные данные об устройстве, чтобы получить их сделайте следующие действия:
Каждое клиентсое приложение содержит полные данные об устройстве, чтобы получить их сделайте следующие действия:
Строка 25: Строка 30:
# В открытой карточки устройства нажать на значок "копировать в буфер обмена" (в правом верхнем углу)
# В открытой карточки устройства нажать на значок "копировать в буфер обмена" (в правом верхнем углу)


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


<!--T:31-->
Данные скопируются в буфер обмена, для дальнейшей вставки в нужный докмуент.
Данные скопируются в буфер обмена, для дальнейшей вставки в нужный докмуент.


<!--T:32-->
==<span id="DownloadBroadcast">Выгрузить трансляцию</span>==
==<span id="DownloadBroadcast">Выгрузить трансляцию</span>==
Для анализа проигрывания трансляции её можно выгрузить из личного кабинета и передать для анализа в компанию SmartPlayer. Для этого сделайте следующие действия:  
Для анализа проигрывания трансляции её можно выгрузить из личного кабинета и передать для анализа в компанию SmartPlayer. Для этого сделайте следующие действия:  
Строка 36: Строка 44:
# В правом тулбаре нажать иконку - "Скачать"
# В правом тулбаре нажать иконку - "Скачать"


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


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


<!--T:35-->
==<span id="ClearDevice">Очистка устройства</span>==
==<span id="ClearDevice">Очистка устройства</span>==
Очистка устройства, позволяет удалить все данные приложения записанные с помощью ПО SmartPlayer, данные действия сбрасывают кеш приложения. Повторная регистрация устройства - не потребуется. Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и нажмите значок "очистить", на выбор будет предложено два параметра:  
Очистка устройства, позволяет удалить все данные приложения записанные с помощью ПО SmartPlayer, данные действия сбрасывают кеш приложения. Повторная регистрация устройства - не потребуется. Перейдите в карточку устройства (Выбрать устройство -> В правом тулбаре Информация) и нажмите значок "очистить", на выбор будет предложено два параметра:  
Строка 45: Строка 56:
* '''Очистить локальное хранилище''' - данный параметр удалить метаданные необходимые для проигрывания в оффлайн режиме. При следующем запуске приложения, если по актуальной трансляции не хватает метаданных, они будут получены с сервера SmartPlayer.  
* '''Очистить локальное хранилище''' - данный параметр удалить метаданные необходимые для проигрывания в оффлайн режиме. При следующем запуске приложения, если по актуальной трансляции не хватает метаданных, они будут получены с сервера SmartPlayer.  


<!--T:36-->
В зависимости от операционной системы клиентского приложения, оно будет или перезагружено или перезапущено.
В зависимости от операционной системы клиентского приложения, оно будет или перезагружено или перезапущено.


<!--T:37-->
==<span id="IntroduceDebugAndroidOffline">Выгрузить журнал работы (логи) устройства на Android OS в оффлайн режиме</span>==
==<span id="IntroduceDebugAndroidOffline">Выгрузить журнал работы (логи) устройства на Android OS в оффлайн режиме</span>==
Если устройства не подключается к серверу, проверьте вначале доступ устройства к серверу. Для этого достаточно, открыть встроенный браузер на Android OS устройстве и вбить адрес сервера. Если подключение идет к https://cms.smartplayer.org, то вбейте https://api.smartplayer.org в результате должно показаться сообщение '''Cannot GET /''', это говорит о том, что устройство "видит" сервер.  
Если устройства не подключается к серверу, проверьте вначале доступ устройства к серверу. Для этого достаточно, открыть встроенный браузер на Android OS устройстве и вбить адрес сервера. Если подключение идет к https://cms.smartplayer.org, то вбейте https://api.smartplayer.org в результате должно показаться сообщение '''Cannot GET /''', это говорит о том, что устройство "видит" сервер.  


<!--T:38-->
Если после проверки устройство остается оффлайн в личном кабинете (серым), можно забрать логи локально с устройства для последующей передачи их в тех. поддержку 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.


<!--T:39-->
==<span id="selfIdentificationdevice">Определить к какой учетной записи принадлежит устройство (идентификация устройства)</span>==
==<span id="selfIdentificationdevice">Определить к какой учетной записи принадлежит устройство (идентификация устройства)</span>==
Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"1"''' на пульте, приложение покажет интерфейс в котором:  
Для идентификации устройства с пульта необходимо разблокировать устройство (если заблокирован пульт) и нажать на кнопку '''"1"''' на пульте, приложение покажет интерфейс в котором:  
Строка 60: Строка 75:
[[Файл:InfoDevice.png|250px|обрамить]]
[[Файл:InfoDevice.png|250px|обрамить]]


<!--T:40-->
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"2"''' на пульте <br>
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"2"''' на пульте <br>
Поддержка платформ: WebOS/SSSP/BrightSign
Поддержка платформ: WebOS/SSSP/BrightSign


<!--T:41-->
==<span id="localDebugConsoleJS">Отображение локальной консоли</span>==
==<span id="localDebugConsoleJS">Отображение локальной консоли</span>==
Иногда не понятно, что происходит с устройством и нет возможности получить логи через личный кабинет, тогда необходимо запустить локальную консоль отладки, для получения сообщений о проблеме. [[File:info.png|20px]] [[DebugSmartPlayer#IntroduceDebugAndroidOffline|В случае с Android OS]]
Иногда не понятно, что происходит с устройством и нет возможности получить логи через личный кабинет, тогда необходимо запустить локальную консоль отладки, для получения сообщений о проблеме. [[File:info.png|20px]] [[DebugSmartPlayer#IntroduceDebugAndroidOffline|В случае с Android OS]]
Строка 68: Строка 85:
Начиная с версии v1.33.*, логирование на устройстве по умолчанию отключено. Для включения логирования нажмите на пульте кнопку '''"Green"''', далее откройте локальную консоль. <br>  
Начиная с версии v1.33.*, логирование на устройстве по умолчанию отключено. Для включения логирования нажмите на пульте кнопку '''"Green"''', далее откройте локальную консоль. <br>  


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


<!--T:43-->
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"Blue"''' на пульте <br>
Интерфейс можно скрыть, не дожидаясь таймера нажав '''"Blue"''' на пульте <br>
Поддержка платформ: WebOS/SSSP/BrightSign <br>
Поддержка платформ: WebOS/SSSP/BrightSign <br>


<!--T:44-->
[[Файл:InfoDeviceDebugConsole.png]]
[[Файл:InfoDeviceDebugConsole.png]]


<!--T:45-->
==<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|мини|центр]]
[[Файл:DebugConsoleBrowser.png|мини|центр]]


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


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

Текущая версия от 16:52, 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

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

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

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