程序包 ohos.media.camera.device

接口 CameraConfig.Builder

封闭接口:

CameraConfig

public static interface CameraConfig.Builder

Used to create a CameraConfig instance.

从以下版本开始:

1

方法概要

限定符和类型	方法	说明
CameraConfig.Builder	addDeferredSurface(Surface surface)	Adds the deferred surface.
<T> CameraConfig.Builder	addDeferredSurfaceSize(Size surfaceSize, Class<T> clazz)	Adds the size and class type of the deferred surface to the camera configuration.
CameraConfig.Builder	addSurface(Surface surface)	Adds a surface as an output for a camera stream.
CameraConfig	build()	Builds a secure CameraConfig object.
List<Surface>	getSurfaces()	Gets all surfaces set for the camera stream in CameraConfig.Builder.
CameraConfig.Builder	removeSurface(Surface surface)	Removes a surface for a camera stream.
CameraConfig.Builder	setFrameStateCallback(FrameStateCallback callback, EventHandler handler)	Sets a callback and handler for frame capture results.
CameraConfig.Builder	setRunningMode(int runningMode)	Sets a running mode for the camera.

方法详细资料

addSurface

CameraConfig.Builder addSurface(Surface surface)

Adds a surface as an output for a camera stream.

参数:

surface - Indicates a surface of streams for preview, taking pictures, and video recording. The surface cannot be null. Repeatedly adding the same surface is invalid.

返回:

Returns a Builder object.

抛出:

NullPointerException - Throws this exception if surface is null.

从以下版本开始:

1

removeSurface

CameraConfig.Builder removeSurface(Surface surface)

Removes a surface for a camera stream.

参数:

surface - Indicates a surface of streams for preview, taking pictures, and video recording. The surface cannot be null.

返回:

Returns a Builder object.

抛出:

NullPointerException - Throws this exception if surface is null.

从以下版本开始:

1

getSurfaces

List<Surface> getSurfaces()

Gets all surfaces set for the camera stream in CameraConfig.Builder.

返回:

Returns all configured surfaces if any; returns a list with the length of 0 otherwise.

从以下版本开始:

5

另请参阅:

addSurface(Surface)

addDeferredSurfaceSize

<T> CameraConfig.Builder addDeferredSurfaceSize(Size surfaceSize,
                                                Class<T> clazz)

Adds the size and class type of the deferred surface to the camera configuration.

Set the size and class type of the deferred surface when configuring the camera for the first time. After the surface is ready, add it to the camera configuration by calling CameraConfig.Builder#addDeferredSurface. This reduces camera startup latency caused by UI loading for complex applications, improving application startup performance.

Only one surface can be used as the deferred surface, which is usually used for preview.

After calling this method, you must call CameraConfig.Builder#addDeferredSurface to add the surface before requesting frame capture of this surface.

类型参数:

T - Indicates the class type.

参数:

surfaceSize - Indicates the size to set.

clazz - Indicates the surface class.

返回:

Returns the Builder object.

抛出:

NullPointerException - Throws this exception if surfaceSize or clazz is null.

IllegalArgumentException - Throws this exception if surfaceSize is invalid.

IllegalStateException - Throws this exception if this method is called after the CameraConfig.Builder#addDeferredSurface method.

从以下版本开始:

3

addDeferredSurface

CameraConfig.Builder addDeferredSurface(Surface surface)

Adds the deferred surface.

This method must be called after CameraConfig.Builder#addDeferredSurfaceSize. Otherwise, an exception will be thrown for illegal status. Only one surface can be used as the deferred surface.

After CameraConfig.Builder#build is called, the deferred surface becomes a common surface. To remove the surface, you can call the CameraConfig.Builder#removeSurface method.

参数:

surface - Indicates the deferred surface to add.

返回:

Returns the Builder object.

抛出:

NullPointerException - Throws this exception if surface is null.

IllegalArgumentException - Throws this exception if the passed surface has been added as the common surface by CameraConfig.Builder#addSurface, or if the size of surface is different from that added by CameraConfig.Builder#addDeferredSurface.

IllegalStateException - Throws this exception if CameraConfig.Builder#addDeferredSurfaceSize was not called before addDeferredSurface(Surface) is called.

从以下版本开始:

3

setFrameStateCallback

CameraConfig.Builder setFrameStateCallback(FrameStateCallback callback,
                                           EventHandler handler)

Sets a callback and handler for frame capture results.

参数:

callback - Indicates the callback for the frame capture results. If the callback is null, the previous setting will be cleared.

handler - Indicates a handler of the callback. The handler must not be null, and the callback will be invoked in the handler.

The handler must be valid throughout the lifecycle of the camera. If the handler is released before it should be, an exception may be thrown.

返回:

Returns a Builder object.

抛出:

NullPointerException - Throws this exception if callback is not null but handler is null.

从以下版本开始:

1

setRunningMode

CameraConfig.Builder setRunningMode(int runningMode)

Sets a running mode for the camera.

You should obtain the supported running modes before setting any mode via CameraConfig.Builder#setRunningMode(int).

参数:

runningMode - Indicates the running mode to set.

返回:

Returns the Builder object.

从以下版本开始:

3

另请参阅:

CameraAbility.CameraRunningMode

build

CameraConfig build()

Builds a secure CameraConfig object. Call Camera#configure(CameraConfig) to complete the camera configuration.

返回:

Returns a CameraConfig object.

从以下版本开始:

1