相机散景是一种通过模糊场景的部分区域以使其失焦而产生的浅景深效果。 在移动设备上的相机上,散景是通过使用从两个摄像头或单个摄像头的双光电二极管 (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_CAPTURE和ANDROID_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 验证程序测试
CtsCameraTestCasesVtsHalCameraProviderV2_4TargetTestCameraBokehTestin CTS Verifier