Ghi chú phát hành của Bộ kiểm thử hình ảnh camera Android 17

Bản phát hành Android 17 có một số thay đổi đối với Camera ITS. Trang này tóm tắt các thay đổi của Camera ITS đối với Android 17.

Python và các phiên bản gói

Đối với Android 17 trở lên, bạn nên dùng phần mềm quản lý gói để kết hợp các phiên bản gói chính xác nhằm tạo một môi trường ảo để phát triển bản phát hành Android. Để biết ví dụ về công cụ quản lý gói xử lý hầu hết các gói bắt buộc, hãy xem tài liệu Python 3 cho venv.

Để tạo môi trường ảo bằng venv, hãy làm theo các bước sau:

  1. Cài đặt Python 3.12 và python3-venv

    sudo apt install python3.12
    sudo apt install python3.12-venv python3.12-dev
    
  2. Xác minh quá trình cài đặt Python

    python3.12 --version
    
  3. Cập nhật apt và cài đặt pip

    sudo apt-get update
    sudo apt install python3-pip
    
  4. Tạo môi trường ảo

    python3.12 -m venv its_android17_env
    
  5. Kích hoạt môi trường ảo

    source its_android17_env/bin/activate
    
  6. Tạo its_android17_env.txt bằng danh sách các gói bắt buộc

    contourpy==1.3.1
    cycler==0.12.1
    fonttools==4.56.0
    imagecodecs==2026.3.6
    ImageIO==2.37.3
    kiwisolver==1.4.8
    lazy-loader==0.5
    matplotlib==3.10.0
    mobly==1.12.3
    mobly-android-partner-tools==1.5.2
    networkx==3.6.1
    numpy==2.2.2
    opencv-python==4.11.0.86
    packaging==24.2
    pillow==11.1.0
    portpicker==1.6.0
    protobuf==6.33.6
    psutil==6.1.1
    pyparsing==3.2.1
    pyserial==3.5
    python-dateutil==2.9.0.post0
    pyudev==0.24.4
    PyYAML==6.0.2
    scikit-image==0.26.0
    scipy==1.15.1
    six==1.17.0
    snippet-uiautomator==1.1.2
    tifffile==2026.3.3
    
  7. Cài đặt các gói có trong its_android17_env.txt

    pip install -r its_android17_env.txt
    
  8. Cài đặt FFmpeg phiên bản 7.0.2 bằng trình tải xuống ffmpeg

    pip install ffmpeg-downloader
    ffdl install 7.0.2
    

    (không bắt buộc) Nếu trình tải xuống ffmpeg không hoạt động, hãy tải phiên bản 7.0.2 xuống từ một nguồn trực tuyến.

  9. Xác minh việc cài đặt FFmpeg phiên bản 7.0.2

    ffmpeg -version
    

    Nếu phiên bản FFmpeg vẫn chưa phải là 7.0.2, hãy liên kết tượng trưng các tệp nhị phân (điều chỉnh PATH dựa trên vị trí bạn lưu its_android17_env).

    ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffmpeg ~/PATH/its_android17_env/bin/ffmpeg
    ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffprobe ~/PATH/its_android17_env/bin/ffprobe
    
  10. Xác minh những gói đã cài đặt

    pip freeze
    
  11. (Không bắt buộc) Lệnh huỷ kích hoạt môi trường:

    deactivate
    

Cảnh mới hoặc cảnh được cập nhật

Android 17 giới thiệu các cảnh sau:

Scene Mô tả
gen2_chart Cảnh mới sử dụng biểu đồ test_chart_gen2trên giấy thay vì cảnh trên máy tính bảng để cải thiện tính nhất quán và độ tin cậy của bài kiểm tra. test_chart_gen2 cũng được dùng trong scene_ip.
wide_gamut Cảnh mới cho máy tính bảng có hỗ trợ gam màu rộng.
3 Sử dụng điểm đánh dấu ArUco để phát hiện biểu đồ nhằm cải thiện tốc độ và độ tin cậy. Thay đổi này phù hợp với phạm vi rộng hơn về trường nhìn và khoảng cách trong quá trình kiểm thử camera từ xa. Việc sử dụng các điểm đánh dấu sẽ bỏ qua logic định cỡ hiện tại và các vấn đề về trình tối ưu hoá. Để biết thêm thông tin, hãy xem scene3.
flash Bạn có thể chạy các bài kiểm thử bằng giàn thử nghiệm Gen2.

Số lượng xét nghiệm mới

Android 17 giới thiệu các kiểm thử sau:

Scene Tên thử nghiệm Mô tả
gen2_chart test_tonemap_sequence Xác minh rằng tham số android.tonemap.mode được áp dụng chính xác cho phân phối đồng nhất và không đồng nhất.
ip test_jca_jpegr_ip Xác minh rằng sự khác biệt về cân bằng trắng giữa ảnh chụp nhanh xem trước JPEG_R JCA và hình ảnh đã chụp nằm trong ngưỡng đã chọn.
wide_gamut test_display_p3 Xác minh đầu ra JPEG P3 có một hồ sơ icc phù hợp và chứa hơn 1% màu bên ngoài gam màu sRGB.

Kiểm thử được tái cấu trúc

Trong Android 17, các bài kiểm thử sau đây được tái cấu trúc để tăng mức độ kiểm thử và nhóm các bài kiểm thử một cách hợp lý hơn:

Scene Tên thử nghiệm Mô tả
1_2 tests_param_tonemap_mode Phiên bản scene1_2 của kiểm thử tests_param_tonemap_mode không được dùng nữa và chỉ được dùng trên các thiết bị chạy Android 16 trở xuống.
1_2 test_tonemap_sequence Phiên bản scene1_2 của bài kiểm thử test_tonemap_sequence chỉ được dùng trên các thiết bị chạy Android 16 trở xuống.
2_b test_yuv_jpeg_capture_sameness Ngưỡng chênh lệch RMS giảm xuống để đảm bảo rằng những điểm khác biệt về màu sắc liên quan đến sắc độ sẽ bị gắn cờ là lỗi bất cứ khi nào chúng gây ra sự khác biệt mà người dùng có thể nhìn thấy.
3 test_edge_enhancement Sử dụng điểm đánh dấu ArUco để xác thực cả sự hiện diện và hướng. Phương thức này cung cấp khả năng phát hiện ổn định cho các camera từ ứng dụng siêu rộng (UW) đến ứng dụng chụp từ xa.
3 test_flip_mirror Sử dụng điểm đánh dấu ArUco để xác thực cả sự hiện diện và hướng. Trạng thái PASS chỉ được cấp nếu tất cả các điểm đánh dấu đều được phát hiện và căn chỉnh chính xác. Thử nghiệm sẽ thất bại đối với các biểu đồ bị di dời hoặc xoay.
3 test_landscape_to_portrait Tải biểu đồ scene3 đã cập nhật bằng điểm đánh dấu ArUco.
3 test_lens_movement_report Sử dụng điểm đánh dấu ArUco để xác thực cả sự hiện diện và hướng. Phương thức này cung cấp khả năng phát hiện ổn định cho các camera từ ứng dụng siêu rộng (UW) đến ứng dụng chụp từ xa.
4 test_multi_camera_alignment Bỏ qua kiểm thử nếu thiết bị chỉ có một camera góc rộng và một camera siêu TELE.
flash test_auto_flash Cập nhật kiểm thử để xác minh rằng đèn flash hoạt động đúng cách ở nhiều mức thu phóng.
ip test_default_jca_ip Bắt buộc các bước kiểm tra hiện có: chênh lệch độ sáng, chênh lệch cân bằng trắng và sai lệch FoV. Thêm chế độ kiểm tra not_yet_mandated để xem sự khác biệt về việc hiển thị màu giữa ứng dụng máy ảnh mặc định và ảnh chụp JCA.

Các hoạt động kiểm thử riêng biệt

Trong Android 17, để kiểm thử song song trên các thiết bị riêng biệt, các kiểm thử ITS camera được tách thành 2 hoạt động của Trình xác minh CTS, Camera ITS TestCamera ITS Sensor Fusion Rig Test. Hoạt động Camera ITS Sensor Fusion Rig Test chứa các cảnh feature_combinationsensor_fusion, đồng thời có thể chạy riêng trong một giàn thử nghiệm kết hợp cảm biến. Bảng sau đây mô tả các cảnh có trong mỗi hoạt động.

Hoạt động Cảnh Mô tả
Camera ITS Test gen2_chart, scene0, scene1_1, scene1_2, scene1_3, scene2_a, scene2_b, scene2_c, scene2_d, scene2_e, scene2_f, scene2_g, scene3, scene4, scene5, scene6, scene8, scene9, scene_flash, scene_hdr, scene_ip, scene_low_light, scene_video, wide_gamut Các cảnh chạy trong thiết bị kiểm thử ITS-in-a-box của camerathiết bị kiểm thử Gen2.
Camera ITS Sensor Fusion Rig Test feature_combination, sensor_fusion Các cảnh chạy trong giàn kiểm thử kết hợp cảm biến.

Kiểm thử không dùng nữa

Trong Android 17, các kiểm thử sau đây không được dùng nữa do hàm kiểm thử được các kiểm thử khác bao gồm:

Scene Tên thử nghiệm Mô tả
sensor_fusion test_video_stabilization Thử nghiệm này không còn được dùng nữa. Thay vào đó, hãy sử dụng test_video_stabilization_jca.

Thông tin cập nhật về giàn khoan thế hệ thứ 2

Android 17, các bài kiểm thử sau đây đã được di chuyển sang giàn Gen2:

Scene Tên thử nghiệm Mô tả
7 test_multi_camera_switch Di chuyển quy trình kiểm thử sang chế độ thiết lập giàn thử nghiệm thế hệ thứ 2 để sử dụng biểu đồ Thế hệ thứ 2 cho các bước kiểm tra AE và AWB. Quá trình chuyển đổi này thay thế các mục tiêu dựa trên máy tính bảng bằng các biểu đồ vật lý để loại bỏ hiệu ứng Moiré và mang đến một môi trường kiểm thử ổn định, có thể tái tạo hơn.
flash all tests Đã di chuyển các kiểm thử scene_flash trong giàn thử nghiệm thế hệ thứ 2. Người dùng có thể thực hiện các kiểm thử này trong môi trường giàn hợp nhất cảm biến hoặc giàn Gen2.
sensor_fusion all tests Di chuyển các kiểm thử sensor_fusion sang giàn thử nghiệm thế hệ thứ 2. Người dùng có thể thực hiện các kiểm thử này trong môi trường giàn hợp nhất cảm biến hoặc giàn Gen2.

Trước khi chạy các kiểm thử đã di chuyển, hãy cài đặt biểu đồ giàn khoan Gen2 được giới thiệu trong Android 17. Biểu đồ mới cho phép bạn chạy tất cả các kiểm thử hợp nhất cảm biến trong giàn thử nghiệm Gen2. Để biết thêm thông tin, hãy xem phần Thiết lập biểu đồ để kiểm thử.

Trạng thái kiểm thử mới: PASS*

17 giới thiệu trạng thái kiểm thử PASS* để phát hiện các kiểm thử chỉ đạt yêu cầu. Để biết thêm thông tin, hãy xem phần Các kiểm thử chỉ đạt (trạng thái kiểm thử PASS*).

Cải thiện khả năng điều chỉnh tỷ lệ biểu đồ

Android 17 thêm tham số chart_scaling trong config.yml cho TEST_BED_TABLET_SCENES để xử lý các vấn đề về việc điều chỉnh tỷ lệ biểu đồ với các thiết bị camera từ xa có trường nhìn (FoV) rộng hơn. Để biết thêm thông tin, hãy xem phần Các điểm cải tiến về việc mở rộng biểu đồ: tham số chart_scaling.

Máy tính bảng mới hỗ trợ kiểm thử gam màu rộng

Đối với Android 17 trở lên, Samsung Galaxy Tab S10 FE (cả mẫu Wi-Fi và 5G) đều có trong danh sách cho phép máy tính bảng. Samsung Galaxy Tab S10 FE được phê duyệt để hiển thị biểu đồ kiểm thử gam màu rộng, cũng như tất cả các cảnh khác dựa trên máy tính bảng. Để xác minh rằng thiết bị của bạn nằm trong danh sách cho phép, hãy dùng lệnh adb shell getprop ro.product.device để xác nhận mã nhận dạng sản phẩm khớp với giá trị được liệt kê trong danh sách sau.

    'gts10fewifi',  # Samsung Galaxy Tab S10 FE
    'gts10fe',  # Samsung Galaxy Tab S10 FE 5G

Gửi kết quả tổng hợp để phê duyệt bản dựng

Android 17 giới thiệu một quy trình gửi kết quả kiểm thử tổng hợp của Camera ITS để phê duyệt bản dựng bằng cách sử dụng APK Trình xác minh CTS đã cập nhật.

Hệ thống tổng hợp mới mang lại những điểm cải tiến sau:

  • Tiết kiệm thời gian: Giúp bạn không cần chạy lại nhiều lần các cảnh vượt qua trên những thiết bị có cùng vân tay số của phiên bản.
  • Thực thi song song: Cho phép kiểm thử đồng thời nhiều cảnh trên nhiều thiết bị, miễn là các thiết bị đó có cùng vân tay số của phiên bản.
  • Báo cáo đơn giản: Cho phép tổng hợp kết quả kiểm thử từ nhiều báo cáo CTS Verifier (thu thập từ nhiều lần chạy kiểm thử hoặc thiết bị) thành một bản gửi duy nhất, hợp nhất.

Để biết thêm thông tin, hãy xem phần Gửi kết quả kiểm thử tổng hợp.