Od 27 marca 2025 r. zalecamy używanie android-latest-release
zamiast aosp-main
do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.
Porównanie wektora rotacji CV
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Rysunek 1. Miniatura wzoru testowego. Pobierz obraz w pełnej rozdzielczości, do którego prowadzi powyższy link.
Na tej stronie znajdziesz instrukcje, jak prawidłowo przetestować zgodność implementacji sensora z uwzględnieniem wektora obrotu. Ten test powinien być wykonywany, gdy urządzenie deklaruje funkcję złożonego czujnika TYPE_ROTATION_VECTOR.
Test
- Zainstaluj menedżera OpenCV na testowanym urządzeniu z Androidem.
- Pobierz pakiet
OpenCV-3.0.0-android-sdk.zip
ze strony
https://sourceforge.net/.
- Znajdź plik APK w folderze
apk
w pobrane archiwum. Załaduj plik APK na urządzeniu z komputera za pomocą polecenia adb install
z opcją --bypass-low-target-sdk-block
. W przypadku urządzeń z Androidem 13 lub starszym ta opcja --bypass-low-target-sdk-block
nie jest wymagana. Więcej informacji znajdziesz w artykule Instalowanie aplikacji.
Jeśli w Google Play jest zalogowane aktywne konto, znajdź w Google Play Menedżera OpenCV i wyłącz Automatyczną aktualizację w menu kontekstowym (wyświetlanym po kliknięciu przycisku „…”).
Rysunek 2. Wyłączanie automatycznych aktualizacji w Google Play.
- Wydrukuj połączony wzór testowy, wyłączając opcje skalowania podczas drukowania. Wzór powinien mieścić się na papierze w formacie US Letter w orientacji poziomej lub większym.
Uwaga: powyższa miniaturka ma niską rozdzielczość i służy tylko do celów ilustracyjnych. Nie drukuj go bezpośrednio jako wzoru.
- Umieść wzór na poziomej powierzchni.
- W aplikacji CTS Verifier uruchom sprawdzenie CV wektora obrotu. Postępuj zgodnie z instrukcjami, aby włączyć tryb samolotowy, wyłączyć automatyczne obracanie oraz dostosować jasność i lokalizację, jeśli te zmiany nie zostały jeszcze wprowadzone.
Rysunek 3. Rozpoczęcie testu.
- Gdy pojawi się podgląd filmu, umieść telefon w odległości 1 metra od wzoru, tak aby główny aparat był skierowany na wzór z żółtym znacznikiem na ekranie i żółtym znacznikiem na wzorze wyrównanym w tym samym rogu.
Rysunek 4. Umieszczenie wzoru testowego.
- Używając kamery, należy ustawić wzór w centrum obrazu i obrócić urządzenie z Androidem (UT) wokół wzoru w 3 różnych kierunkach (1, 2 i 3 na ilustracji poniżej) zgodnie z wytycznymi wskaźnika zakresu obrotu. Aby uzyskać najlepsze wyniki, poruszaj się płynnie i równo.
Rysunek 5. manipulowanie urządzeniem testowanym.
- Po zrobieniu zdjęcia podgląd aparatu zniknie, a rozpocznie się proces analizy. Poczekaj na zakończenie analizy. Zazwyczaj trwa to od 1 do 5 minut, w zależności od wydajności telefonu. Po zakończeniu analizy telefon wyda dźwięk i zacznie wibrować. Jeśli analiza się powiedzie, na ekranie pojawi się wynik liczbowy.
Rysunek 6. Kończę test.
- Kliknij Dalej, aby przejść do ekranu z ocena i sprawdzeniem wyniku.
Rysunek 7. zdać egzamin;
- Aby uzyskać najlepsze wyniki, postępuj zgodnie z tymi wskazówkami:
- Ponieważ jest to złożony test manualny, warto go przeprowadzić kilka razy, aby uzyskać najlepsze wyniki.
- Aby uzyskać dobre wyniki, przed testowaniem należy skalibrować akcelerometr, żyroskop i magnetometr.
Rozwiązywanie problemów
- Objawy: test uległ awarii podczas uruchamiania testu lub zaraz po zakończeniu nagrywania filmu.
Przyczyna: prawdopodobnie problem z kompatybilnością Menedżera OpenCV. Zaznacz
logcat
, aby potwierdzić. Jeśli tak, sprawdź wersję i architekturę zainstalowanego Menedżera OpenCV.
- Objawy: test często kończy się niepowodzeniem z powodu zbyt dużej liczby błędów „Too many invalid frame” (Zbyt dużo nieprawidłowych klatek).
Przyczyna: prawdopodobnie jakość filmu. Potwierdź te warunki:
- testowanie odbywa się w wystarczającym oświetleniu otoczenia; Najlepsze efekty daje zwykle światło naturalne. Jeśli jednak nie jest to możliwe, możesz użyć światła padającego z różnych stron, które nie tworzy wyraźnych cieni.
Unikaj oświetlenia pod kątem, aby zmniejszyć odbicia.
- Ruch podczas nagrywania filmu jest płynny. Nagłe ruchy powodują rozmycie i dezorientują oprogramowanie do analizy obrazu.
- Wzór powinien być zawsze w ramce podglądu filmu i znajdować się w pobliżu środka. Wzór powinien mieć rozmiar 1/4 do 1/2 okna podglądu filmu. Jeśli wzór jest zbyt mały, dokładność spada.
Jeśli wzór jest zbyt duży, zniekształcenie obiektywu jest bardziej widoczne, a wzorzec trudno jest utrzymać w ramach kadru.
- Aparat dobrze ustawia ostrość. Niektóre urządzenia mają problemy z ostrością podczas nagrywania filmów. Zwykle jest to spowodowane zbyt małą liczbą
różnic w scenie, np. gładka podłoga w jednolitym kolorze. Pomocne może być przeniesienie testowego wzoru w miejsce z teksturowaną powierzchnią lub umieszczenie obiektów wokół testowego wzoru.
- Stabilizacja obrazu jest wyłączona.
- Objawy: test pochylenia i przechyłu działa prawidłowo, ale test przechyłu poprzecznego regularnie się nie udaje.
Przyczyna: Najpierw sprawdź, czy czujnik pola magnetycznego jest dobrze skalibrowany.
Wektor obrotu nie działa prawidłowo, jeśli czujnik pola magnetycznego nie jest skalibrowany.
Może się też zdarzyć, że oś yaw przestanie działać podczas nagrywania filmu. Trzymaj urządzenie nieruchomo i chodź/porusz się wokół wzorców testowych w sekcji testu yaw. Trudno jest utrzymać jakość filmu podczas obracania urządzenia w dłoni.
Prześlij opinię
Jeśli powyższe czynności nie rozwiążą problemu, wykonaj czynności opisane poniżej, aby zgłosić problem.
Podczas zgłaszania błędu podaj te informacje:
- Raport o błędzie w Androidzie
- Zrzut ekranu, jeśli na ekranie wyświetla się komunikat o błędzie.
- Treść pliku
/sdcard/RVCVRecData/
. Ten folder zawiera pliki wideo, więc może być dość duży, jeśli test był już przeprowadzany kilka razy. Wyczyszczenie folderu i ponowne przeprowadzenie testu pomoże zmniejszyć rozmiar. Sprawdź pliki wideo, aby znaleźć oczywiste problemy w nagraniu.
- Zrzut ekranu aplikacji OpenCV Manager
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-27 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."]]