از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
دوربین های تک رنگ
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
دستگاه‌های دارای اندروید ۹ یا بالاتر می‌توانند از دوربین‌های تک رنگ پشتیبانی کنند. اندروید 10 پشتیبانی بیشتری از فرمت جریان Y8، ابرداده‌های استاتیک فیلتر رنگی تک رنگ و مادون قرمز نزدیک (NIR) و عملکردهای DngCreator برای دوربین‌های تک رنگ ارائه می‌کند.
با این قابلیت، سازندگان دستگاه می توانند یک دستگاه دوربین تک رنگ یا NIR را پیاده سازی کنند و با استفاده از فرمت استریم Y8 استفاده از حافظه را کاهش دهند. یک دوربین تک رنگ می تواند به عنوان دوربین فیزیکی زیربنایی یک دستگاه منطقی چند دوربینه برای دستیابی به ویژگی های نویز کم نور بهتر عمل کند.
پیاده سازی
الزامات سخت افزاری
برای اجرای این ویژگی، دستگاه شما باید دارای یک سنسور دوربین تک رنگ و یک پردازنده سیگنال تصویر (ISP) برای پردازش خروجی سنسور باشد.
یک دوربین تک رنگ پیاده سازی کنید
برای تبلیغ یک دستگاه دوربین به عنوان یک دوربین تک رنگ، دوربین HAL باید شرایط زیر را داشته باشد:
-
android.sensor.info.colorFilterArray روی MONO یا NIR تنظیم شده است. - کلیدهای مورد نیاز
BACKWARD_COMPATIBLE پشتیبانی می شوند و MANUAL_POST_PROCESSING پشتیبانی نمی شود. -
android.control.awbAvailableModes فقط شامل AUTO و android.control.awbState بسته به android.control.awbLock یا CONVERTED می شود یا LOCKED . -
android.colorCorrection.mode ، android.colorCorrection.transform ، و android.colorCorrection.gains در کلیدهای درخواست و نتیجه موجود نیستند. در نتیجه، دستگاه دوربین LIMITED است. کلیدهای فراداده ایستا مرتبط با رنگ زیر وجود ندارند:
-
android.sensor.referenceIlluminant* -
android.sensor.calibrationTransform* -
android.sensor.colorTransform* -
android.sensor.forwardMatrix* -
android.sensor.neutralColorPoint -
android.sensor.greenSplit
همه کانال های رنگی مقادیر یکسانی برای کلیدهای فراداده زیر دارند:
-
android.sensor.blackLevelPattern -
android.sensor.dynamicBlackLevel -
android.statistics.lensShadingMap -
android.tonemap.curve
android.sensor.noiseProfile فقط یک کانال رنگی دارد.
برای دستگاه‌های تک رنگ که از فرمت‌های جریان Y8 پشتیبانی می‌کنند، دوربین HAL باید از جابجایی قالب‌های YUV_420_888 در ترکیب‌های جریانی اجباری (از جمله پردازش مجدد) با قالب‌های Y8 پشتیبانی کند.
API های عمومی زیر در این ویژگی استفاده می شوند:
برای جزئیات بیشتر در مورد دوربین HAL، به docs.html مراجعه کنید. برای اطلاعات بیشتر در مورد APIهای عمومی مرتبط، به ImageFormat ، CameraCharacteristics ، CaptureRequest و CaptureResult مراجعه کنید.
اعتبار سنجی
برای تأیید اجرای دوربین تک رنگ، آزمایش‌های CTS و VTS زیر را اجرا کنید.
تست های CTS
-
testMonochromeCharacteristics -
CaptureRequestTest -
CaptureResultTest -
StillCaptureTest -
DngCreatorTest
تست های VTS
-
getCameraCharacteristics -
processMultiCaptureRequestPreview
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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`"]]
