27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main
yerine android-latest-release
kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Döndürme vektörü CV çapraz kontrolü
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Şekil 1. Test deseninin küçük resmi. Yukarıdaki bağlantıdan tam çözünürlüklü resmi indirin.
Bu sayfada, dönme vektörü sensörü uygulamanızın uyumluluğunu doğru şekilde test etme adımları verilmiştir. Bu test, cihaz TYPE_ROTATION_VECTOR karma sensör özelliğini tanımladığında çalıştırılmalıdır.
Test
- Test edilen Android cihaza OpenCV Manager'ı yükleyin.
OpenCV-3.0.0-android-sdk.zip
paketini
SourceForge.net sitesinden indirin.
- İndirilen arşivin içindeki
apk
klasöründe APK'yı bulun. adb install
seçeneğiyle --bypass-low-target-sdk-block
komutunu kullanarak APK'yı bilgisayardan cihaza yükleyin. Android 13 veya daha eski sürümleri çalıştıran cihazlarda bu --bypass-low-target-sdk-block
seçeneği gerekli değildir. Daha fazla bilgi için Uygulama yükleme başlıklı makaleyi inceleyin.
Google Play'de etkin bir hesap varsa Google Play'de OpenCV Manager'ı bulun ve bağlam menüsünde Otomatik güncelleme'yi devre dışı bırakın ("..." düğmesindeki pop-up menü).
Şekil 2. Google Play'de otomatik güncellemeyi devre dışı bırakma
- Bağlı test desenini yazdırırken ölçeklendirme seçeneklerini devre dışı bırakın. Desen, yatay ABD mektup kağıdına veya daha büyük bir kağıda sığmalıdır.
Not: Yukarıdaki satır içi resim, yalnızca örnek olması amacıyla düşük çözünürlüktedir. Lütfen doğrudan deseniniz olarak yazdırmayın.
- Kalıpları yatay bir yüzeye yerleştirin.
- CTS Doğrulayıcı uygulamasında Rotasyon Vektörü CV Çapraz Kontrolü'nü başlatın. Uçak modunu etkinleştirmek, otomatik döndürmeyi devre dışı bırakmak ve bu değişiklikler yapılmadıysa uyarlanabilir parlaklığı ve konumu ayarlamak için kılavuzu uygulayın.
Şekil 3. Testi başlatma.
- Video önizlemesi göründüğünde telefonu, ana kameranın desenin üzerine bakacak şekilde desenin bir metre ötesine yerleştirin. Ekrandaki sarı işaretçi ve desendeki sarı işaretçi aynı köşeye hizalanmalıdır.
Şekil 4. Test desenini yerleştirme.
- Deseni tamamen kamera görünümünde tutarken, test edilen Android cihazı (DUT) dönme aralığı göstergesinin önerdiği şekilde desen etrafında üç farklı yönde tek tek (aşağıdaki resimde 1, 2 ve ardından 3 gösterilmektedir) döndürün. En iyi sonuç için hareketi düzgün ve sabit tutun.
Şekil 5. Test edilen cihazda değişiklik yapma.
- Fotoğraf çekildikten sonra kamera önizlemesi kaybolur ve analiz süreci başlar. Analizin tamamlanmasını bekleyin. Bu işlem, telefonun performansına bağlı olarak genellikle bir ila beş dakika sürer. Analiz tamamlandığında telefon ses çıkarır ve titreşir. Analiz başarılı olursa ekranda sayısal bir sonuç gösterilir.
Şekil 6. Testi bitiriyorum.
- Geçti/Geçmedi ekranına ilerleyip sonucu incelemek için sonraki'yi tıklayın.
Şekil 7. Testi geçme.
- En iyi sonuçları elde etmek için aşağıdaki ipuçlarını uygulayın:
- Karmaşık bir manuel test olduğundan en iyi sonuçları elde etmek için testi birkaç kez deneyebilirsiniz.
- İyi sonuçlar elde etmek için testten önce ivmeölçer, jiroskop ve manyetometre kalibre edilmelidir.
Sorunu giderin
- Belirti: Test, test kaydı başlatılırken veya video kaydı bittikten hemen sonra kilitlendi.
Nedeni: Muhtemelen OpenCV Manager uyumluluk sorunu. Onaylamak için logcat
seçeneğini işaretleyin. Onaylandıysa yüklü OpenCV Yöneticisi'nin sürümünü ve mimarisini kontrol edin.
- Belirti: Test, "Çok fazla geçersiz çerçeve" hataları nedeniyle sık sık başarısız oluyor.
Neden: Muhtemelen video kalitesinden kaynaklanır. Aşağıdaki koşulları onaylayın:
- Test için yeterli ortam ışığı olmalıdır. Genellikle en iyi sonucu doğal ışık verir. Ancak bu mümkün olmadığında, birden fazla açıdan gelen ve belirgin gölgeler oluşturmayan bol miktarda ışık da kullanılabilir.
Yansımayı azaltmak için düşük açıdan ışık kullanmaktan kaçının.
- Video çekerken hareketler akıcı olmalıdır. Sarsıntılı hareketler bulanıklığa neden olur ve bilgisayar görüşü yazılımını karıştırır.
- Kalıp her zaman video önizleme çerçevesinin tamamına sığmalı ve ortasına yakın bir yerde olmalıdır. Desen, video önizleme penceresinin 1/4 ila 1/2 büyüklüğünde olmalıdır. Desen çok küçükse doğruluk azalır.
Desen çok büyükse lens bozulması daha belirgin olur ve desenin her zaman video kaydı çerçevesinin içinde kalmasını sağlamak daha zor olur.
- Kamera iyi odaklanabiliyor. Bazı cihazlarda video kaydederken odaklanma sorunu yaşanabilir. Bu durum genellikle sahnede çok az varyasyon olmasından (ör. tek renkli pürüzsüz zemin yüzeyi) kaynaklanır. Test kalıbını dokulu bir yüzeye taşımak veya test kalıbının etrafına nesneler yerleştirmek genellikle yardımcı olur.
- Görüntü sabitleme özelliği devre dışıdır.
- Belirti: Eğim ve yuvarlanma testi sorunsuz çalışır ancak yan kayma testi düzenli olarak başarısız olur.
Nedeni: Öncelikle, manyetik alan sensörünün iyi kalibre edildiğinden emin olun.
Manyetik alan sensörü kalibre edilmemişse dönme vektörü düzgün çalışmaz.
Video çekimi nedeniyle yaw ekseninin de çalışmaması mümkündür. Cihazı sabit tutun ve testin yalpalama bölümü için test kalıbının etrafında yürüyün/hareket edin. Cihazı elinizde döndürürken videonun kalitesini korumak zor.
Görüş bildir
Yukarıdaki adımlar yardımcı olmadıysa sorununuzu bildirmek için lütfen aşağıdaki geri bildirim adımlarını uygulayın.
Hata bildirirken lütfen aşağıdaki bilgileri toplayın:
- Android bugreport
- Ekranda hata mesajı varsa ekran görüntüsü.
/sdcard/RVCVRecData/
içeriği. Bu klasör video dosyalarını içerdiğinden, test daha önce birden fazla kez yapılmışsa oldukça büyük olabilir. Klasörü temizleyip testi tekrar yapmak boyutu azaltmaya yardımcı olur. Kayıttaki bariz sorunları bulmak için içindeki video dosyalarını inceleyin.
- OpenCV Manager uygulamasının ekran görüntüsü.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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."]]