ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release
แทน aosp-main
เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP
กล้องโมโนโครม
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
อุปกรณ์ที่ใช้ Android 9 ขึ้นไปจะรองรับกล้องโมโนโครม Android 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
เป็น 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.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
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา 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`"]]