public static final class CaptureRequest.Builder
extends Object
| java.lang.Object | |
| android.hardware.camera2.CaptureRequest.Builder | |
捕获请求的构建器。
要获取构建器实例,请使用 createCaptureRequest(int)方法,该方法将请求字段初始化为 CameraDevice定义的模板之一。
也可以看看:
公共方法(Public methods) |
|
|---|---|
void |
addTarget(Surface outputTarget) 将表面添加到此请求的目标列表中 当请求被提供给相机设备时,添加的曲面必须是包含在最近 |
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) |
|
|---|---|
java.lang.Object
|
|
void addTarget (Surface outputTarget)
将表面添加到此请求的目标列表中
当向摄像机设备发出请求时,添加的曲面必须是包含在最近 createCaptureSession(List
调用中的曲面之一。
不止一次添加目标无效。
| 参数(Parameters) | |
|---|---|
outputTarget |
Surface: Surface to use as an output target for this request |
CaptureRequest build ()
使用当前目标曲面和设置构建请求。
需要注意的是,尽管可以创建一个 CaptureRequest没有目标 Surface S,通过这样的请求到 capture(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler) , captureBurst(List
, setRepeatingBurst(List
,或 setRepeatingRequest(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler)将使该方法抛出 IllegalArgumentException 。
| 返回(Returns) | |
|---|---|
CaptureRequest |
A new capture request instance, ready for submission to the camera device. |
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 |
void removeTarget (Surface outputTarget)
从此请求的目标列表中移除曲面。
删除当前未添加的目标无效。
| 参数(Parameters) | |
|---|---|
outputTarget |
Surface: Surface to use as an output target for this request |
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. |
void setTag (Object tag)
为此请求设置标签。
该标签不用于相机设备的任何内容,但可由应用程序使用,以便在由 CaptureCallback.onCaptureCompleted返回的情况下轻松识别 CaptureCallback.onCaptureCompleted
| 参数(Parameters) | |
|---|---|
tag |
Object: an arbitrary Object to store with this request |
也可以看看: