2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main
ではなく android-latest-release
を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。
Android 14 カメラ画像テストスイート リリースノート
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Android 14 リリースでは、カメラ ITS に複数の変更が加えられています。
このページでは、Android 14 のカメラ ITS の変更点をまとめています。変更は大きく 5 つのカテゴリに分類されます。
Python とパッケージのバージョン
Android 14 では、Android 12 および 13 でサポートされている Python のバージョンとライブラリに加えて、次の Python バージョンがサポートされています。
LIMITED カメラのテストを追加
Android 14 では、次のテストがリファクタリングされ、既存のテストにより LIMITED カメラをテストできるようになっています。
シーン |
テスト名 |
説明 |
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 では、次の顔検出テストがリファクタリングされています。
シーン |
テスト名 |
説明 |
2 |
test_num_faces |
顔の多様性を高めるための新しい顔。顔の位置が確認されました。 |
その他のテストの変更
Android 14 では、次のテストがテスト カバレッジの拡大のためリファクタリングされています。
シーン |
テスト名 |
説明 |
0 |
test_read_write |
android.sensor.sensitivityRange の範囲に当てはまらない感度のキャプチャ メタデータ値を報告するようリファクタリングされています。 |
1_1 |
test_burst_sameness_manual |
50 フレームのバーストを 5 回ではなく、50 フレームのバーストを 2 回行うようリファクタリングされています。 |
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 では、次の新しいテストが含まれています。
シーン |
テスト名 |
説明 |
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-05-08 UTC。
[[["わかりやすい","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-05-08 UTC。"],[],[],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"]]