Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release
вместо aosp-main
для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .
Перекрестная проверка CV вектора вращения
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Рисунок 1. Миниатюра тестового шаблона. Загрузите изображение в полном разрешении, указанное выше.
На этой странице представлены инструкции по правильному тестированию совместимости вашей реализации датчика вектора вращения . Этот тест следует запускать, когда устройство объявляет функцию составного датчика TYPE_ROTATION_VECTOR.
Тест
- Установите OpenCV Manager на тестируемое устройство Android.
- Загрузите пакет
OpenCV-3.0.0-android-sdk.zip
с сайта SourceForge.net . - Найдите APK в папке
apk
внутри скачанного архива. Загрузите APK на устройство с компьютера с помощью команды adb install
с опцией --bypass-low-target-sdk-block
. Для устройств под управлением Android 13 или более ранней версии этот параметр --bypass-low-target-sdk-block
не требуется. Дополнительную информацию см. в разделе Установка приложения . Если в Google Play есть активная учетная запись, найдите OpenCV Manager в Google Play и отключите Автообновление в контекстном меню (всплывающее меню по кнопке «...»).

Рисунок 2. Отключение автоматического обновления в Google Play.
- Распечатайте связанный тестовый шаблон , отключив при печати все параметры масштабирования. Выкройка должна соответствовать бумаге US Letter в альбомной ориентации или чему-то большему.
Примечание. Встроенное изображение выше имеет низкое разрешение и предназначено только для иллюстрации. Пожалуйста, не распечатывайте его напрямую как ваш шаблон.
- Поместите выкройку на горизонтальную поверхность.
- Запустите перекрестную проверку CV вектора вращения в приложении CTS Verifier. Следуйте инструкциям, чтобы включить режим полета, отключить автоматический поворот и настроить адаптивную яркость и местоположение, если эти изменения не были внесены.

Рисунок 3. Запуск теста.
- Когда появится предварительный просмотр видео, поместите телефон на три фута (или один метр) над рисунком так, чтобы основная камера была обращена к шаблону с желтым маркером на экране и желтым маркером на шаблоне, совмещенным с одним и тем же углом.

Рисунок 4. Размещение тестового шаблона.
- Полностью сохраняя рисунок в поле зрения камеры, поверните тестируемое устройство Android (DUT) вокруг рисунка в трех разных направлениях, одно за другим (1, 2, а затем 3, как показано на рисунке ниже), как подсказывает индикатор диапазона вращения. Для достижения наилучшего результата сохраняйте движения плавными и устойчивыми.

Рисунок 5. Манипулирование тестируемым устройством.
- После захвата предварительный просмотр камеры исчезнет и начнется процесс анализа. Терпеливо дождитесь завершения анализа; обычно это занимает от одной до пяти минут в зависимости от производительности телефона. По завершении анализа телефон издаст звуковой сигнал и вибрирует. Числовой результат будет представлен на экране, если анализ пройдет успешно.

Рисунок 6. Завершение теста.
- Нажмите «Далее» , чтобы перейти к экрану «прошел/не прошел» и просмотрите результат.

Рисунок 7. Прохождение теста.
- Следуйте этим советам для достижения наилучших результатов:
- Поскольку это сложный ручной тест, для достижения наилучших результатов вы можете попробовать его несколько раз.
- Для получения хороших результатов перед тестированием необходимо откалибровать акселерометр, гироскоп и магнитометр.
Устранение неполадок
- Признак: тест завершился сбоем при запуске тестового примера или сразу после окончания записи видео.
Причина. Вероятно, проблема совместимости OpenCV Manager. Проверьте logcat
для подтверждения. В случае подтверждения проверьте версию и версию установленного OpenCV Manager. - Признак: тест часто завершается неудачно из-за ошибок «Слишком много недопустимых кадров».
Причина: Вероятно, из-за качества видео. Подтвердите следующие условия:- Для проведения теста достаточно окружающего освещения. Естественный свет обычно дает лучший результат. Однако, когда он недоступен, также подойдет обильный свет под разными углами, не образующий явных теней. Избегайте освещения под низким углом, чтобы уменьшить блики.
- Движения во время видеосъемки плавные. Резкое движение вызывает размытие изображения и сбивает с толку программное обеспечение компьютерного зрения.
- Узор всегда должен полностью находиться в рамке предварительного просмотра видео и располагаться вокруг центра. Размер шаблона должен составлять 1/4 ~ 1/2 размера окна предварительного просмотра видео. Если шаблон слишком мал, точность снижается. Если рисунок слишком велик, искажение объектива становится более очевидным, и сложнее всегда сохранять рисунок внутри кадра видеозаписи.
- Камера умеет хорошо фокусироваться. У некоторых устройств возникают проблемы с фокусировкой во время записи видео. Обычно это происходит из-за того, что в сцене слишком мало вариаций, например, однотонная гладкая поверхность пола. Обычно помогает перемещение тестового шаблона в место с текстурированной поверхностью или размещение объектов вокруг тестового шаблона.
- Стабилизация изображения отключена.
- Признак: тест по тангажу и крену работает нормально, но тест на рысканье регулярно не проходит.
Причина: Во-первых, убедитесь, что датчик магнитного поля хорошо откалиброван. Вектор вращения не работает должным образом, если датчик магнитного поля не откалиброван.
Также возможно, что ось рыскания выходит из строя из-за видеосъемки. Держите устройство неподвижно и пройдитесь/перемещайтесь по испытательной схеме для участка испытания по рысканью. Трудно сохранить качество видео, вращая устройство в руке.
Сообщить об отзыве
Если описанные выше действия не помогли, обязательно следуйте приведенным ниже инструкциям, чтобы сообщить о проблеме.
При сообщении об ошибке соберите следующую информацию:
- Отчет об ошибках Android
- Снимок экрана, если на экране появилось сообщение об ошибке.
- Содержимое
/sdcard/RVCVRecData/
. Эта папка содержит видеофайлы и поэтому может быть довольно большой, если тест уже проходился несколько раз. Очистка папки и повторное выполнение теста помогут уменьшить размер. Проверьте видеофайлы внутри, чтобы найти очевидные проблемы при записи. - Скриншот приложения OpenCV Manager.
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 UTC."],[],[],null,["# Rotation vector CV crosscheck\n\n**Figure 1.** Thumbnail of test pattern. Download the\nfull-resolution image linked above.\n\nThis page provides the steps to properly test the compatibility of your [rotation vector\nsensor](/docs/core/interaction/sensors/sensor-types#rotation_vector) implementation. This test should be run when the device declares the\nTYPE_ROTATION_VECTOR composite sensor feature.\n\nTest\n----\n\n1. Install OpenCV Manager on the Android device being tested.\n2. Download the `OpenCV-3.0.0-android-sdk.zip` package from [SourceForge.net](https://sourceforge.net/projects/opencvlibrary/files/opencv-android/3.0.0).\n3. Find the APK from the `apk` folder inside the downloaded archive. Load the APK on the device from a computer using the `adb install` command with the `--bypass-low-target-sdk-block` option. For devices running Android 13 or lower, this `--bypass-low-target-sdk-block` option isn't necessary. For more information, see [Install an app](http://developer.android.com/tools/help/adb#move).\n4. If there is an active account logged into Google Play, locate OpenCV Manager in Google Play\n and disable *Auto-update* in the context menu (the popup menu from the \"...\" button).\n\n\n **Figure 2.** Disabling Auto-update in Google Play.\n5. Print out the linked [test pattern](/static/docs/compatibility/cts/images/acircles_pattern.pdf), disabling any scaling options when printing. The pattern should fit US Letter paper in landscape or anything bigger.\n\n **Note:** The inline picture above is low\n resolution and just for illustration. Please do not directly print it as your\n pattern.\n6. Place the pattern on a horizontal surface.\n7. Start the **Rotation Vector CV Crosscheck** in the CTS Verifier app. Follow the guide to turn on airplane mode, turn off auto rotate, and adjust adaptive brightness and location if these changes have not been made. \n\n\n **Figure 3.** Initiating the test.\n8. When the video preview appears, place the phone three feet (or one meter) over the pattern so the main camera is facing the pattern with yellow marker on the screen and yellow marker on the pattern aligned at the same corner. \n\n\n **Figure 4.** Placing the test pattern.\n9. While keeping the pattern entirely in the camera view, rotate the Android device under test (DUT) around the pattern in three different directions, one by one (1, 2 and then 3 illustrated in picture below) as prompted by the rotation range indicator. Keep movement smooth and steady for the best result. \n\n\n **Figure 5.** Manipulating the device under test.\n10. After the capture, the camera preview will disappear and the analysis process will start. Wait patiently for analysis to finish; it usually takes one to five minutes depending on the phone performance. The phone will sound and vibrate at analysis completion. A numerical result will be presented on screen if the analysis is successful. \n\n\n **Figure 6.** Finishing the test.\n11. Click **next** to proceed to the pass/fail screen and review the result. \n\n\n **Figure 7.** Passing the test.\n12. Follow these tips for best results:\n 1. Since this is a manual test with complexity, you may want to try it a few times for the best results.\n 2. Accelerometer, gyroscope, and magnetometer should be calibrated before testing for good results.\n\nTroubleshoot\n------------\n\n1. Symptom: Test crashed when starting test case or immediately after finishing video recording. \n Cause: Likely an OpenCV Manager compatibility issue. Check `logcat` to confirm. If confirmed, check version and arch of the installed OpenCV Manager.\n2. Symptom: Test fails frequently due to \"Too many invalid frame\" errors. \n Cause: Likely due to video quality. Confirm the following conditions:\n 1. There is enough ambient lighting for the test. Natural light usually gives the best result. However, when it is not available, abundant light from multiple angles that does not form obvious shadows works, as well. Avoid low angle lighting to reduce glare.\n 2. The motion during video taking is smooth. Jerky movement causes blur and confuses the computer vision software.\n 3. The pattern should always be entirely in video preview frame and located around the center. The pattern should be 1/4 \\~ 1/2 the size of the video preview window. If the pattern is too small, the accuracy is reduced. If the pattern is too big, lens distortion is more obvious, and it is more difficult to keep the pattern always inside video recording frame.\n 4. The camera is able to focus well. Some devices have trouble in focusing during video recording. This is usually due to there is too few variations in the scene, e.g. solid color smooth floor surface. Moving test pattern to a place with textured surface or introducing objects around the test pattern usually helps.\n 5. Image stabilization is turned off.\n3. Symptom: The pitch and roll test works fine, but the yaw test regularly fails. \n Cause: First, make sure the magnetic field sensor is well calibrated. Rotation vector does not function well if magnetic field sensor is not calibrated. \n It is also possible that yaw axis fails due to video taking. Hold the device steady and walk/move around the test pattern for the yaw section of test. It is hard to maintain the quality of video while rotating device in hand.\n\nReport feedback\n---------------\n\nIf the steps above do not help, please make sure to follow the feedback steps below to report your issue.\n\nPlease gather the following information when reporting a bug:\n\n1. Android bugreport\n2. Screenshot if there is any error message on screen.\n3. Contents of `/sdcard/RVCVRecData/`. This folder contains video files and thus can be quite large if the test has already been taken multiple times. Clearing the folder and performing the test again will help reduce size. Inspect video files inside to find obvious issues in recording.\n4. Screenshot of the OpenCV Manager app."]]