27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main
yerine android-latest-release
kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Tek renkli kameralar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Android 9 veya sonraki sürümleri çalıştıran cihazlar tek renkli kameraları destekleyebilir. Android 10, Y8 akış biçimi, tek renkli ve yakın kızılötesi (NIR) renk filtresi dizisi statik meta verileri ve tek renkli kameralar için DngCreator
işlevleri için ek destek sağlar.
Bu özellik sayesinde cihaz üreticileri tek renkli veya kızılötesi kamera cihazı uygulayabilir ve Y8 akış biçimini kullanarak bellek kullanımını azaltabilir. Tek renkli kamera, düşük ışıkta daha iyi gürültü özellikleri elde etmek için mantıksal çoklu kameralı cihazın temel fiziksel kamerası olarak kullanılabilir.
Uygulama
Donanım gereksinimleri
Bu özelliğin uygulanabilmesi için cihazınızda tek renkli kamera sensörü ve sensör çıkışını işleyen bir görüntü sinyali işlemcisi (ISP) olmalıdır.
Tek renkli kamera kullanma
Bir kamera cihazının tek renkli kamera olarak tanıtılması için Kamera HAL'in aşağıdaki koşulları karşılaması gerekir:
android.sensor.info.colorFilterArray
MONO
veya NIR
olarak ayarlandı.
BACKWARD_COMPATIBLE
zorunlu anahtarları desteklenir ve MANUAL_POST_PROCESSING
desteklenmez.
android.control.awbAvailableModes
yalnızca AUTO
içerir ve android.control.awbState
, android.control.awbLock
'e bağlı olarak CONVERTED
veya LOCKED
olur.
android.colorCorrection.mode
, android.colorCorrection.transform
ve android.colorCorrection.gains
, mevcut istek ve sonuç anahtarlarında yer almıyor. Sonuç olarak kamera cihazı LIMITED
.
Renkle ilgili aşağıdaki statik meta veri anahtarları mevcut değildir:
android.sensor.referenceIlluminant*
android.sensor.calibrationTransform*
android.sensor.colorTransform*
android.sensor.forwardMatrix*
android.sensor.neutralColorPoint
android.sensor.greenSplit
Tüm renk kanalları, aşağıdaki meta veri anahtarları için aynı değerlere sahiptir:
android.sensor.blackLevelPattern
android.sensor.dynamicBlackLevel
android.statistics.lensShadingMap
android.tonemap.curve
android.sensor.noiseProfile
yalnızca bir renk kanalı içerir.
Y8 yayın biçimlerini destekleyen tek renkli cihazlarda Kamera HAL, zorunlu yayın kombinasyonlarındaki YUV_420_888
biçimlerini Y8 biçimleriyle değiştirmeyi (yeniden işleme dahil) desteklemelidir.
Bu özellikte aşağıdaki herkese açık API'ler kullanılır:
Kamera HAL'i hakkında daha fazla bilgi için docs.html dosyasını inceleyin.
İlgili herkese açık API'ler hakkında daha fazla bilgi için ImageFormat, CameraCharacteristics, CaptureRequest ve CaptureResult konularını inceleyin.
Doğrulama
Tek renkli kamera uygulamanızı doğrulamak için aşağıdaki CTS ve VTS testlerini çalıştırın.
CTS testleri
testMonochromeCharacteristics
CaptureRequestTest
CaptureResultTest
StillCaptureTest
DngCreatorTest
VTS testleri
getCameraCharacteristics
processMultiCaptureRequestPreview
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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`"]]