廣色域擷取

對於搭載 Android 14 以上版本的裝置，Android 支援擷取 Display P3 廣色域。裝置可以使用 ImageReader 類別，以 JPEG 格式拍攝廣色域圖片，而不需使用 10 位元 HDR。這項功能可讓裝置透過 SessionConfiguration 中的 setColorSpace 參數，在廣色域色彩空間中向 Camera2 架構要求擷取相機畫面。

需求條件

如要支援廣色域擷取功能，裝置必須能存取具備廣色域色彩功能的相機。

實作

如要支援 Display P3 廣色域擷取要求，請執行下列操作：

• 讀取 colorSpace 欄位中的 Stream.aidl，並套用至輸出串流。
• 實作 android.request.availableColorSpaceProfilesMap 中繼資料項目。
• 在 android.request.availableCapabilities 中回報 COLOR_SPACE_PROFILES 功能。

如要參考支援 P3 廣色域擷取的 Camera HAL 實作，請參閱 /hardware/google/camera/devices/EmulatedCamera/hwl/ configs/emu_camera_back.json 中的下列項目：

• android.request.availableCapabilities
• android.request.availableColorSpaceProfilesMap

如要進一步瞭解 Camera HAL 中的廣色域擷取功能，請參閱 metadata_definitions.xml 中的下列值：

• availableColorSpaceProfiles
• availableColorSpaceProfilesMap
• COLOR_SPACE_PROFILES

API

如果裝置搭載 Android 14 以上版本，且支援廣色域擷取功能，相機用戶端可以使用下列公開 API：

• ColorSpaceProfiles
• setColorSpace

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

執行攝影機影像測試套件 (ITS) 測試，驗證下列項目：

• 具有正確色度座標的 ICC 色彩描述檔
• 圖片包含 sRGB 色域以外的像素資料