camera_input.h

概述

声明相机输入概念。

引用文件：

库： libohcamera.so

系统能力： SystemCapability.Multimedia.Camera.Core

起始版本： 11

相关模块： OH_Camera

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |CameraInput_Callbacks|CameraInput_Callbacks|相机输入错误事件的回调。| |Camera_Input|Camera_Input|相机输入对象。可以使用OH_CameraManager_CreateCameraInput方法创建指针。|

函数

|名称|typedef关键字|描述| |–|–|–| |typedef void (*OH_CameraInput_OnError)(const Camera_Input* cameraInput, Camera_ErrorCode errorCode)|OH_CameraInput_OnError|在CameraInput_Callbacks中被调用的相机输入错误回调。| |Camera_ErrorCode OH_CameraInput_RegisterCallback(Camera_Input* cameraInput, CameraInput_Callbacks* callback)|-|注册相机输入更改事件回调。| |Camera_ErrorCode OH_CameraInput_UnregisterCallback(Camera_Input* cameraInput, CameraInput_Callbacks* callback)|-|注销相机输入更改事件回调。| |Camera_ErrorCode OH_CameraInput_Open(Camera_Input* cameraInput)|-|打开相机。| |Camera_ErrorCode OH_CameraInput_OpenSecureCamera(Camera_Input* cameraInput, uint64_t* secureSeqId)|-|打开安全相机。| |Camera_ErrorCode OH_CameraInput_OpenConcurrentCameras(Camera_Input* cameraInput, Camera_ConcurrentType type)|-|根据指定并发类型打开相机。| |Camera_ErrorCode OH_CameraInput_Close(Camera_Input* cameraInput)|-|关闭相机。| |Camera_ErrorCode OH_CameraInput_Release(Camera_Input* cameraInput)|-|释放相机输入实例。
和OH_CameraInput_Close只需要调用其中一个，调用之后无须再调用OH_CameraInput_Close。|

函数说明

OH_CameraInput_OnError()

typedef void (*OH_CameraInput_OnError)(const Camera_Input* cameraInput, Camera_ErrorCode errorCode)

描述

在CameraInput_Callbacks中被调用的相机输入错误回调。

起始版本： 11

参数：

|参数项|描述| |–|–| |const Camera_Input* cameraInput|传递回调的Camera_Input。| | Camera_ErrorCode errorCode|相机输入的Camera_ErrorCode。|

参考：

CAMERA_SERVICE_FATAL_ERROR

OH_CameraInput_RegisterCallback()

Camera_ErrorCode OH_CameraInput_RegisterCallback(Camera_Input* cameraInput, CameraInput_Callbacks* callback)

描述

注册相机输入更改事件回调。

起始版本： 11

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|Camera_Input实例。| |CameraInput_Callbacks* callback|要注册的相机输入更改事件回调。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|

OH_CameraInput_UnregisterCallback()

Camera_ErrorCode OH_CameraInput_UnregisterCallback(Camera_Input* cameraInput, CameraInput_Callbacks* callback)

描述

注销相机输入更改事件回调。

起始版本： 11

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|Camera_Input实例。| |CameraInput_Callbacks* callback|要注销的相机输入更改事件回调。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|

OH_CameraInput_Open()

Camera_ErrorCode OH_CameraInput_Open(Camera_Input* cameraInput)

描述

打开相机。

起始版本： 11

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|要打开的Camera_Input实例。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_CONFLICT_CAMERA：因冲突而无法使用相机。
CAMERA_DEVICE_DISABLED：由于安全原因禁用了相机。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|

OH_CameraInput_OpenSecureCamera()

Camera_ErrorCode OH_CameraInput_OpenSecureCamera(Camera_Input* cameraInput, uint64_t* secureSeqId)

描述

打开安全相机。

起始版本： 12

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|要打开的Camera_Input实例。| |uint64_t* secureSeqId|表示安全摄像头的序列值。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_CONFLICT_CAMERA：因冲突而无法使用相机。
CAMERA_DEVICE_DISABLED：由于安全原因禁用了相机。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|

OH_CameraInput_OpenConcurrentCameras()

Camera_ErrorCode OH_CameraInput_OpenConcurrentCameras(Camera_Input* cameraInput, Camera_ConcurrentType type)

描述

根据指定并发类型打开相机。

起始版本： 18

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|要打开的Camera_Input实例。| |Camera_ConcurrentType type|指定并发类型。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK: 方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_CONFLICT_CAMERA：因冲突而无法使用相机。
CAMERA_DEVICE_DISABLED：由于安全原因禁用了相机。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|

OH_CameraInput_Close()

Camera_ErrorCode OH_CameraInput_Close(Camera_Input* cameraInput)

描述

关闭相机。

起始版本： 11

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|要关闭的Camera_Input实例。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|

OH_CameraInput_Release()

Camera_ErrorCode OH_CameraInput_Release(Camera_Input* cameraInput)

描述

释放相机输入实例。
和OH_CameraInput_Close只需要调用其中一个，调用之后无须再调用OH_CameraInput_Close。

起始版本： 11

参数：

|参数项|描述| |–|–| |Camera_Input* cameraInput|要释放的Camera_Input实例。|

返回：

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Camera Kit（相机服务）

harmony 鸿蒙Interface (AutoDeviceSwitch)

harmony 鸿蒙Interface (AutoDeviceSwitchQuery)

harmony 鸿蒙Interface (AutoExposure)

harmony 鸿蒙Interface (AutoExposureQuery)

harmony 鸿蒙Interface (CameraInput)

harmony 鸿蒙Interface (CameraManager)

harmony 鸿蒙Interface (CameraOutput)

harmony 鸿蒙废弃的Interface (CaptureSession, deprecated)

harmony 鸿蒙Interface (ColorManagement)