החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
מצלמות מונוכרום
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במכשירים עם Android מגרסה 9 ואילך יש תמיכה במצלמות מונוכרום. ב-Android 10 יש תמיכה נוספת בפורמט הסטרימינג Y8, במטא-נתונים סטטיים של מערך מסנני צבע מונוכרומטיים ושל אינפרה-אדום קרוב (NIR), ובפונקציות DngCreator למצלמות מונוכרום.
בעזרת היכולת הזו, יצרני המכשירים יכולים להטמיע מצלמה מונוכרומטית או מצלמת NIR ולצמצם את השימוש בזיכרון באמצעות פורמט הסטרימינג Y8. מצלמה מונוכרומטית יכולה לשמש כמצלמה הפיזית הבסיסית של מכשיר לוגי עם כמה מצלמות כדי להשיג מאפייני רעש טובים יותר בתאורה נמוכה.
הטמעה
דרישות חומרה
כדי להטמיע את התכונה הזו, המכשיר צריך לכלול חיישן מצלמה מונוכרומטי ומעבד אותות תמונה (ISP) כדי לעבד את הפלט של החיישן.
הטמעת מצלמה מונוכרומטי
כדי לפרסם מכשיר מצלמה כמצלמה מונוכרום, Camera HAL צריך לעמוד בדרישות הבאות:
android.sensor.info.colorFilterArray מוגדר לערך MONO או NIR.- יש תמיכה במפתחות הנדרשים
BACKWARD_COMPATIBLE, ואין תמיכה ב-MANUAL_POST_PROCESSING.
android.control.awbAvailableModes מכיל רק AUTO ו-android.control.awbState הוא CONVERTED או LOCKED, בהתאם ל-android.control.awbLock.- המפתחות
android.colorCorrection.mode, android.colorCorrection.transform ו-android.colorCorrection.gains לא נכללים במפתחות הבקשה והתוצאה הזמינים. לכן, המכשיר עם המצלמה הוא LIMITED.
מפתחות המטא-נתונים הסטטיים הבאים שקשורים לצבע לא נמצאים:
android.sensor.referenceIlluminant*android.sensor.calibrationTransform*android.sensor.colorTransform*android.sensor.forwardMatrix*android.sensor.neutralColorPointandroid.sensor.greenSplit
לכל ערוצי הצבע יש את אותם ערכים למפתחות המטא-נתונים הבאים:
android.sensor.blackLevelPatternandroid.sensor.dynamicBlackLevelandroid.statistics.lensShadingMapandroid.tonemap.curve
ל-android.sensor.noiseProfile יש רק ערוץ צבע אחד.
במכשירים מונוכרום שתומכים בפורמטים של סטרימינג Y8, ה-HAL של המצלמה חייב לתמוך בהחלפה של פורמטים YUV_420_888 בשילובי סטרימינג חובה (כולל עיבוד חוזר) עם פורמטים Y8.
התכונה הזו משתמשת בממשקי ה-API הציבוריים הבאים:
פרטים נוספים על Camera HAL זמינים במאמר docs.html.
מידע נוסף על ממשקי API ציבוריים קשורים זמין במאמרים ImageFormat, CameraCharacteristics, CaptureRequest ו-CaptureResult.
אימות
כדי לאמת את ההטמעה של מצלמה מונוכרומטית, צריך להריץ את בדיקות ה-CTS וה-VTS הבאות.
בדיקות CTS
testMonochromeCharacteristicsCaptureRequestTestCaptureResultTestStillCaptureTestDngCreatorTest
בדיקות VTS
getCameraCharacteristicsprocessMultiCaptureRequestPreview
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון 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-26 (שעון UTC)."],[],[],null,["# Monochrome cameras\n\nDevices running Android 9 or higher can support\nmonochrome cameras. Android 10\nprovides additional support for the Y8 stream format, monochrome and\nnear-infrared (NIR) color filter array\nstatic metadata, and `DngCreator` functions for monochrome cameras.\n\nWith this capability, device manufacturers can implement a monochrome or\nNIR camera device and reduce memory use by using\nthe Y8 stream format. A monochrome camera can serve as the underlying physical\ncamera of a\n[logical multi-camera device](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA)\nto achieve better low-light noise characteristics.\n\nImplementation\n--------------\n\n### Hardware requirements\n\nTo implement this feature, your device must have a monochrome camera sensor and\nan image signal processor (ISP) to process the sensor output.\n\n### Implement a monochrome camera\n\nTo advertise a camera device as a monochrome camera, the\n[Camera HAL](/docs/core/camera/camera3) must meet\nthe following requirements:\n\n- `android.sensor.info.colorFilterArray` is set to `MONO` or `NIR`.\n- `BACKWARD_COMPATIBLE` required keys are supported and `MANUAL_POST_PROCESSING` isn't supported.\n- `android.control.awbAvailableModes` only contains `AUTO` and `android.control.awbState` is either `CONVERTED` or `LOCKED` depending on `android.control.awbLock`.\n- `android.colorCorrection.mode`, `android.colorCorrection.transform`, and `android.colorCorrection.gains` aren't in available request and result keys. As a result, the camera device is [`LIMITED`](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata.html#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED).\n- The following color-related static metadata keys aren't present:\n\n - `android.sensor.referenceIlluminant*`\n - `android.sensor.calibrationTransform*`\n - `android.sensor.colorTransform*`\n - `android.sensor.forwardMatrix*`\n - `android.sensor.neutralColorPoint`\n - `android.sensor.greenSplit`\n- All color channels have the same values for the following metadata keys:\n\n - `android.sensor.blackLevelPattern`\n - `android.sensor.dynamicBlackLevel`\n - `android.statistics.lensShadingMap`\n - `android.tonemap.curve`\n- `android.sensor.noiseProfile` has only one color channel.\n\nFor monochrome devices supporting Y8 stream formats, the Camera HAL must support\nswapping `YUV_420_888` formats in mandatory stream combinations (including\nreprocessing) with Y8 formats.\n\nThe following public APIs are used in this feature:\n\n- [Y8 image format](https://developer.android.com/reference/android/graphics/ImageFormat#Y8)\n- [SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_MONO](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_MONO)\n- [SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_NIR](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_NIR)\n- [MONOCHROME camera capability](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MONOCHROME) (introduced in Android 9)\n\nFor more details on the Camera HAL, see\n[docs.html](https://android.googlesource.com/platform/system/media/+/android16-release/camera/docs/docs.html).\nFor more information on related public APIs, see\n[ImageFormat](https://developer.android.com/reference/android/graphics/ImageFormat),\n[CameraCharacteristics](https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics),\n[CaptureRequest](https://developer.android.com/reference/android/hardware/camera2/CaptureRequest),\nand\n[CaptureResult](https://developer.android.com/reference/android/hardware/camera2/CaptureResult).\n\nValidation\n----------\n\nTo validate your implementation of a monochrome camera, run the following CTS\nand VTS tests.\n\n### CTS tests\n\n- `testMonochromeCharacteristics`\n- `CaptureRequestTest`\n- `CaptureResultTest`\n- `StillCaptureTest`\n- `DngCreatorTest`\n\n### VTS tests\n\n- `getCameraCharacteristics`\n- `processMultiCaptureRequestPreview`"]]
