Most visited

Recently visited

Results for

Added in API level 21
Summary: Methods | Inherited Methods | [Expand All]

CaptureRequest.Builder

public static final class CaptureRequest.Builder
extends Object

java.lang.Object
   ↳ android.hardware.camera2.CaptureRequest.Builder

捕获请求的构建器。

要获取构建器实例，请使用 createCaptureRequest(int)方法，该方法将请求字段初始化为 CameraDevice定义的模板之一。

也可以看看：

Summary

Public methods
void addTarget(Surface outputTarget)

将表面添加到此请求的目标列表中

当请求被提供给相机设备时，添加的曲面必须是包含在最近 createCaptureSession(List , CameraCaptureSession.StateCallback, Handler) 调用中的曲面之一。
CaptureRequest build()

使用当前目标曲面和设置构建请求。
<T> T get(Key<T> key)

获取捕获请求字段值。
void removeTarget(Surface outputTarget)

从此请求的目标列表中移除曲面。
<T> void set(Key<T> key, T value)

将捕获请求字段设置为一个值。
void setTag(Object tag)

为此请求设置标签。

Inherited methods
From class java.lang.Object

Public methods

addTarget

Added in API level 21 
void addTarget (Surface outputTarget)

将表面添加到此请求的目标列表中

当向摄像机设备发出请求时，添加的曲面必须是包含在最近 createCaptureSession(List , CameraCaptureSession.StateCallback, Handler) 调用中的曲面之一。

不止一次添加目标无效。

Parameters
outputTarget Surface: Surface to use as an output target for this request

build

Added in API level 21 
CaptureRequest build ()

使用当前目标曲面和设置构建请求。

需要注意的是，尽管可以创建一个 CaptureRequest没有目标 Surface S，通过这样的请求到 capture(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler) ， captureBurst(List , CameraCaptureSession.CaptureCallback, Handler) ， setRepeatingBurst(List , CameraCaptureSession.CaptureCallback, Handler) ，或 setRepeatingRequest(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler)将使该方法抛出 IllegalArgumentException 。

Returns
CaptureRequest A new capture request instance, ready for submission to the camera device.

get

Added in API level 21 
T get (Key<T> key)

获取捕获请求字段值。 字段定义可以在CaptureRequest找到。

Parameters
key Key: The metadata field to read.
Returns
T The value of that key, or null if the field is not set.
Throws
IllegalArgumentException if the key was not valid

removeTarget

Added in API level 21 
void removeTarget (Surface outputTarget)

从此请求的目标列表中移除曲面。

删除当前未添加的目标无效。

Parameters
outputTarget Surface: Surface to use as an output target for this request

set

Added in API level 21 
void set (Key<T> key, 
                T value)

将捕获请求字段设置为一个值。 字段定义可以在CaptureRequest找到。

将字段设置为null将从捕获请求中删除该字段。 除非该字段是可选的，否则在提交请求时将其删除可能会导致相机设备发生错误。

Parameters
key Key: The metadata field to write.
value T: The value to set the field to, which must be of a matching type to the key.

setTag

Added in API level 21 
void setTag (Object tag)

为此请求设置标签。

该标签不用于相机设备的任何内容，但可由应用程序使用，以便在由 CaptureCallback.onCaptureCompleted返回的情况下轻松识别 CaptureCallback.onCaptureCompleted

Parameters
tag Object: an arbitrary Object to store with this request

也可以看看：

Android开发手册

Hooray!