A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Verificação cruzada do CV do vetor de rotação
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Figura 1. Miniatura do padrão de teste. Faça o download da
imagem em resolução total vinculada acima.
Esta página mostra as etapas para testar corretamente a compatibilidade da implementação do sensor de vetor
de rotação. Esse teste precisa ser executado quando o dispositivo declarar o
recurso de sensor composto TYPE_ROTATION_VECTOR.
Teste
- Instale o OpenCV Manager no dispositivo Android que está sendo testado.
- Faça o download do pacote
OpenCV-3.0.0-android-sdk.zip em
https://sourceforge.net/projects/sourceforge.net/.
- Encontre o APK na pasta
apk dentro do arquivo transferido por download. Carregue o APK
no dispositivo de um computador usando o comando adb install com a
opção --bypass-low-target-sdk-block. Para dispositivos com o Android 13 ou versões anteriores,
essa opção --bypass-low-target-sdk-block não é necessária. Para mais informações, consulte
Instalar um app.
Se houver uma conta ativa conectada ao Google Play, localize o OpenCV Manager no Google Play
e desative a Atualização automática no menu de contexto (o menu pop-up do botão "...").
Figura 2. Como desativar a atualização automática no Google Play.
- Imprima o padrão de teste vinculado,
desativando todas as opções de dimensionamento ao imprimir. O padrão precisa caber em papel
Letter dos EUA no modo paisagem ou em qualquer tamanho maior.
Observação:a imagem inline acima tem baixa
resolução e é apenas para fins ilustrativos. Não imprima diretamente como seu
padrão.
- Coloque o padrão em uma superfície horizontal.
- Inicie a verificação cruzada do vetor de rotação CV no app CTS Verifier. Siga o guia para ativar o modo avião, desativar a rotação automática e
ajustar o brilho e a localização adaptáveis, caso essas mudanças não tenham sido
feitas.
Figura 3. Iniciando o teste.
- Quando a visualização do vídeo aparecer, coloque o smartphone a um metro do
padrão para que a câmera principal fique de frente para o padrão com o marcador amarelo na
tela e o marcador amarelo no padrão alinhado no mesmo canto.
Figura 4. Posicionamento do padrão de teste.
- Mantendo o padrão totalmente na visualização da câmera, gire o dispositivo
Android em teste (DUT, na sigla em inglês) em torno do padrão em três direções diferentes, uma
por vez (1, 2 e 3 ilustrados na imagem abaixo) conforme solicitado pelo
indicador de faixa de rotação. Mantenha o movimento suave e constante para ter o melhor resultado.
Figura 5. Manipular o dispositivo em teste.
- Após a captura, a visualização da câmera desaparece e o processo de análise
é iniciado. Aguarde a análise terminar. Geralmente, ela leva de um a cinco
minutos, dependendo do desempenho do smartphone. O smartphone vai emitir um som e vibrar quando a análise for concluída. Um resultado numérico será apresentado na tela se a
análise for bem-sucedida.
Figura 6. Concluindo o teste.
- Clique em Próxima para acessar a tela de aprovação/reprovação e conferir o resultado.
Figura 7. Aprovando o teste.
- Siga estas dicas para ter os melhores resultados:
- Como este é um teste manual com complexidade, tente fazer algumas vezes
para ter os melhores resultados.
- O acelerômetro, o giroscópio e o magnetômetro precisam ser calibrados antes do teste
para bons resultados.
Resolver problemas
- Sintoma: o teste falha ao iniciar o caso de teste ou imediatamente após a conclusão da gravação de vídeo.
Causa: provavelmente um problema de compatibilidade do OpenCV Manager. Marque
logcat para confirmar. Se confirmado, verifique a versão e o tipo de
arquitetura do OpenCV Manager instalado.
- Sintoma: o teste falha com frequência devido a erros de "Muitos frames inválidos".
Causa: provavelmente devido à qualidade do vídeo. Confirme as seguintes condições:
- Há iluminação ambiente suficiente para o teste. A luz natural
geralmente oferece o melhor resultado. No entanto, quando não está disponível, a luz abundante de vários ângulos que não forma sombras óbvias também funciona.
Evite iluminação de baixo ângulo para reduzir o brilho.
- O movimento durante a gravação de vídeo é suave. Movimentos irregulares causam
borrão e confundem o software de visão computacional.
- O padrão precisa estar totalmente no frame de visualização do vídeo e
localizado ao redor do centro. O padrão precisa ter de 1/4 a 1/2 do tamanho da
janela de visualização do vídeo. Se o padrão for muito pequeno, a precisão será reduzida.
Se o padrão for muito grande, a distorção da lente será mais óbvia, e será mais
difícil manter o padrão sempre dentro do frame de gravação de vídeo.
- A câmera consegue focar bem. Alguns dispositivos têm problemas para
manter o foco durante a gravação de vídeo. Isso geralmente ocorre porque há poucas
variações na cena, por exemplo, superfície de piso lisa de cor sólida. Mover o padrão
de teste para um lugar com superfície texturizada ou introduzir objetos ao redor do padrão
de teste geralmente ajuda.
- A estabilização de imagem está desativada.
- Sintoma: o teste de inclinação e de rolagem funciona bem, mas o teste de guinada falha regularmente.
Causa: primeiro, verifique se o sensor de campo magnético está bem calibrado.
O vetor de rotação não funciona bem se o sensor de campo magnético não estiver
calibrado.
Também é possível que o eixo de guinada falhe devido à gravação de vídeo. Segure o
dispositivo com firmeza e caminhe/se mova ao redor do padrão de teste para a seção de guinada do
teste. É difícil manter a qualidade do vídeo ao girar o dispositivo na
mão.
Informar feedback
Se as etapas acima não ajudarem, siga as etapas de feedback abaixo para informar o problema.
Colete as seguintes informações ao informar um bug:
- Relatório de bug do Android
- Captura de tela se houver alguma mensagem de erro na tela.
- Conteúdo de
/sdcard/RVCVRecData/. Essa pasta contém
arquivos de vídeo e pode ser muito grande se o teste já tiver sido feito
várias vezes. Limpar a pasta e realizar o teste novamente
vai ajudar a reduzir o tamanho. Inspecione os arquivos de vídeo para encontrar problemas óbvios na
gravação.
- Captura de tela do app OpenCV Manager.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
