harmony 鸿蒙Camera

2022-08-09
浏览 (1266)

Camera

概述

Camera模块接口定义。

Camera模块涉及相机设备的操作、流的操作、离线流的操作和各种回调等。

Since:

3.2

Version:

1.0

汇总

文件

名称	描述
ICameraDevice.idl	Camera设备操作接口。
ICameraDeviceCallback.idl	Camera设备的回调接口，主要包含Camera设备发生错误时和上报metadata的回调函数。
ICameraHost.idl	Camera服务的管理类，对上层提供HDI接口。
ICameraHostCallback.idl	ICameraHost的回调接口，提供Camera设备和闪关灯状态变化的回调函数，回调函数由调用者实现。
IOfflineStreamOperator.idl	离线流的操作接口。
IStreamOperator.idl	流的操作接口。
IStreamOperatorCallback.idl	IStreamOperator相关的回调，这些回调均由调用者实现。
Types.idl	Camera模块HDI接口使用的数据类型。

类

名称	描述
ICameraDevice	interface 定义Camera设备基本的操作。
ICameraDeviceCallback	interface 定义Camera设备回调操作。
ICameraHost	interface 定义Camera设备功能操作。
ICameraHostCallback	interface 定义Camera设备功能回调操作。
IOfflineStreamOperator	interface 定义Camera设备离线流操作。
IStreamOperator	interface 定义Camera设备流操作。
IStreamOperatorCallback	interface 定义Camera设备流回调操作。
StreamInfo	struct 流信息，用于创建流时传入相关的配置参数。
StreamAttribute	struct 流的属性。
CaptureInfo	struct 捕获请求的相关信息。
CaptureEndedInfo	struct 捕获结束相关信息，用于捕获结束回调OnCaptureEnded。
CaptureErrorInfo	struct 流错误信息，用于回调OnCaptureError。

枚举

名称	描述
CamRetCode {   NO_ERROR = 0, CAMERA_BUSY = -1, INSUFFICIENT_RESOURCES = -2, INVALID_ARGUMENT = -3,   METHOD_NOT_SUPPORTED = -4, CAMERA_CLOSED = -5, DEVICE_ERROR = -6, NO_PERMISSION = -7 }	HDI接口的返回值。
ResultCallbackMode { PER_FRAME = 0, ON_CHANGED = 1 }	metadata的上报模式。
OperationMode { NORMAL = 0 }	流的使用模式。
StreamIntent { PREVIEW = 0, VIDEO = 1, STILL_CAPTURE = 2, POST_VIEW = 3,   ANALYZE = 4, CUSTOM = 5 }	流的类型。
EncodeType { ENCODE_TYPE_NULL = 0, ENCODE_TYPE_H264 = 1, ENCODE_TYPE_H265 = 2, ENCODE_TYPE_JPEG = 3 }	流数据的编码类型。
StreamSupportType { DYNAMIC_SUPPORTED = 0, RE_CONFIGURED_REQUIRED = 1, NOT_SUPPORTED = 2 }	对动态配置流的支持类型，使用场景参考IsStreamsSupported。
CameraStatus { UN_AVAILABLE = 0, AVAILABLE = 1 }	Camera设备状态。
FlashlightStatus { FLASHLIGHT_OFF = 0, FLASHLIGHT_ON = 1, FLASHLIGHT_UNAVAILABLE = 2 }	闪光灯状态。
CameraEvent { CAMERA_EVENT_DEVICE_ADD = 0, CAMERA_EVENT_DEVICE_RMV = 1 }	Camera事件。
ErrorType {   FATAL_ERROR = 0, REQUEST_TIMEOUT = 1, DRIVER_ERROR = 2, DEVICE_PREEMPT = 3,   DEVICE_DISCONNECT = 4, DCAMERA_ERROR_BEGIN = 1024, DCAMERA_ERROR_DEVICE_IN_USE, DCAMERA_ERROR_NO_PERMISSION }	设备错误类型，用于设备错误回调OnError。
StreamError { UNKNOWN_ERROR = 0, BUFFER_LOST = 1 }	流错误类型，用于流错误类型CaptureErrorInfo。

关键字

名称	描述
package ohos.hdi.camera.v1_0	Camera设备接口的包路径。
sequenceable ohos.hdi.camera.v1_0.BufferProducerSequenceable	ohos.hdi.camera.v1_0序列，可用缓冲区生成器。

枚举类型说明

CameraEvent

enum CameraEvent

描述:

Camera事件。

枚举值	描述
CAMERA_EVENT_DEVICE_ADD	Camera设备增加事件。
CAMERA_EVENT_DEVICE_RMV	Camera设备删除事件。

CameraStatus

enum CameraStatus

描述:

Camera设备状态。

枚举值	描述
UN_AVAILABLE	设备当前不在位或者不可用。
AVAILABLE	设备当前可用。

CamRetCode

enum CamRetCode

描述:

HDI接口的返回值。

枚举值	描述
NO_ERROR	调用成功。
CAMERA_BUSY	设备当前忙。
INSUFFICIENT_RESOURCES	资源不足。
INVALID_ARGUMENT	参数错误。
METHOD_NOT_SUPPORTED	不支持当前调用方法。
CAMERA_CLOSED	Camera设备已经关闭。
DEVICE_ERROR	驱动层发生严重错误。
NO_PERMISSION	无权限访问设备。

EncodeType

enum EncodeType

描述:

流数据的编码类型。

枚举值	描述
ENCODE_TYPE_NULL	未设置编码类型
ENCODE_TYPE_H264	编码类型为H264。
ENCODE_TYPE_H265	编码类型为H265。
ENCODE_TYPE_JPEG	编码类型为JPEG。

ErrorType

enum ErrorType

描述:

设备错误类型，用于设备错误回调OnError。

枚举值	描述
FATAL_ERROR	严重错误，需要关闭Camera设备。
REQUEST_TIMEOUT	请求超时，需要关闭Camera设备。
DRIVER_ERROR	驱动程序中发生错误。
DEVICE_PREEMPT	设备被抢占。
DEVICE_DISCONNECT	设备已断开连接。
DCAMERA_ERROR_BEGIN	分布式像机错误开始的标识。
DCAMERA_ERROR_DEVICE_IN_USE	分布式像机设备忙。
DCAMERA_ERROR_NO_PERMISSION	没有访问分布式摄像机设备的权限。

FlashlightStatus

enum FlashlightStatus

描述:

闪光灯状态。

枚举值	描述
FLASHLIGHT_OFF	闪光灯关闭。
FLASHLIGHT_ON	闪光灯开启。
FLASHLIGHT_UNAVAILABLE	闪光灯当前不可用。

OperationMode

enum OperationMode

描述:

流的使用模式。

枚举值	描述
NORMAL	普通模式。

ResultCallbackMode

enum ResultCallbackMode

描述:

metadata的上报模式。

枚举值	描述
PER_FRAME	逐帧上报。
ON_CHANGED	设备状态变化时上报。

StreamError

enum StreamError

描述:

流错误类型，用于流错误类型CaptureErrorInfo。

枚举值	描述
UNKNOWN_ERROR	流未知错误。
BUFFER_LOST	丢包。

StreamIntent

enum StreamIntent

描述:

流的类型。

枚举值	描述
PREVIEW	流数据用于显示，即预览流。
VIDEO	流数据用于编码生成录像，即录像流。
STILL_CAPTURE	流数据用于编码生成照片，即拍照流。
POST_VIEW	流数据用于保存缩略图。
ANALYZE	流数据用于图像分析。
CUSTOM	自定义类型。

StreamSupportType

enum StreamSupportType

描述:

对动态配置流的支持类型，使用场景参考IsStreamsSupported。

枚举值	描述
DYNAMIC_SUPPORTED	支持动态配置流，对应的流参数直接生效。
RE_CONFIGURED_REQUIRED	不支持动态配置流，对应的参数需要停止流然后重新配置流才能生效。
NOT_SUPPORTED	不支持对应的流参数配置。