相機散景

相機散景效果會模糊處理部分場景,營造出淺景深效果,讓這些部分不在焦點內。在行動裝置的相機上,散景效果是透過立體視覺從兩個相機或單一相機的雙光二極體 (PD) 取得的深度資訊達成。

自 Android 11 起,Android 平台支援散景實作,並提供 API,讓第三方應用程式也能使用這項功能。

導入作業

如要在裝置上使用攝影機散景功能,請按照下列步驟操作:

  • 廣告 ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES

    這個標記的格式為三整數元組陣列,每個元組的格式為 {mode, maxWidth, maxHeight}。除了 {ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0} 之外,相機 HAL 也必須列出 ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTUREANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS 模式中的一或兩種,以及對應的最大串流大小。

  • 廣告 ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES

    這個標記的格式為 {minZoomRatio, maxZoomRatio} 陣列,其中包含已啟用擴展場景模式的所有變焦比例範圍,順序與 ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES 相同。如果縮放範圍為 [1.0, 1.0],表示不支援縮放功能。

  • ANDROID_CONTROL_AVAILABLE_MODES 中填入 ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE

如要讓應用程式觸發散景功能,應用程式必須將 ANDROID_CONTROL_MODE 設為 ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE,並將 ANDROID_CONTROL_EXTENDED_SCENE_MODE 設為支援的擴充場景模式。請注意,由於立體運算,實作散景效果可能會導致額外的記憶體消耗。

如果無法對每個影格套用支援的擴充場景模式,且啟用/停用時發生非預期的延遲,請在 ANDROID_REQUEST_AVAILABLE_SESSION_KEYS 中加入 ANDROID_CONTROL_EXTENDED_SCENE_MODE。同時實作 ICameraDeviceSession::isReconfigurationRequired() 方法,避免為不需要重新設定的擴充場景模式重新設定。

驗證

如要在裝置上驗證散景功能,請執行下列 CTS、VTS 和 CTS 驗證器測試:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CTS 驗證器中的 CameraBokehTest