À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release
au lieu de aosp-main
pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.
Vérification croisée du CV du vecteur de rotation
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Figure 1 : Miniature du modèle de test. Téléchargez l'image en pleine résolution en cliquant sur le lien ci-dessus.
Cette page explique comment tester correctement la compatibilité de votre implémentation du capteur de vecteur de rotation. Ce test doit être exécuté lorsque l'appareil déclare la fonctionnalité de capteur composite TYPE_ROTATION_VECTOR.
Test
- Installez OpenCV Manager sur l'appareil Android testé.
- Téléchargez le package
OpenCV-3.0.0-android-sdk.zip
depuis
SourceForge.net.
- Recherchez l'APK dans le dossier
apk
de l'archive téléchargée. Chargez l'APK sur l'appareil à partir d'un ordinateur à l'aide de la commande adb install
avec l'option --bypass-low-target-sdk-block
. Pour les appareils équipés d'Android 13 ou version antérieure, cette option --bypass-low-target-sdk-block
n'est pas nécessaire. Pour en savoir plus, consultez la section Installer une application.
Si un compte actif est connecté à Google Play, recherchez OpenCV Manager dans Google Play et désactivez Mise à jour automatique dans le menu contextuel (menu pop-up du bouton "...").
Figure 2. Désactivation de la mise à jour automatique dans Google Play
- Imprimez le motif de test associé, en désactivant toutes les options de mise à l'échelle lors de l'impression. Le motif doit s'adapter au format Lettre américain en mode paysage ou plus grand.
Remarque:L'image intégrée ci-dessus est basse résolution et n'est fournie qu'à titre d'illustration. Veuillez ne pas l'imprimer directement comme motif.
- Placez le motif sur une surface horizontale.
- Lancez la vérification croisée du CV du vecteur de rotation dans l'application CTS Verifier. Suivez le guide pour activer le mode Avion, désactiver la rotation automatique et ajuster la luminosité adaptative et la position si ces modifications n'ont pas été apportées.
Figure 3. Lancement du test.
- Lorsque l'aperçu vidéo s'affiche, placez le téléphone à un mètre du motif de sorte que l'appareil photo principal soit orienté vers celui-ci, avec le repère jaune à l'écran et le repère jaune sur le motif alignés sur le même angle.
Figure 4. Placer le motif de test.
- Tout en maintenant le motif entièrement dans le champ de vision de la caméra, faites pivoter l'appareil Android testé (DUT) autour du motif dans trois directions différentes, une par une (1, 2, puis 3 illustrées dans l'image ci-dessous) comme indiqué par l'indicateur de plage de rotation. Pour de meilleurs résultats, effectuez des mouvements fluides et réguliers.
Figure 5. Manipulation de l'appareil testé.
- Après la capture, l'aperçu de l'appareil photo disparaît et le processus d'analyse commence. Patientez jusqu'à la fin de l'analyse. Elle prend généralement entre une et cinq minutes, en fonction des performances du téléphone. Le téléphone sonne et vibre à la fin de l'analyse. Un résultat numérique s'affiche à l'écran si l'analyse aboutit.
Figure 6. Fin du test.
- Cliquez sur Suivant pour accéder à l'écran "Pass/Fail" (Passer/Échouer) et consulter le résultat.
Figure 7. Test réussi.
- Pour obtenir de meilleurs résultats, suivez ces conseils :
- Comme il s'agit d'un test manuel complexe, vous pouvez l'essayer plusieurs fois pour obtenir les meilleurs résultats.
- Pour obtenir de bons résultats, l'accéléromètre, le gyroscope et le magnétomètre doivent être calibrés avant les tests.
Dépannage
- Symptôme: Le test a planté au démarrage du cas de test ou immédiatement après la fin de l'enregistrement vidéo.
Cause: Problème de compatibilité avec OpenCV Manager. Cochez logcat
pour confirmer. Si c'est le cas, vérifiez la version et l'architecture du gestionnaire OpenCV installé.
- Symptôme: Le test échoue fréquemment en raison d'erreurs "Trop de frames non valides".
Cause: Probablement lié à la qualité vidéo. Vérifiez les conditions suivantes :
- L'éclairage ambiant est suffisant pour le test. La lumière naturelle donne généralement les meilleurs résultats. Toutefois, lorsque cette option n'est pas disponible, une lumière abondante provenant de plusieurs angles et ne formant pas d'ombres évidentes fonctionne également.
Évitez l'éclairage à faible angle pour réduire les reflets.
- Les mouvements pendant l'enregistrement de la vidéo sont fluides. Les mouvements saccadés entraînent un flou et perturbent le logiciel de vision par ordinateur.
- Le motif doit toujours être entièrement dans le cadre d'aperçu de la vidéo et situé au centre. Le motif doit mesurer entre un quart et la moitié de la taille de la fenêtre d'aperçu de la vidéo. Si le modèle est trop petit, la précision est réduite.
Si le motif est trop grand, la distorsion de l'objectif est plus évidente, et il est plus difficile de le maintenir toujours dans le cadre de l'enregistrement vidéo.
- La caméra peut faire la mise au point correctement. Certains appareils ont du mal à faire la mise au point lors de l'enregistrement vidéo. Cela est généralement dû à un manque de variations dans la scène, par exemple une surface de sol lisse de couleur unie. Il est généralement utile de déplacer le motif de test vers un endroit où la surface est texturée ou d'introduire des objets autour du motif de test.
- La stabilisation de l'image est désactivée.
- Symptôme: Le test d'inclinaison et de roulis fonctionne correctement, mais le test de lacet échoue régulièrement.
Cause: Commencez par vous assurer que le capteur de champ magnétique est bien calibré.
Le vecteur de rotation ne fonctionne pas correctement si le capteur de champ magnétique n'est pas calibré.
Il est également possible que l'axe de lacet ne fonctionne pas en raison de la prise de vue vidéo. Tenez l'appareil immobile et marchez/déplacez-vous autour du motif de test pour la section de test de lacet. Il est difficile de maintenir la qualité de la vidéo lorsque vous faites pivoter l'appareil.
Envoyer des commentaires
Si les étapes ci-dessus ne vous aident pas, veuillez suivre la procédure ci-dessous pour nous envoyer vos commentaires et signaler votre problème.
Veuillez rassembler les informations suivantes lorsque vous signalez un bug:
- Bugreport Android
- Capture d'écran si un message d'erreur s'affiche à l'écran
- Contenu de
/sdcard/RVCVRecData/
. Ce dossier contient des fichiers vidéo et peut donc être assez volumineux si le test a déjà été effectué plusieurs fois. Vider le dossier et effectuer à nouveau le test permet de réduire la taille. Inspectez les fichiers vidéo pour détecter les problèmes évidents dans l'enregistrement.
- Capture d'écran de l'application OpenCV Manager.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]