Сертификация клиентского приложения на Android устройстве/en: различия между версиями

Материал из SmartPlayer
Новая страница: «Certification of the client application on an Android device»
 
Нет описания правки
 
(не показаны 4 промежуточные версии 2 участников)
Строка 1: Строка 1:
<div lang="ru" dir="ltr" class="mw-content-ltr">
<languages/>
== '''Описание ситуации''' ==
== '''Situation Description''' ==
В связи с расширением количества поддерживаемых устройств под управлением Android OS и разнообразием начинки, у технической команды SmartPlayer возникла необходимость проводить оценку производительности устройств при работе с клиентским приложением. Для этого в клиентское приложение Android была добавлена функциональность, которая проводит оценочные тесты устройства и его характеристик и выставляет оценку.
Due to the increasing number of supported devices running Android OS and the diversity of their hardware, the SmartPlayer technical team needed to evaluate device performance when running the client application. To address this, functionality was added to the Android client app to conduct performance tests on the device and its specifications, assigning a score based on the results.
{{Note|Данный тест не даёт полной гарантии что устройство пользователя будет корректно работать с клиентским приложением Android. Рекомендуется проводить минимум три теста и выводить оценку по суммарному среднему значению полученному из всех трёх тестов.|warn}}
{{Note|The existing test does not provide a full guarantee that the user's device will work correctly with the Android client application. It is recommended to run at least three tests and calculate the score based on the average result of all three tests.|warn}}
== '''Общая информация''' ==
== '''Starting the Evaluation Process''' ==
Данный тест отображается в клиентском приложении как окно состоящее из двух частей:
Once the benchmark's main page opens, the user will see the following parameters:
# Экран характеристик
* Language selection – allows choosing one of the available languages;
# Бенчмарк
* Menu button – navigates to the benchmark's "Menu" section;
[[File:Характеристики_андроид.png|thumb|center| Пример отображения UI для теста на клиентском приложении Android OS|800px]]
* Start button – immediately takes the user to the test launch page.
{{Note|Бенчмарк - это специальный тест или набор тестов, который помогает оценить, насколько быстро, эффективно и стабильно работает устройство, программа или система.|warn}}
[[File:Страница бенчмарка.png|thumb|center| Example of the benchmark's main page display|800px]]
</div>
{{Note|A benchmark is a specialized test or set of tests designed to evaluate how fast, efficient, and stable a device, program, or system performs.|warn}}


<div lang="ru" dir="ltr" class="mw-content-ltr">
== '''"Menu" Button''' ==
== '''Алгоритм действия''' ==
Clicking the "Menu" button opens a page with three separate buttons:
{{Note|Функционал тестирования устройства на клиентских приложениях будет работать с ver. 1.78 +|warn}}
* Device specifications - navigates to the corresponding page with technical specifications;
Данный тест появиться при первом запуске клиентского приложения на устройстве под управлением Android OS.  
* Maintenance options - navigates to the user page with maintenance capabilities;
[[File:Отображение_теста.png|thumb|center| Пример отображения теста на клиентском приложении Android OS|800px]]
* Performance test - navigates to the test step selection page.
Пользователю необходимо нажать на кнопку "Запустить проверку" расположенную в правой части экрана для запуска теста.
[[File:Список_меню.png|thumb|center| Example of buttons display on "Menu" page|800px]]
[[File:Запустить_проверку.png|thumb|center| Пример отображения кнопки "Запустить проверку"|800px]]
To go back, click the "Back" button at the bottom of the screen. To start benchmark tests, click "Start Setup" which navigates to device settings page.
Следующим шагом появиться модальное окно со списком настрое и включенными чекбоксами/галочками.  
== '''"Start" Button''' ==
{{Note| При необходимости некоторые шаги можно выключить с помощью чекбокса/галочки, но при первом запуске делать этого не рекомендуется.|warn}}
{{Note|Device testing functionality will work in client applications starting from ver. 1.78+|warn}}
[[File:Шаги_с_чекбоксами.png|thumb|center| Пример отображения чекбоксов для запуска теста|800px]]
Clicking "Start" opens the test page. This test appears during first launch of client application on Android OS devices.
Далее пользователь начинает процесс тестирования по кнопке "Запуск". Перед запуском тестов обязательно будет показано окно с предупреждением об эпилепсии.
[[File:Отображение_теста.png|thumb|center| Example of test display in Android OS client application|800px]]
{{Note|Для проведения тестов используются заранее подготовленный видеоконтент, которые расположены на облачном хранилище. У устройства обязательно должен быть выход в сеть.|warn}}
Click "Run Test" button on the right side of screen to start the test.
На этом этапе устройство проводит тесты по всем указанным в чекбоксах сценариях В процессе проверки теста пользователь должен наблюдать за каждым шагом проверки.
[[File:Запустить_проверку.png|thumb|center| Example of "Run Test" button display|800px]]
[[File:Шаг_1.png|thumb|center| Пример теста 1|800px]]
Next, a modal window will appear with settings list and enabled checkboxes.
[[File:Шаг_2.png|thumb|center| Пример теста 2|800px]]
{{Note| Some steps can be disabled using checkboxes, though not recommended during first launch.|warn}}
[[File:Шаг_3.png|thumb|center| Пример теста 3|800px]]
[[File:Шаги_с_чекбоксами.png|thumb|center| Example of test checkboxes display|800px]]
{{Note|Если на каком-то шаге проверки клиентское приложение перестанет работать, то устройство получит за этот этап 0 баллов. В случае ошибки, краша или зависания проверку на устройстве нужно перезапустить отключив с помощью чекбокса шаг, который приводит к ошибке.
Click "Start" to begin testing. An epilepsy warning will appear before tests begin.
[[File:Отображение_ошибки.png|thumb|center| Пример отображения проблемного шага|800px]]|warn}}
[[File:дисклеймер эпилепсия.png|thumb|center| Example of epilepsy content disclaimer|800px]]
После завершения всех тестов пользователю предоставят результат в виде списка с оценками. На этом тестирование устройства закончится.
{{Note|Tests use pre-prepared video content stored in cloud storage. Device must have internet connection.|warn}}
[[File:Результат_проверки.png|thumb|center| Пример отображения результата тестирования устройства под управлением Android OS|800px]]
Device will run all selected tests. User should monitor each test step.
Нажав на кнопку "Готово" пользователь получит отдельную оценку каждой характеристики с цветовой индикацией.
[[File:Шаг_1.png|thumb|center| Test example 1|800px]]
[[File:Оценка_модулей.png|thumb|center| Пример отображения результата с индикацией характеристик|800px]]
[[File:Шаг_2.png|thumb|center| Test example 2|800px]]
Завершив тест система покажет пользователю общий результат и результат по каждой характеристики. Ниже будет подробнее описана система оценок используемая в тесте.
[[File:Шаг_3.png|thumb|center| Test example 3|800px]]
== '''Система оценивания''' ==
{{Note|If client application crashes during any step, device scores 0 for that stage. In case of errors or freezes, restart test and disable problematic step using checkbox.
{{Note|Если в характеристике сталкиваются один зеленый параметр и один красный, то результат выдаваться по худшему из результатов.|warn}}
[[File:Отображение_ошибки.png|thumb|center| Example of problematic step display|800px]]|warn}}
'''Версия андроида:'''<br>
After completion, results will be displayed as scored list.
* Зелёный цвет - 9-11
[[File:Результат_проверки.png|thumb|center| Example of Android OS device test results|800px]]
* Жёлтый цвет - 7-8 или 11+
Clicking "Done" shows detailed scores with color indicators.
* Красный цвет - ниже 7 <br>
[[File:Оценка_модулей.png|thumb|center| Example of scored characteristics with indicators|800px]]
'''Наличие root-прав:'''<br>
System displays overall score and individual characteristic results:
* Зелёный цвет - да
* Clicking any row shows device maintenance recommendations.
* Красный цвет - нет<br>
[[File:Рекомендации_по_обслуживанию_2.png|thumb|center| Example of device maintenance recommendations|800px]]
'''Оперативная память (RAM):'''<br>
* Clicking score shows device statistics with recommendations.
* Зелёный цвет - 2 Гб
[[File:Рекомендации_по_обслуживанию.png|thumb|center| Example of device recommendations window|800px]]
* Жёлтый цвет - от 1.5 Гб до 2 Гб
Next section describes the scoring system.
* Красный цвет - ниже 1.5 Гб <br>
== '''Scoring System''' ==
'''Внутреннее хранилище (показывает общий размер памяти):'''<br>
{{Note|When characteristics contain both green and red parameters, the worst result is applied.|warn}}
* Зелёный цвет - больше 10 Гб
'''Android version:'''<br>
* Жёлтый цвет - от 8 Гб до 10 Гб
* Green - 9-11
* Красный цвет - ниже 8 Гб <br>
* Yellow - 7-8 or 11+
'''Свободная память (имеющаяся доступная память):'''<br>
* Red - below 7<br>
* Зелёный цвет - больше 2 Гб
'''Root access:'''<br>
* Жёлтый цвет - от 1 Гб до 2 Гб
* Green - yes
* Красный цвет - ниже 1 Гб <br>
* Red - no<br>
'''Наличие сетевых интерфейсов (WI-FI и Ethernet):'''<br>
'''RAM:'''<br>
* Зелёный цвет - если есть хотя бы один из сетевых интерфейсов
* Green - 2 GB
* Красный цвет - отсутствуют оба<br>
* Yellow - 1.5-2 GB
'''Видеодекодеры -''' отображает название используемых декодеров. При нажатии на строку можно развернуть полный текст с описанием декодеров.
* Red - below 1.5 GB<br>
== '''Общая оценка''' ==
'''Internal storage (total memory):'''<br>
Оценивается следующим образом:
* Green - above 10 GB
* Зелёный цвет - от 7 до 10
* Yellow - 8-10 GB
* Жёлтый цвет - от 5 до 7
* Red - below 8 GB<br>
* Красный цвет - от 0 до 5
'''Free storage (available memory):'''<br>
== '''Дополнительная информация''' ==
* Green - above 2 GB
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить данные вопросы в разделе "Обсуждения" вверху страницы.
* Yellow - 1-2 GB
[[File:Обсуждение_сертификации.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]]
* Red - below 1 GB<br>
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]]
'''Network interfaces (WI-FI/Ethernet):'''<br>
</div>
* Green - at least one available
* Red - none available<br>
'''Video decoders''' - shows decoder names. Click to expand full description.
== '''Overall Score''' ==
Scored as:
* Green - 7-10
* Yellow - 5-7
* Red - 0-5
== '''Additional Information''' ==
If this article doesn't help or questions remain, please post them in "Discussions" section at top of page.
[[File:Обсуждение_сертификации.png|thumb|center| Example of "Discussions" tab on wiki-page|800px]]
More information available at [[Как взаимодействовать пользователю с разделом "Обсуждения"]]

Текущая версия от 11:10, 18 апреля 2025

Situation Description

Due to the increasing number of supported devices running Android OS and the diversity of their hardware, the SmartPlayer technical team needed to evaluate device performance when running the client application. To address this, functionality was added to the Android client app to conduct performance tests on the device and its specifications, assigning a score based on the results.

The existing test does not provide a full guarantee that the user's device will work correctly with the Android client application. It is recommended to run at least three tests and calculate the score based on the average result of all three tests.

Starting the Evaluation Process

Once the benchmark's main page opens, the user will see the following parameters:

  • Language selection – allows choosing one of the available languages;
  • Menu button – navigates to the benchmark's "Menu" section;
  • Start button – immediately takes the user to the test launch page.
Example of the benchmark's main page display
A benchmark is a specialized test or set of tests designed to evaluate how fast, efficient, and stable a device, program, or system performs.

"Menu" Button

Clicking the "Menu" button opens a page with three separate buttons:

  • Device specifications - navigates to the corresponding page with technical specifications;
  • Maintenance options - navigates to the user page with maintenance capabilities;
  • Performance test - navigates to the test step selection page.
Example of buttons display on "Menu" page

To go back, click the "Back" button at the bottom of the screen. To start benchmark tests, click "Start Setup" which navigates to device settings page.

"Start" Button

Device testing functionality will work in client applications starting from ver. 1.78+

Clicking "Start" opens the test page. This test appears during first launch of client application on Android OS devices.

Example of test display in Android OS client application

Click "Run Test" button on the right side of screen to start the test.

Example of "Run Test" button display

Next, a modal window will appear with settings list and enabled checkboxes.

Some steps can be disabled using checkboxes, though not recommended during first launch.
Example of test checkboxes display

Click "Start" to begin testing. An epilepsy warning will appear before tests begin.

Example of epilepsy content disclaimer
Tests use pre-prepared video content stored in cloud storage. Device must have internet connection.

Device will run all selected tests. User should monitor each test step.

Test example 1
Test example 2
Test example 3
If client application crashes during any step, device scores 0 for that stage. In case of errors or freezes, restart test and disable problematic step using checkbox.
Example of problematic step display

After completion, results will be displayed as scored list.

Example of Android OS device test results

Clicking "Done" shows detailed scores with color indicators.

Example of scored characteristics with indicators

System displays overall score and individual characteristic results:

  • Clicking any row shows device maintenance recommendations.
Example of device maintenance recommendations
  • Clicking score shows device statistics with recommendations.
Example of device recommendations window

Next section describes the scoring system.

Scoring System

When characteristics contain both green and red parameters, the worst result is applied.

Android version:

  • Green - 9-11
  • Yellow - 7-8 or 11+
  • Red - below 7

Root access:

  • Green - yes
  • Red - no

RAM:

  • Green - 2 GB
  • Yellow - 1.5-2 GB
  • Red - below 1.5 GB

Internal storage (total memory):

  • Green - above 10 GB
  • Yellow - 8-10 GB
  • Red - below 8 GB

Free storage (available memory):

  • Green - above 2 GB
  • Yellow - 1-2 GB
  • Red - below 1 GB

Network interfaces (WI-FI/Ethernet):

  • Green - at least one available
  • Red - none available

Video decoders - shows decoder names. Click to expand full description.

Overall Score

Scored as:

  • Green - 7-10
  • Yellow - 5-7
  • Red - 0-5

Additional Information

If this article doesn't help or questions remain, please post them in "Discussions" section at top of page.

Example of "Discussions" tab on wiki-page

More information available at Как взаимодействовать пользователю с разделом "Обсуждения"