اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
الكاميرات الأحادية اللون
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن للأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android أو إصدار أحدث استخدام
الكاميرات الأحادية اللون. يقدّم نظام التشغيل Android 10
دعمًا إضافيًا لتنسيق البث Y8، ومجموعة فلاتر الألوان أحادية اللون
والأشعة تحت الحمراء القريبة (NIR)، وDngCreator وظائف الكاميرات أحادية اللون.
باستخدام هذه الميزة، يمكن لصنّاع الأجهزة استخدام كاميرا أحادية اللون أو
كاميرا الأشعة تحت الحمراء وتقليل استخدام الذاكرة باستخدام
تنسيق البث 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، يجب أن يتيح Camera HAL مبادلة تنسيقات YUV_420_888 في مجموعات البث الإلزامية (بما في ذلك
إعادة المعالجة) مع تنسيقات Y8.
يتم استخدام واجهات برمجة التطبيقات العامة التالية في هذه الميزة:
لمزيد من التفاصيل حول Camera HAL، يُرجى الاطّلاع على
docs.html.
لمزيد من المعلومات عن واجهات برمجة التطبيقات العامة ذات الصلة، يُرجى الاطّلاع على ImageFormat وCameraCharacteristics وCaptureRequest وCaptureResult.
التحقُّق
للتحقّق من صحة عملية تنفيذ الكاميرا الأحادية اللون، عليك إجراء اختبارَي CTS
وVTS التاليَين.
اختبارات CTS
testMonochromeCharacteristicsCaptureRequestTestCaptureResultTestStillCaptureTestDngCreatorTest
اختبارات VTS
getCameraCharacteristicsprocessMultiCaptureRequestPreview
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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`"]]
