Android 17 攝影機影像測試套件版本資訊

Android 17 版本對相機 ITS 進行了多項變更。本頁面會摘要說明 Android 17 的 Camera ITS 變更。

Python 和套件版本

如果是 Android 17 以上版本，強烈建議使用套件管理軟體，將正確版本的套件組合在一起，為 Android 版本開發作業建立虛擬環境。如需處理大部分必要套件的套件管理工具範例，請參閱 Python 3 說明文件中的 venv。

如要使用 venv 建立虛擬環境，請按照下列步驟操作：

  1. 安裝 Python 3.12 和 python3-venv

    sudo apt install python3.12
sudo apt install python3.12-venv python3.12-dev

  2. 驗證 Python 安裝項目

    python3.12 --version

  3. 更新 apt 並安裝 pip

    sudo apt-get update
sudo apt install python3-pip

  4. 建立虛擬環境

    python3.12 -m venv its_android17_env

  5. 啟動虛擬環境

    source its_android17_env/bin/activate

  6. 使用必要套件清單建立 its_android17_env.txt

    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. 安裝列於 its_android17_env.txt 中的套件

    pip install -r its_android17_env.txt

  8. 使用 FFmpeg 下載器安裝 FFmpeg 7.0.2 版

    pip install ffmpeg-downloader
ffdl install 7.0.2

    (選用) 如果 ffmpeg 下載器無法運作，請從線上來源下載 7.0.2 版。

  9. 驗證 FFmpeg 7.0.2 版安裝項目

    ffmpeg -version

    如果 FFmpeg 版本仍不是 7.0.2，請為二進位檔建立符號連結 (根據 its_android17_env 的儲存位置調整 PATH)。

    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. 確認已安裝的套件

    pip freeze

  11. (選用) 停用環境的指令：

    deactivate

新場景或更新的場景

Android 17 推出下列場景：

場景 說明
gen2_chart 新場景：使用 test_chart_gen2 紙本圖表而非平板電腦場景，提升測試一致性和可靠性。test_chart_gen2 也會用於 scene_ip。
wide_gamut 支援廣色域的平板電腦新場景。
3 使用 ArUco 標記進行圖表偵測，提升速度和可靠性。 這項變更可因應遠距相機測試中出現的各種視野和距離。使用標記會略過目前的尺寸邏輯和最佳化工具問題。詳情請參閱 scene3。
flash 測試可以使用第 2 代設備執行。

新採檢人數

Android 17 導入下列測試：

場景 測試作業名稱 說明
gen2_chart test_tonemap_sequence 確認 android.tonemap.mode 參數已正確套用至一致和不一致的分配方式。
ip test_jca_jpegr_ip 確認 JPEG_R JCA 預覽快照與擷取影像之間的白平衡差異，是否在所選閾值內。
wide_gamut test_display_p3 驗證 P3 JPEG 輸出內容是否具有適當的 ICC 設定檔，且包含超過 1% 的 sRGB 色域以外顏色。

重構測試

在 Android 17 中，下列測試經過重構，可提高測試涵蓋範圍，並以更符合邏輯的方式分組：

場景 測試作業名稱 說明
1_2 tests_param_tonemap_mode tests_param_tonemap_mode 測試的 scene1_2 版本已淘汰，僅適用於搭載 Android 16 以下版本的裝置。
1_2 test_tonemap_sequence 只有在搭載 Android 16 以下版本的裝置上，才會使用 test_tonemap_sequence 測試的 scene1_2 版本。
2_b test_yuv_jpeg_capture_sameness 降低 RMS 差異門檻，確保只要色調相關的色彩差異會造成使用者可見的差異，就會標示為失敗。
3 test_edge_enhancement 使用 ArUco 標記驗證存在與方向。這個方法可穩定偵測超廣角 (UW) 到望遠應用程式的攝影機。
3 test_flip_mirror 使用 ArUco 標記驗證存在與方向。 只有在偵測到所有標記且正確對齊時，才會授予 PASS 狀態。如果圖表遭到位移或旋轉，測試就會失敗。
3 test_landscape_to_portrait 載入更新後的 scene3 圖表，並附上 ArUco 標記。
3 test_lens_movement_report 使用 ArUco 標記驗證存在與方向。這個方法可穩定偵測超廣角 (UW) 到望遠應用程式的攝影機。
4 test_multi_camera_alignment 如果裝置只有一個廣角和一個超望遠攝影機，則略過測試。
flash test_auto_flash 更新測試，確認閃光燈在各種縮放等級都能正常運作。
ip test_default_jca_ip 強制執行現有的檢查：亮度差異、白平衡差異和視野不符。新增 not_yet_mandated 檢查，比較預設相機應用程式和 JCA 擷取的色彩呈現差異。

分開的測試活動

在 Android 17 中，如要在不同裝置上進行平行測試，相機 ITS 測試會分成兩個 CTS 驗證器活動：Camera ITS Test 和 Camera ITS Sensor Fusion Rig Test。Camera ITS Sensor Fusion Rig Test 活動包含 feature_combination 和 sensor_fusion 場景，且可在感應器融合測試裝置中個別執行。下表說明各項活動包含的場景。

活動 場景 說明
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 在 攝影機 ITS-in-a-box 測試裝置和第 2 代測試裝置中執行的場景。
Camera ITS Sensor Fusion Rig Test feature_combination、sensor_fusion 在 感應器融合測試裝置中執行的場景。

已淘汰的測試

在 Android 17 中，由於測試函式已涵蓋其他測試，因此下列測試已遭淘汰：

場景 測試作業名稱 說明
sensor_fusion test_video_stabilization 這項測試已淘汰。請改用 test_video_stabilization_jca。

第 2 代攝影機架更新

Android 17 已將下列測試遷移至 Gen2 測試機：

場景 測試作業名稱 說明
7 test_multi_camera_switch 將測試遷移至第 2 代設備設定，以便使用第 2 代圖表檢查 AE 和 AWB。這項轉換會以實體圖表取代平板電腦目標，消除疊紋效應，並提供更穩定、可重現的測試環境。
flash all tests 已在第 2 代設備中遷移 scene_flash 測試。使用者可以在感應器融合裝置或第 2 代裝置環境中執行這些測試。
sensor_fusion all tests 已將 sensor_fusion 測試遷移至第 2 代設備。使用者可以在感應器融合裝置或第 2 代裝置環境中執行這些測試。

執行遷移後的測試前，請先安裝 Android 17 中推出的第 2 代設備圖表。您可以使用新圖表在第 2 代測試架上執行所有感應器融合測試。詳情請參閱「設定測試用圖表」。

新測試狀態：通過*

17 導入了測試狀態 PASS*，可偵測勉強通過的測試。詳情請參閱「勉強通過測試 (PASS* 測試狀態)」。

改善圖表縮放功能

Android 17 在 config.yml 中新增 chart_scaling 參數，以處理視野較廣的長焦鏡頭裝置的圖表縮放問題。TEST_BED_TABLET_SCENES詳情請參閱「圖表縮放功能改善：chart_scaling 參數」。

支援廣色域測試的新平板電腦

如果是 Android 17 以上版本，Samsung Galaxy Tab S10 FE (Wi-Fi 和 5G 型號) 會列在平板電腦允許清單中。Samsung Galaxy Tab S10 FE 已通過認證，可顯示廣色域測試圖表，以及所有其他平板電腦場景。如要確認裝置是否在允許清單中，請使用 adb shell getprop ro.product.device 指令，確認產品 ID 與下列清單中的值相符。

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

提交匯總結果以核准建構版本

Android 17 推出新程序，可使用更新後的 CTS 驗證器 APK 提交匯總的 Camera ITS 測試結果，以利建構版本核准。

新匯總系統提供下列改良功能：

  • 節省時間：不必在共用相同版本指紋的裝置上，重複重新執行傳遞場景。
  • 平行執行：只要多個裝置共用相同的版本指紋，即可同時測試多個場景。
  • 簡化報表：可將多份 CTS Verifier 報表 (從不同測試執行或裝置收集) 的測試結果匯總為單一提交內容。

詳情請參閱「提交匯總測試結果」。