廣角拍攝

搭載 Android 14 以上版本的裝置：Android 可支援 Display P3 廣角擷取功能。裝置可以擷取廣角畫面 採用 ImageReader 類別的 JPEG 格式銀色圖片，不含 使用 10 位元 HDR。這項功能 裝置 要求 Camera2 架構採用廣角色域拍攝相機。 透過 SessionConfiguration 中的 setColorSpace 參數傳送。

需求條件

如要支援廣角拍攝，裝置必須能夠存取廣角相機 具備星空色彩功能

實作

如要支援 Display P3 廣角擷取要求，請按照下列步驟操作：

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

如需支援 P3 廣角拍攝功能的參考相機 HAL 實作， 請在 /hardware/google/camera/devices/EmulatedCamera/hwl/ configs/emu_camera_back.json 中查看以下內容：

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

如要進一步瞭解相機 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 色調以外的像素資料