自 2025 年 3 月 27 日起,我們建議您使用 android-latest-release
而非 aosp-main
建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
Android 14 相機圖像測試套件版本資訊
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Android 14 版本對 Camera ITS 進行了許多變更。
本頁面概要說明 Android 14 的相機 ITS 變更。這些異動可分為五大類別:
Python 和套件版本
除了 Android 12 和 13 支援的 Python 版本和程式庫外,Android 14 也支援下列 Python 版本:
增加 LIMITED 相機測試
在 Android 14 中,我們重新整理了下列測試,以便使用現有測試來測試有限的相機。
Scene |
測試名稱 |
說明 |
1_1 |
test_jpeg |
已重構,以便移除 manual_capture() 方法。 |
1_2 |
test_yuv_jpeg_all |
已重構,以便移除 manual_capture() 方法。 |
1_2 |
test_yuv_plus_jpeg |
已重構,以便移除 manual_capture() 方法。 |
1_2 |
test_yuv_plus_raw |
已重構為 manual_capture() 方法。RAW/RAW10/RAW12 測試已合併為單一測試。 |
4 |
test_multi_camera_alignment |
已重構為 manual_capture() 方法。 |
在 Android 14 中,以下臉部偵測測試已重構。
Scene |
測試名稱 |
說明 |
2 |
test_num_faces |
新增更多臉孔,讓臉孔多樣性更高。確認臉孔位置。 |
其他測試變更
在 Android 14 中,我們重新整理了下列測試,以提高測試涵蓋率。
Scene |
測試名稱 |
說明 |
0 |
test_read_write |
已重構,以標記擷取敏感度中繼資料值的值,該值超出 android.sensor.sensitivityRange 的範圍。 |
1_1 |
test_burst_sameness_manual |
已重構,改為執行兩個 50 張影格快照,而非五個 50 張影格快照。 |
1_2 |
test_yuv_jpeg_all |
重構為使用 STILL_CAPTURE 用途 (如有)。 |
1_2 |
test_yuv_plus_jpeg |
重構為使用 STILL_CAPTURE 用途 (如有)。 |
4 |
test_multi_camera_alignment |
已重構,以便新增 YUV 擷取功能,並將 640x360 擷取功能新增至現有的 640x480 擷取功能。 |
新測試
Android 14 包含下列新測試。
Scene |
測試名稱 |
說明 |
2_a |
test_autoframing |
驗證自動構圖功能可調整 FoV,無論設定的縮放比例為何,都能納入所有膚色的臉孔。 |
2_a |
test_display_p3 |
驗證 P3 JPEG 輸出內容是否正確。 |
2_a |
test_preview_min_frame_rate |
確認在低光源環境下,預覽 FPS 達到相機屬性定義的最低值。 |
3 |
test_landscape_to_portrait |
驗證橫向至直向覆寫功能是否能正確旋轉圖片。 |
4 |
test_preview_aspect_ratio_and_crop |
驗證 Preview 串流顯示比例、裁剪和 FoV 是否適合支援的格式。 |
6 |
test_in_sensor_zoom |
驗證相機在感測器內縮放的行為。 |
6 |
test_low_latency_zoom |
確認設定覆寫變焦功能時,變焦比例是否正確縮放。 |
6 |
test_preview_video_zoom_match |
驗證在 Preview 和 Video 串流中,縮放功能的運作方式是否相同。 |
擴充功能 |
test_hdr_extension |
驗證 HDR 擴充功能在要求時是否正確啟用。 |
擴充功能 |
test_night_extension |
驗證 Night 擴充功能在要求時是否正確啟用。 |
sensor_fusion |
test_led_snapshot |
驗證 LED 快照不會使圖像過飽和或產生色調。 |
平行 DUT 測試
Android 14 支援平行 DUT 測試,可讓您同時使用多個測試平台測試 DUT,加快整體測試速度。舉例來說,平行測試可讓您同時測試一個裝置中的相機 0 和另一個裝置中的相機 1。
詳情請參閱「平行 DUT 測試」。
測試規定
圖 1 顯示 Android 14 ITS 秘密解碼環。密碼解碼環會顯示個別測試的限制條件。由 android.request.availableCapabilities
控管的測試設定會以大寫字母顯示。主要的門檻項目如下:
MANUAL_SENSOR
READ_3A
PER_FRAME_CONTROL
RAW
faceDetectModes
timestampSource
flash.info.available
圖 1. Android 14 ITS 密碼解碼器
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Android 14 Camera Image Test Suite Release Notes\n\nThe Android 14 release includes a number of changes to\n[Camera ITS](/docs/compatibility/cts/camera-hal#its_tests).\n\nThis page summarizes the Camera ITS changes for Android\n14. The changes fall into five broad categories:\n\n- [Python and package versions](#package-versions)\n- [Increased LIMITED camera testing](#increased-limited-camera-testing)\n- [Increased face-related testing](#increased-face-related-testing)\n- [Other test changes](#other-test-changes)\n- [New tests](#new-tests)\n- [Parallel DUT testing](#parallel-dut-testing)\n\nPython and package versions\n---------------------------\n\nAndroid 14 supports the following Python versions in\naddition to the Python versions and libraries supported in Android\n12 and 13:\n\n- [Python 3.9.2](https://www.python.org/downloads/)\n- [OpenCV 4.2.0](https://opencv.org/)\n- [Numpy 1.20.3](https://numpy.org/)\n- [Matplotlib 3.4.1](https://matplotlib.org/)\n- [Scipy 1.6.2](https://docs.scipy.org/doc/)\n- [pySerial 3.5](https://pyserial.readthedocs.io/)\n- [Pillow 8.3.1](https://pypi.org/project/Pillow/)\n- [PyYAML 5.4.1](https://pypi.org/project/PyYAML/)\n- [Mobly 1.11](https://github.com/google/mobly)\n- [FFmpeg 4.4.1](https://ffmpeg.org/)\n- (For Display P3 tests only) [Colour-science 0.4.2](https://pypi.org/project/colour-science/)\n\nIncreased LIMITED camera testing\n--------------------------------\n\nIn Android 14, the following tests are refactored\nto enable testing of LIMITED cameras with existing tests.\n\n| **Scene** | **Test name** | **Description** |\n|-----------|-----------------------------|-----------------------------------------------------------------------------------------------|\n| 1_1 | test_jpeg | Refactored to eliminate the `manual_capture()` method. |\n| 1_2 | test_yuv_jpeg_all | Refactored to eliminate the `manual_capture()` method. |\n| 1_2 | test_yuv_plus_jpeg | Refactored to eliminate the `manual_capture()` method. |\n| 1_2 | test_yuv_plus_raw | Refactored to the `manual_capture()` method. RAW/RAW10/RAW12 testing merged to a single test. |\n| 4 | test_multi_camera_alignment | Refactored to the `manual_capture()` method. |\n\nIncreased face-related testing\n------------------------------\n\nIn Android 14, the following face detection\ntests are refactored.\n\n| **Scene** | **Test name** | **Description** |\n|-----------|----------------|-------------------------------------------------------------------|\n| 2 | test_num_faces | New faces for increased face diversity. Face locations confirmed. |\n\n\u003cbr /\u003e\n\nOther test changes\n------------------\n\nIn Android 14, the following tests are refactored to\nincrease test coverage.\n\n| **Scene** | **Test name** | **Description** |\n|-----------|-----------------------------|--------------------------------------------------------------------------------------------------------------------|\n| 0 | test_read_write | Refactored to flag capture metadata values for sensitivity that fall outside of `android.sensor.sensitivityRange`. |\n| 1_1 | test_burst_sameness_manual | Refactored to do two bursts of 50 frames rather than five bursts of 50 frames. |\n| 1_2 | test_yuv_jpeg_all | Refactored to use the `STILL_CAPTURE` use case if available. |\n| 1_2 | test_yuv_plus_jpeg | Refactored to use the `STILL_CAPTURE` use case if available. |\n| 4 | test_multi_camera_alignment | Refactored to add YUV captures and to add `640x360` captures to the existing `640x480` captures. |\n\n\u003cbr /\u003e\n\nNew tests\n---------\n\nAndroid 14 includes the following new tests.\n\n| **Scene** | **Test name** | **Description** |\n|---------------|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|\n| 2_a | test_autoframing | Verifies that autoframing can adjust the FoV to include all faces with different skin tones regardless of the zoom ratio set. |\n| 2_a | test_display_p3 | Verifies `P3 JPEG` output is correct. |\n| 2_a | test_preview_min_frame_rate | Verifies that preview FPS reaches minimum defined by camera properties under low light conditions. |\n| 3 | test_landscape_to_portrait | Verifies landscape to portrait override rotates image properly. |\n| 4 | test_preview_aspect_ratio_and_crop | Verifies `Preview` stream aspect ratio, crop, and FoV are appropriate for supported formats. |\n| 6 | test_in_sensor_zoom | Verifies the camera in-sensor zoom behavior. |\n| 6 | test_low_latency_zoom | Verifies zoom ratio scales correctly if settings override zoom is set. |\n| 6 | test_preview_video_zoom_match | Verifies that zoom behaves the same in `Preview` and `Video` streams. |\n| extensions | test_hdr_extension | Verifies `HDR` extension activates correctly when requested. |\n| extensions | test_night_extension | Verifies `Night` extension activates correctly when requested. |\n| sensor_fusion | test_led_snapshot | Verifies LED snapshots don't saturate or tint image. |\n\nParallel DUT testing\n--------------------\n\nAndroid 14 supports parallel DUT testing, which lets\nyou test DUTs in parallel with multiple rigs to speed up overall testing. For\nexample, parallel testing lets you test camera 0 in one rig and camera 1 in\nanother rig at the same time.\n\nFor more details, see\n[Parallel DUT testing](/docs/compatibility/cts/camera-its#parallel-dut-testing).\n\nTest requirements\n-----------------\n\nFigure 1 shows the Android 14 ITS *secret\ndecoder ring* . The secret decoder ring shows what test settings individual\ntests are gated by. Test settings gated by\n`android.request.availableCapabilities` are in uppercase letters.\nThe main gating items are:\n\n- `MANUAL_SENSOR`\n- `READ_3A`\n- `PER_FRAME_CONTROL`\n- `RAW`\n- `faceDetectModes`\n- `timestampSource`\n- `flash.info.available`\n\n**Figure 1.** Android 14 ITS secret decoder ring"]]