会话参数

在捕获会话初始化阶段,会话参数功能使相机客户端可以主动配置一部分成本高昂的请求参数(即会话参数),从而减少延迟。借助此功能,您的 HAL 实现会在流配置阶段(而不是第一个捕获请求期间)接收客户端参数,并且可以根据它们的值更高效地准备和构建内部流水线。

示例和来源

参考会话参数实现已经是 CameraHal 的一部分。此 HAL 使用旧版 Hal API。实现 Camera HIDL API 的绑定式 CameraHal 必须使用相应的 HIDL sessionParams 条目在流配置期间访问所有新的传入会话参数。

相机客户端可以通过调用 getAvaiableSessionKeys() 来查询所有受支持的会话参数的键,并最终通过 setSessionParameters() 设置它们的初始值。

实现

您的 CameraHal 实现必须在相应的静态相机元数据中填充 ANDROID_REQUEST_AVAILABLE_SESSION_KEYS,并提供一部分 ANDROID_REQUEST_AVAILABLE_REQUEST_KEYS(其中包含难以按帧应用的键的列表,如果在捕获会话生命周期内修改这些键,则可能会导致意外延迟)。

典型示例包括:需要耗费时间重新配置硬件或更改内部相机流水线的参数。控制会话参数仍然可以在捕获请求中发挥作用,不过,客户端应意识到并预料到其应用会出现延迟。

框架会监控所有传入请求,如果它检测到会话参数值发生变化,则会在内部重新配置相机。然后,已传递到 CameraHal 的新流配置中会包含更新后的会话参数值(用于更高效地配置相机流水线)。

自定义

您可以在 CameraHal 端填充的可用会话参数列表中定义标记。如果 CameraHal 将可用会话参数列表留空,则此功能无效。

验证

CTS 提供以下用于测试会话参数的新用例:

通常,一旦某个参数成为会话键列表的一部分,其当前值就会添加到在流配置期间在 HAL 层传递的会话参数中。

选择会话参数时请务必谨慎。不应频繁更改流配置之间的会话参数值(如果有的话)。如果参数频繁更改(例如出于捕获目的),其适用性会非常低;如果将此类参数添加到会话参数列表中,则可能会因内部重新配置过多而导致 CTS 问题。