החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
הערות לגרסה של ערכת הבדיקה של תמונות המצלמה ב-Android 14
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במהדורת Android 14 יש כמה שינויים ב-Camera ITS.
בדף הזה מפורט סיכום של השינויים ב-ITS של המצלמה ב-Android 14. השינויים מתחלקים לחמש קטגוריות רחבות:
גרסאות Python וחבילות
ב-Android 14 יש תמיכה בגרסאות Python הבאות, בנוסף לגרסאות ולספריות Python שנתמכות ב-Android 12 וב-Android 13:
בדיקות מצלמה מורחבות ומוגבלות
ב-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 |
בדיקה אם התכונה 'מסגרת אוטומטית' יכולה לשנות את שדה הראייה כך שיכלול את כל הפנים בגווני עור שונים, ללא קשר ליחס הזום שהוגדר. |
| 2_a |
test_display_p3 |
מוודאים שהפלט של P3 JPEG נכון. |
| 2_a |
test_preview_min_frame_rate |
בדיקה שהקצב של התצוגה המקדימה מגיע לקצב הפריימים המינימלי שמוגדר במאפייני המצלמה בתנאים של תאורה נמוכה. |
| 3 |
test_landscape_to_portrait |
בדיקה שהתמונה מסתובבת כמו שצריך כשמשנים את הכיוון מאופקי לאנכי. |
| 4 |
test_preview_aspect_ratio_and_crop |
בדיקה שהיחס של Preview בין גובה לרוחב, החיתוך והשדה החזותי מתאימים לפורמטים הנתמכים. |
| 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 במקביל, שמאפשרות לבדוק DUTs במקביל במספר מכשירים כדי לזרז את תהליך הבדיקה הכולל. לדוגמה, בדיקה במקביל מאפשרת לבדוק את מצלמה 0 במתקן אחד ואת מצלמה 1 במתקן אחר בו-זמנית.
פרטים נוספים זמינים במאמר בדיקת DUT במקביל.
דרישות הבדיקה
באיור 1 מוצג הטבעת הסודית של מפענח ה-ITS ב-Android 14. ב'טבעת הפענוח הסודית' מוצגות הגדרות הבדיקה של כל בדיקה. הגדרות הבדיקה שמאובטחות באמצעות android.request.availableCapabilities הן באותיות רישיות.
הקריטריונים העיקריים להעברה הם:
MANUAL_SENSORREAD_3APER_FRAME_CONTROLRAWfaceDetectModestimestampSourceflash.info.available
איור 1. טבעת הפענוח הסודית של ITS ב-Android 14
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון 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-07-27 (שעון 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"]]
