harmony 鸿蒙Camera

2022-10-28
浏览 (968)

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	定义Camera设备基本的操作。
ICameraDeviceCallback	定义Camera设备回调操作。
ICameraHost	定义Camera设备功能操作。
ICameraHostCallback	定义Camera设备功能回调操作。
IOfflineStreamOperator	定义Camera设备离线流操作。
IStreamOperator	定义Camera设备流操作。
IStreamOperatorCallback	定义Camera设备流回调操作。
StreamInfo	流信息，用于创建流时传入相关的配置参数。
StreamAttribute	流的属性。
CaptureInfo	捕获请求的相关信息。
CaptureEndedInfo	捕获结束相关信息，用于捕获结束回调OnCaptureEnded。
CaptureErrorInfo	流错误信息，用于回调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	不支持对应的流参数配置。