语言

CaptureRequest.ControlSettingsOverride 属性

定义

所需的 CaptureRequest 设置会替代之前应用某些密钥,以便可以更快地生效。

[Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)]
public static Android.Hardware.Camera2.CaptureRequest.Key ControlSettingsOverride { get; }
[<Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)>]
static member ControlSettingsOverride : Android.Hardware.Camera2.CaptureRequest.Key

属性值

所需的 CaptureRequest 设置会替代之前应用某些密钥,以便可以更快地生效。

特性

注解

所需的 CaptureRequest 设置会替代之前应用某些密钥,以便可以更快地生效。

如果 CaptureRequest 中的控件不需要同时生效,则可以早于其他项应用一些 CaptureRequest 键。 其中一个示例是缩放。 缩放可在相机管道的后续阶段应用。 相机设备收到 CaptureRequest 后,就可以将请求的缩放值应用于管道中已有的早期请求,从而提高缩放延迟。

此键在捕获结果中的值反映了此捕获的控件是否被新请求“by”重写。 这意味着,如果捕获请求启用设置替代,则早期请求的捕获结果将包含 ZOOM 的键值。 另一方面,如果捕获请求已启用设置替代,但所有较新的请求都将其关闭,则捕获结果中的键值将关闭,因为较新的捕获不会重写此捕获。 在下面的两个示例中,捕获结果列演示了不同方案中的设置Override 值。

Camera session created
Request 1 (zoom=1.0x, override=ZOOM) ->
Request 2 (zoom=1.2x, override=ZOOM) ->
Request 3 (zoom=1.4x, override=ZOOM) ->  Result 1 (zoom=1.2x, override=ZOOM)
Request 4 (zoom=1.6x, override=ZOOM) ->  Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=ZOOM) ->  Result 3 (zoom=1.6x, override=ZOOM)
                                     ->  Result 4 (zoom=1.8x, override=ZOOM)
                                     ->  Result 5 (zoom=1.8x, override=OFF)

应用程序可以打开设置替代,并像平时一样使用缩放。 该示例显示后续缩放值(1.2x、1.4x、1.6x 和 1.8x)覆盖早期请求(#1、#2、#3 和 #4)的缩放值(1.0x、1.2x、1.4x 和 1.8x)。

应用程序必须确保设置替代不会干扰需要同时在 CaptureRequest 中对请求的输出目标应用所有控件的用户旅程。 例如,如果应用程序使用 CameraCaptureSession#capture 获取仍捕获,并且重复请求会立即使用替代设置不同的缩放值,则飞行中仍捕获的缩放值可能会意外覆盖其缩放值。

因此,强烈建议应用程序在拍摄静止/突发捕获时关闭 settingsOverride,并在只有重复的取景器请求时将其重新打开,并且没有未执行仍然/突发捕获。

Request 1 (zoom=1.0x, override=OFF)
Request 2 (zoom=1.2x, override=OFF)
Request 3 (zoom=1.4x, override=ZOOM)  -> Result 1 (zoom=1.0x, override=OFF)
Request 4 (zoom=1.6x, override=ZOOM)  -> Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=OFF)   -> Result 3 (zoom=1.6x, override=ZOOM)
                                      -> Result 4 (zoom=1.6x, override=OFF)
                                      -> Result 5 (zoom=1.8x, override=OFF)

此示例显示:通过将控件设置为 ZOOM 来替代应用程序“渐变”设置。 在此示例中,请求 #3 启用缩放设置替代。 由于相机设备可以加快应用缩放 1 帧的速度,因此请求 #2 的输出具有 1.4 倍的缩放,请求 #3 中指定的值;通过将控件设置为 OFF 来替代设置的应用程序“横向扩展”。 在此示例中,请求 #5 将重写更改为 OFF。 由于请求 #4 的缩放在结果 #3 中生效,因此结果 #4 的缩放保持不变,直到新值在结果 #5 中生效

可能的值:OFF;ZOOM

此设备的可用值:android.control.availableSettingsOverrides

可选 - 此密钥的值在某些设备上可能为 null。

Android 参考。android.hardware.camera2.CaptureRequest.CONTROL_SETTINGS_OVERRIDE

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于