對於運行 Android 14 或更高版本的設備,Android 提供對 Display P3 廣色域捕獲的支援。設備可以使用ImageReader
類別擷取 JPEG 格式的廣色域彩色影像,而無需使用10 位元 HDR 。此功能可讓裝置透過SessionConfiguration
中的setColorSpace
參數向 Camera2 框架請求寬色域色彩空間中的相機擷取。
要求
為了支援廣色域捕捉,設備必須能夠使用具有廣色域色彩功能的相機。
執行
若要支援 Display P3 廣色域擷取請求,請執行下列操作:
- 讀取
Stream.aidl
中的colorSpace
欄位並將其套用到輸出流。 - 實作
android.request.availableColorSpaceProfilesMap
元資料條目。 - 在
android.request.availableCapabilities
中報告COLOR_SPACE_PROFILES
功能。
有關支援 P3 廣色域捕獲的參考相機 HAL 實現,請參閱/hardware/google/camera/devices/EmulatedCamera/hwl/ configs/emu_camera_back.json
中的以下內容:
有關相機 HAL 中廣色域捕獲的更多詳細信息,請參閱metadata_definitions.xml
中的以下值:
蜜蜂
對於運行 Android 14 或更高版本且支援廣色域捕捉的設備,相機用戶端可以使用以下公共 API:
ColorSpace
參數的預期值派生自ColorSpace.Named
類別。在 Android 14 中,支援SRGB
、 DISPLAY_P3
和BT2020_HLG
。
驗證
若要驗證 Display P3 廣色域擷取支援的實現,請執行以下測試。
CTS
-
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test8BitColorSpaceOutputCharacteristics
-
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#test10BitColorSpaceOutputCharacteristics
-
android.hardware.camera2.cts.ExtendedCameraCharacteristicsTest#testColorSpaceProfileMap
-
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Jpeg
-
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3JpegRepeating
-
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3Heic
-
android.hardware.camera2.cts.ImageReaderTest#testDisplayP3HeicRepeating
它是
執行相機影像測試套件 (ITS)測試來驗證以下內容:
- 存在具有正確色度座標的 ICC 配置文件
- 影像包含 sRGB 色域之外的像素數據