Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release
thay vì aosp-main
để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.
Xác minh chéo CV vectơ xoay
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hình 1. Hình thu nhỏ của mẫu kiểm thử. Tải hình ảnh có độ phân giải đầy đủ được liên kết ở trên xuống.
Trang này cung cấp các bước để kiểm tra đúng cách khả năng tương thích của việc triển khai cảm biến vectơ xoay. Bạn nên chạy kiểm thử này khi thiết bị khai báo tính năng cảm biến tổng hợp TYPE_ROTATION_VECTOR.
Kiểm tra
- Cài đặt Trình quản lý OpenCV trên thiết bị Android đang được kiểm thử.
- Tải gói
OpenCV-3.0.0-android-sdk.zip
xuống từ
SourceForge.net.
- Tìm tệp APK trong thư mục
apk
bên trong tệp lưu trữ đã tải xuống. Tải tệp APK trên thiết bị từ máy tính bằng lệnh adb install
với tuỳ chọn --bypass-low-target-sdk-block
. Đối với các thiết bị chạy Android 13 trở xuống, bạn không cần sử dụng tuỳ chọn --bypass-low-target-sdk-block
này. Để biết thêm thông tin, hãy xem phần Cài đặt ứng dụng.
Nếu có một tài khoản đang hoạt động đã đăng nhập vào Google Play, hãy tìm Trình quản lý OpenCV trong Google Play và tắt tuỳ chọn Tự động cập nhật trong trình đơn theo bối cảnh (trình đơn bật lên từ nút "...").
Hình 2. Tắt tính năng Tự động cập nhật trong Google Play.
- In mẫu kiểm thử đã liên kết, tắt mọi tuỳ chọn điều chỉnh theo tỷ lệ khi in. Mẫu này phải vừa với giấy Thư của Hoa Kỳ theo hướng ngang hoặc bất kỳ kích thước nào lớn hơn.
Lưu ý: Hình ảnh nội tuyến ở trên có độ phân giải thấp và chỉ mang tính minh hoạ. Vui lòng không in trực tiếp mẫu này.
- Đặt mẫu trên một bề mặt ngang.
- Bắt đầu Rotation Vector CV Crosscheck (Kiểm tra chéo vectơ xoay) trong ứng dụng CTS Verifier. Làm theo hướng dẫn để bật chế độ trên máy bay, tắt tính năng tự động xoay và điều chỉnh độ sáng thích ứng cũng như vị trí nếu bạn chưa thực hiện những thay đổi này.
Hình 3. Bắt đầu kiểm thử.
- Khi bản xem trước video xuất hiện, hãy đặt điện thoại cách mẫu 1 mét (hoặc 3 feet) để máy ảnh chính hướng về mẫu có điểm đánh dấu màu vàng trên màn hình và điểm đánh dấu màu vàng trên mẫu được căn chỉnh ở cùng một góc.
Hình 4. Đặt mẫu kiểm thử.
- Trong khi giữ nguyên mẫu trong khung nhìn máy ảnh, hãy xoay thiết bị Android đang được kiểm thử (DUT) xung quanh mẫu theo 3 hướng khác nhau, lần lượt (1, 2 rồi 3 như minh hoạ trong hình bên dưới) theo lời nhắc của chỉ báo phạm vi xoay. Hãy di chuyển một cách mượt mà và ổn định để có kết quả tốt nhất.
Hình 5. Thao tác với thiết bị đang được kiểm thử.
- Sau khi chụp, bản xem trước của máy ảnh sẽ biến mất và quá trình phân tích sẽ bắt đầu. Hãy kiên nhẫn chờ quá trình phân tích hoàn tất; thường mất từ 1 đến 5 phút tuỳ thuộc vào hiệu suất của điện thoại. Điện thoại sẽ phát âm thanh và rung khi hoàn tất quá trình phân tích. Kết quả dạng số sẽ xuất hiện trên màn hình nếu phân tích thành công.
Hình 6. Hoàn tất kiểm thử.
- Nhấp vào tiếp theo để chuyển đến màn hình đạt/không đạt và xem kết quả.
Hình 7. Kiểm thử thành công.
- Hãy làm theo các mẹo sau để đạt được kết quả tốt nhất:
- Vì đây là một quy trình kiểm thử thủ công có độ phức tạp, nên bạn nên thử một vài lần để có kết quả tốt nhất.
- Bạn nên hiệu chỉnh gia tốc kế, con quay hồi chuyển và la bàn trước khi kiểm thử để có kết quả tốt.
Khắc phục sự cố
- Triệu chứng: Kiểm thử gặp sự cố khi bắt đầu trường hợp kiểm thử hoặc ngay sau khi kết thúc quá trình quay video.
Nguyên nhân: Có thể là vấn đề về khả năng tương thích với Trình quản lý OpenCV. Kiểm tra logcat
để xác nhận. Nếu xác nhận, hãy kiểm tra phiên bản và cấu trúc của Trình quản lý OpenCV đã cài đặt.
- Triệu chứng: Thử nghiệm thường xuyên không thành công do lỗi "Quá nhiều khung không hợp lệ".
Nguyên nhân: Có thể là do chất lượng video. Xác nhận các điều kiện sau:
- Có đủ ánh sáng xung quanh để kiểm thử. Ánh sáng tự nhiên thường mang lại kết quả tốt nhất. Tuy nhiên, khi không có ánh sáng tự nhiên, bạn cũng có thể sử dụng ánh sáng nhân tạo với cường độ mạnh từ nhiều góc độ để không tạo ra bóng rõ ràng.
Tránh ánh sáng ở góc thấp để giảm độ chói.
- Chuyển động trong khi quay video mượt mà. Chuyển động giật làm mờ và gây nhầm lẫn cho phần mềm thị giác máy tính.
- Mẫu phải luôn nằm hoàn toàn trong khung xem trước video và nằm ở giữa. Mẫu phải có kích thước bằng 1/4 đến 1/2 kích thước của cửa sổ xem trước video. Nếu mẫu quá nhỏ, độ chính xác sẽ giảm.
Nếu mẫu quá lớn, hiện tượng méo hình sẽ rõ ràng hơn và khó giữ cho mẫu luôn nằm trong khung hình quay video hơn.
- Máy ảnh có thể lấy nét tốt. Một số thiết bị gặp sự cố khi lấy nét trong khi quay video. Điều này thường là do có quá ít biến thể trong cảnh, ví dụ: bề mặt sàn nhẵn màu đồng nhất. Việc di chuyển mẫu kiểm thử sang một vị trí có bề mặt có kết cấu hoặc đưa các đối tượng xung quanh mẫu kiểm thử thường sẽ giúp ích.
- Tính năng ổn định hình ảnh đang tắt.
- Triệu chứng: Kiểm thử độ nghiêng và độ nghiêng hoạt động tốt, nhưng kiểm thử độ nghiêng thường xuyên không thành công.
Nguyên nhân: Trước tiên, hãy đảm bảo cảm biến trường từ được hiệu chỉnh đúng cách.
Vectơ xoay không hoạt động tốt nếu cảm biến trường từ không được hiệu chỉnh.
Cũng có thể trục nghiêng không hoạt động do quá trình quay video. Giữ thiết bị cố định và đi bộ/di chuyển xung quanh mẫu kiểm thử cho phần kiểm thử độ nghiêng. Khó duy trì chất lượng video trong khi xoay thiết bị trong tay.
Báo cáo phản hồi
Nếu các bước trên không hiệu quả, vui lòng làm theo các bước gửi phản hồi dưới đây để báo cáo vấn đề.
Vui lòng thu thập những thông tin sau khi báo cáo lỗi:
- Báo cáo lỗi Android
- Ảnh chụp màn hình nếu có thông báo lỗi trên màn hình.
- Nội dung của
/sdcard/RVCVRecData/
. Thư mục này chứa các tệp video và do đó có thể khá lớn nếu bạn đã thực hiện kiểm thử nhiều lần. Việc xoá thư mục và thực hiện lại kiểm thử sẽ giúp giảm kích thước. Kiểm tra các tệp video bên trong để tìm các vấn đề rõ ràng trong quá trình quay video.
- Ảnh chụp màn hình ứng dụng Trình quản lý OpenCV.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]