Danh sách kiểm tra kiểm thử HAL cho máy ảnh

Trang này liệt kê tất cả các bài kiểm thử có sẵn để đánh giá lớp trừu tượng phần cứng (HAL) của máy ảnh Android. Tài liệu này dành cho nhà sản xuất thiết bị gốc (OEM) và nhà cung cấp bộ xử lý ứng dụng (AP) để họ có thể đảm bảo triển khai đúng cách HAL máy ảnh với số lỗi tối thiểu. Mặc dù đây là phần bổ sung tự nguyện cho Bộ kiểm thử tính tương thích với Android (CTS), nhưng phần này giúp tăng đáng kể phạm vi kiểm thử máy ảnh và chắc chắn sẽ xác định được các lỗi tiềm ẩn.

Bằng cách vượt qua các bài kiểm thử này, OEM xác thực xem họ đã tích hợp đúng cách các giao diện lớp trừu tượng phần cứng máy ảnh Android (HAL) 3 hay chưa. Khi tuân thủ tất cả các mục trong danh sách kiểm tra, việc triển khai thiết bị có thể được coi là đầy đủ đối với các giao diện HAL của Máy ảnh Android. Điều này sẽ giúp thiết bị hỗ trợ đúng cách gói android.hardware.camera2 mà các ứng dụng máy ảnh xây dựng dựa trên đó.

Thông số kỹ thuật của Camera HAL3

Thông số kỹ thuật Android Camera HAL3 là nguồn thông tin chính thức về những yêu cầu mà thiết bị phải đáp ứng; trang này cung cấp bản tóm tắt về tất cả các bài kiểm thử có thể dùng làm danh sách kiểm tra. Những người triển khai HAL cho máy ảnh (ví dụ: nhà cung cấp AP) nên xem từng dòng trong bản đặc tả HAL3 cho máy ảnh và đảm bảo thiết bị của họ tuân thủ bản đặc tả đó.

Thông số kỹ thuật HAL hiện tại được xác định trong các tệp này trong Bộ phát triển nền tảng Android (PDK) chung từ Android 5.0 trở lên:

Các loại kiểm thử máy ảnh

Dưới đây là các loại kiểm thử chính có sẵn cho máy ảnh Android mới nhất cùng với các tài liệu tham khảo về hướng dẫn liên quan:

Tất cả các loại kiểm thử này được mô tả chi tiết bên dưới. Các chương trình kiểm thử này được trình bày theo thứ tự thời gian mà nhà sản xuất thiết bị gốc (OEM) dự kiến sẽ thực thi.

Ví dụ: nếu không vượt qua được các bài kiểm thử gốc, thì chắc chắn thiết bị sẽ không vượt qua được các bài kiểm thử tiếp theo trong Bộ kiểm thử tính tương thích (CTS). Và nếu một thiết bị không vượt qua được CTS, thì việc tiếp tục với Bộ kiểm thử hình ảnh (ITS) sẽ không mang lại nhiều lợi ích. Bạn nên giải quyết các lỗi trong từng loại kiểm thử trước khi chuyển sang nhóm kiểm thử tiếp theo.

Kiểm thử Bộ kiểm thử nhà cung cấp (VTS)

Bộ kiểm thử nhà cung cấp Android (VTS) là một bộ kiểm thử hoạt động ở cấp giao diện HIDL. Để biết thêm thông tin về cách sử dụng VTS, hãy xem bài viết Bộ kiểm thử nhà cung cấp.

Các bài kiểm thử trong Bộ kiểm tra tính tương thích (CTS)

Các bài kiểm thử trong Bộ kiểm tra tính tương thích với Android (CTS) cho máy ảnh tập trung vào khả năng tương thích của thiết bị. Để biết thông tin về cách thiết lập môi trường kiểm thử, hãy xem phần Thiết lập CTS.

Đường dẫn bắt đầu cho các kiểm thử CTS của máy ảnh là: platform/cts.

Khi chạy CTS máy ảnh cho các thiết bị hỗ trợ máy ảnh bên ngoài (chẳng hạn như webcam USB), bạn phải cắm thiết bị khi chạy CTS, nếu không các bài kiểm thử sẽ tự động không đạt. Ví dụ về máy ảnh bên ngoài: Logitech HD Pro Webcam C920 và Microsoft LifeCam HD-3000.

Hãy xem giới thiệu về CTS và các trang con của bài viết này để biết hướng dẫn chung về cách chạy CTS.

Kiểm thử CTS cho API android.hardware.Camera

Tìm các chương trình kiểm thử máy ảnh này trong cts/tests/tests/:

  • hardware/src/android/hardware/cts/CameraTest.java
  • hardware/src/android/hardware/cts/CameraGLTest.java
  • hardware/src/android/hardware/cts/Camera_SizeTest.java
  • permission/src/android/permission/cts/CameraPermissionTest.java

Kiểm thử CTS cho API android.hardware.camera2

Tìm các chương trình kiểm thử máy ảnh này trong cts/tests/tests/:

  • hardware/src/android/hardware/camera2/cts/*
  • permission/src/android/permission/cts/Camera2PermissionTest.java

Kiểm thử máy ảnh bằng Trình xác minh CTS

Bạn có thể tìm thấy các bài kiểm thử máy ảnh này trong: cts/apps/CtsVerifier/src/com/android/cts/verifier/camera/*

Kiểm thử Bộ kiểm thử hình ảnh (ITS)

Bộ kiểm thử hình ảnh máy ảnh (ITS) tập trung vào độ chính xác của hình ảnh. Để thực hiện kiểm thử, hãy chạy tập lệnh Python trên máy trạm có thiết bị Android được kết nối qua USB.

Cơ sở hạ tầng và kiểm thử ITS của Camera nằm trong thư mục cts/apps/CameraITS. Mỗi bài kiểm thử nằm trong một thư mục con tests/scene#.

Để biết thêm thông tin về cách thiết lập và chạy các chương trình kiểm thử, hãy xem phần Camera ITS.

Để biết nội dung mô tả cảnh và kiểm thử, hãy xem phần Kiểm thử ITS bằng máy ảnh.

Kiểm thử ITS có thể đạt hoặc không đạt. Tất cả các bài kiểm thử bắt buộc trong mỗi thư mục cảnh đều phải vượt qua. Các bài kiểm thử không bắt buộc có thể không đạt nhưng vẫn được tính là đạt trong CtsVerifier.

ITS kiểm thử các tình huống không được kiểm thử trong CTS và là một thành phần quan trọng của kế hoạch kiểm thử HAL 3.2.

Kiểm thử Khung nội dung nghe nhìn

Đạt tất cả các bài kiểm thử nội dung nghe nhìn liên quan đến máy ảnh trong MediaFrameworkTest. Xin lưu ý rằng các kiểm thử này yêu cầu bạn phải cài đặt mediaframeworktest.apk trên thiết bị Android. Bạn sẽ cần make mediaframeworktest rồi sử dụng adb để cài đặt tệp .apk thu được. Dưới đây là các lệnh mẫu.

Đường dẫn bắt đầu cho các kiểm thử khung nội dung đa phương tiện liên quan đến Máy ảnh là: platform/frameworks/base

Tìm mã nguồn cho các chương trình kiểm thử tại đây: frameworks/base/media/tests/MediaFrameworkTest

Cách thiết lập các bài kiểm thử này:

make mediaframeworktest
adb install out/target/product/name/data/app/mediaframeworktest.apk

Trong đó, biến name đại diện cho thư mục chứa sản phẩm của nhà cung cấp.

Tìm tất cả các chương trình kiểm thử trong thư mục sau hoặc các thư mục con của thư mục đó:

frameworks/base/media/tests/MediaFrameworkTest/src/com/android/mediaframeworktest

Mỗi thư mục con đại diện cho một lớp kiểm thử:

  • functional/
  • integration/
  • performance/
  • power/
  • stress/
  • unit/

Chạy kiểm thử Khung nội dung nghe nhìn

Cách xem tất cả các bài kiểm thử có sẵn:

adb shell pm list instrumentation

Thao tác này sẽ trả về kết quả tương tự như sau:

instrumentation:com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaRecorderStressTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaFrameworkPowerTestRunner
(target=com.android.mediaframeworktest)

Xác định và trích xuất thành phần (giữa instrumentation: và (target=com.android.mediaframeworktest) từ mỗi dòng kiểm thử. Thành phần này bao gồm tên gói mục tiêu (com.android.mediaframeworktest) và tên trình chạy kiểm thử (MediaFrameworkTestRunner).

Ví dụ:

com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner
com.android.mediaframeworktest/.MediaRecorderStressTestRunner
com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner
com.android.mediaframeworktest/.MediaFrameworkPowerTestRunner

Sau đó, bạn có thể truyền từng thành phần đến adb shell am instrument như sau:

adb shell am instrument -w component.name

Trong đó component.name bằng giá trị được trích xuất ở trên. Ví dụ:

adb shell am instrument -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Xin lưu ý rằng mặc dù đường dẫn lớp là gói Java + tên lớp, nhưng gói đo lường không nhất thiết phải giống với gói Java. Hãy đảm bảo bạn sử dụng gói AndroidManifest.xml khi nối tên thành phần, chứ không phải gói Java chứa lớp trình chạy kiểm thử.

Để chạy một lớp kiểm thử, hãy truyền đối số lớp -e, như sau:

adb shell am instrument -e class com.android.mediaframeworktest.integration.CameraBinderTest -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Để chỉ chạy một phương thức trong lớp kiểm thử, hãy thêm dấu thăng (#) và tên phương thức (trong trường hợp này là testConnectPro) vào tên lớp, như sau:

adb shell am instrument -e class 'com.android.mediaframeworktest.integration.CameraBinderTest#testConnectPro' -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Kiểm thử chức năng của chế độ cài đặt nội dung nghe nhìn

Dưới đây là ví dụ về một lần chạy kiểm thử chức năng. Kiểm thử này xác minh chức năng cơ bản của nhiều tổ hợp chế độ cài đặt máy ảnh. (tức là Đèn flash, độ phơi sáng, WB, cảnh, kích thước ảnh và thẻ địa lý)

Chạy lệnh kiểm thử:

adb shell am instrument -w -r  -e delay_msec 15 -e log true -e class com.android.mediaframeworktest.functional.camera.CameraPairwiseTest com.android.mediaframeworktest/com.android.mediaframeworktest.CameraStressTestRunner

Kiểm thử tích hợp nội dung nghe nhìn

Dưới đây là ví dụ về một lần chạy kiểm thử tích hợp, trong trường hợp này là mediaframeworktest/integration/CameraBinderTest.java và mediaframeworktest/CameraStressTestRunner.java:

adb  shell am instrument -e class \ 'com.android.mediaframeworktest.integration.CameraBinderTest' -w \ 'com.android.mediaframeworktest/.CameraStressTestRunner'

Nếu thành công, thao tác này sẽ dẫn đến kết quả tương tự như sau:

-----

com.android.mediaframeworktest.integration.CameraBinderTest:...........
Test results for CameraStressTestRunner=...........
Time: 3.328

OK (11 tests)

-----

Kiểm thử hiệu suất nội dung nghe nhìn

Quy trình kiểm thử bộ nhớ xem trước này sẽ mở và phát hành bản xem trước của máy ảnh 200 lần. Trong mỗi 20 lần lặp lại, bản tổng quan nhanh của máy chủ nội dung nghe nhìn ps sẽ được ghi lại và sẽ so sánh mức sử dụng bộ nhớ khác nhau sau 200 lần lặp lại. Kiểm thử sẽ không thành công nếu chênh lệch lớn hơn 150 km.

Chạy lệnh kiểm thử:

adb shell am instrument -w -r  -e class com.android.mediaframeworktest.performance.MediaPlayerPerformance#testCameraPreviewMemoryUsage com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner

Bạn có thể xem kết quả chi tiết hơn trong: /sdcard/mediaMemOutput.txt

Kiểm thử đơn vị nội dung nghe nhìn

Các lệnh để chạy kiểm thử đơn vị đều tương tự nhau. Ví dụ: đối với CameraMetadataTest.java, lệnh sẽ là:

adb shell am instrument -e class 'com.android.mediaframeworktest.unit.CameraMetadataTest' -w 'com.android.mediaframeworktest/.CameraStressTestRunner'

Kiểm thử nghiêm ngặt nội dung nghe nhìn

Bài kiểm thử này nhằm nhấn mạnh khả năng chụp ảnh và quay video của máy ảnh.

Chạy lệnh kiểm thử:

adb shell am instrument -w com.google.android.camera.tests/com.android.camera.stress.CameraStressTestRunner

Tất cả các bài kiểm thử đều phải đạt.

Kiểm thử thủ công bằng TestingCam

Bạn nên chạy ứng dụng TestingCam theo cách thủ công bằng cách thực hiện các bước kiểm tra sau. Nguồn của TestingCam tại đây: pdk/apps/TestingCamera/

Tiêu điểm vô cực khi nghiêng máy ảnh

Khởi động TestingCam, bật chế độ xem trước và đảm bảo chế độ tự động lấy nét được đặt thành vô cực. Sử dụng nút Chụp ảnh để chụp các đối tượng ở xa (cách xa ít nhất 10m) với máy ảnh hướng theo chiều ngang, hướng lên trên (gần như theo chiều dọc) và hướng xuống dưới (gần như theo chiều dọc); ví dụ về ảnh chụp hướng lên trên có thể là lá/cành cây cao từ bên dưới và ví dụ về ảnh chụp hướng xuống dưới có thể là đường phố nhìn từ mái nhà. Trong mọi trường hợp, đối tượng ở xa phải sắc nét và rõ nét. Lưu và xem các bức ảnh ở chế độ xem thư viện để bạn có thể phóng to và kiểm tra độ sắc nét dễ dàng hơn.

Xin lưu ý rằng để vượt qua bài kiểm thử này, máy ảnh có bộ truyền động VCM sẽ cần có hệ thống điều khiển AF vòng kín hoặc cần có một số loại hiệu chỉnh phần mềm dựa trên việc sử dụng dữ liệu gia tốc kế để xác định hướng máy ảnh. Bạn cũng cần hiệu chuẩn vị trí vô cực của ống kính một cách đáng tin cậy tại nhà máy.

Kiểm thử thủ công các bài kiểm thử Cam2

Bạn nên chạy ứng dụng TestingCam2 theo cách thủ công, với các bước kiểm tra sau. Nguồn cho TestingCam2 tại đây: pdk/apps/TestingCamera2/

Quay video JPEG

Khởi động TestingCam2 rồi nhấn nút JPEG. Hình ảnh xuất hiện ở bên phải hình ảnh trong kính ngắm phải giống với kính ngắm, bao gồm cả việc có cùng hướng.