廣角拍攝

對於搭載 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 中的以下內容：

• 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 色調以外的像素資料