OH_Camera

概述

为相机模块提供C接口的定义。

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

起始版本: 11

汇总

文件

名称 描述
camera.h 声明相机的基本概念。
库: libohcamera.so
引用文件:<ohcamera/camera.h>
camera_input.h 声明相机输入概念。
库: libohcamera.so
引用文件:<ohcamera/camera_input.h>
camera_manager.h 声明相机管理器的概念。
库: libohcamera.so
引用文件:<ohcamera/camera_manager.h>
capture_session.h 声明捕获会话概念。
库: libohcamera.so
引用文件:<ohcamera/capture_session.h>
metadata_output.h 声明元数据输出概念。
库: libohcamera.so
引用文件:<ohcamera/metadata_output.h>
photo_output.h 声明拍照输出概念。
库: libohcamera.so
引用文件:<ohcamera/photo_output.h>
preview_output.h 声明预览输出概念。
库: libohcamera.so
引用文件:<ohcamera/preview_output.h>
video_output.h 声明录像输出概念。
库: libohcamera.so
引用文件:<ohcamera/video_output.h>

结构体

名称 描述
struct  Camera_Size 大小参数。
struct  Camera_Profile 相机流的配置文件。
struct  Camera_FrameRateRange 帧速率范围。
struct  Camera_VideoProfile 录像配置文件。
struct  Camera_OutputCapability 相机输出能力。
struct  Camera_Device 相机设备对象。
struct  Camera_StatusInfo 相机状态信息。
struct  Camera_Point 点参数。
struct  Camera_Location 拍照位置。
struct  Camera_PhotoCaptureSetting 要设置的拍照捕获选项。
struct  Camera_FrameShutterInfo 帧快门回调信息。
struct  Camera_CaptureEndInfo 捕获结束信息。
struct  Camera_Rect 矩形定义。
struct  Camera_MetadataObject 元数据对象基础。
struct  CameraInput_Callbacks 相机输入错误事件的回调。
struct  CameraManager_Callbacks 相机设备状态的回调。
struct  CaptureSession_Callbacks 捕获会话的回调。
struct  MetadataOutput_Callbacks 元数据输出的回调。
struct  PhotoOutput_Callbacks 拍照输出的回调。
struct  PreviewOutput_Callbacks 用于预览输出的回调。
struct  VideoOutput_Callbacks 用于录像输出的回调。

类型定义

名称 描述
typedef struct Camera_Manager Camera_Manager 相机管理器对象。
typedef enum Camera_ErrorCode Camera_ErrorCode 相机错误代码的枚举。
typedef enum Camera_Status Camera_Status 相机状态的枚举。
typedef enum Camera_Position Camera_Position 相机位置的枚举。
typedef enum Camera_Type Camera_Type 相机类型的枚举。
typedef enum Camera_Connection Camera_Connection 相机连接类型的枚举。
typedef enum Camera_Format Camera_Format 相机格式类型的枚举。
typedef enum Camera_FlashMode Camera_FlashMode 闪光模式的枚举。
typedef enum Camera_ExposureMode Camera_ExposureMode 曝光模式的枚举。
typedef enum Camera_FocusMode Camera_FocusMode 聚焦模式的枚举。
typedef enum Camera_FocusState Camera_FocusState 焦点状态的枚举。
typedef enum Camera_VideoStabilizationMode Camera_VideoStabilizationMode 录像防抖模式的枚举。
typedef enum Camera_ImageRotation Camera_ImageRotation 图像旋转角度的枚举。
typedef enum Camera_QualityLevel Camera_QualityLevel 图像质量等级的枚举。
typedef enum Camera_MetadataObjectType Camera_MetadataObjectType 元数据对象类型的枚举。
typedef struct Camera_Size Camera_Size 大小参数。
typedef struct Camera_Profile Camera_Profile 相机流的配置文件。
typedef struct Camera_FrameRateRange Camera_FrameRateRange 帧速率范围。
typedef struct Camera_VideoProfile Camera_VideoProfile 录像配置文件。
typedef struct Camera_OutputCapability Camera_OutputCapability 相机输出能力。
typedef struct Camera_Device Camera_Device 相机设备对象。
typedef struct Camera_StatusInfo Camera_StatusInfo 相机状态信息。
typedef struct Camera_Point Camera_Point 点参数。
typedef struct Camera_Location Camera_Location 拍照位置。
typedef struct Camera_PhotoCaptureSetting Camera_PhotoCaptureSetting 要设置的拍照捕获选项。
typedef struct Camera_FrameShutterInfo Camera_FrameShutterInfo 帧快门回调信息。
typedef struct Camera_CaptureEndInfo Camera_CaptureEndInfo 捕获结束信息。
typedef struct Camera_Rect Camera_Rect 矩形定义。
typedef struct Camera_MetadataObject Camera_MetadataObject 元数据对象基础。
typedef struct Camera_Input Camera_Input 相机输入对象。
typedef void(* OH_CameraInput_OnError) (const Camera_Input *cameraInput, Camera_ErrorCode errorCode) CameraInput_Callbacks中被调用的相机输入错误回调。
typedef struct CameraInput_Callbacks CameraInput_Callbacks 相机输入错误事件的回调。
typedef void(* OH_CameraManager_StatusCallback) (Camera_Manager *cameraManager, Camera_StatusInfo *status) CameraManager_Callbacks中被调用的相机管理器状态回调。
typedef struct CameraManager_Callbacks CameraManager_Callbacks 相机设备状态的回调。
typedef struct Camera_CaptureSession Camera_CaptureSession 捕获会话对象
typedef void(* OH_CaptureSession_OnFocusStateChange) (Camera_CaptureSession *session, Camera_FocusState focusState) CaptureSession_Callbacks中被调用的捕获会话焦点状态回调。
typedef void(* OH_CaptureSession_OnError) (Camera_CaptureSession *session, Camera_ErrorCode errorCode) CaptureSession_Callbacks中被调用的捕获会话错误回调。
typedef struct CaptureSession_Callbacks CaptureSession_Callbacks 捕获会话的回调。
typedef struct Camera_MetadataOutput Camera_MetadataOutput 元数据输出对象
typedef void(* OH_MetadataOutput_OnMetadataObjectAvailable) (Camera_MetadataOutput *metadataOutput, Camera_MetadataObject *metadataObject, uint32_t size) MetadataOutput_Callbacks中被调用的元数据输出元数据对象可用回调。
typedef void(* OH_MetadataOutput_OnError) (Camera_MetadataOutput *metadataOutput, Camera_ErrorCode errorCode) MetadataOutput_Callbacks中被调用的元数据输出错误回调。
typedef struct MetadataOutput_Callbacks MetadataOutput_Callbacks 元数据输出的回调。
typedef struct Camera_PhotoOutput Camera_PhotoOutput 拍照输出对象
typedef void(* OH_PhotoOutput_OnFrameStart) (Camera_PhotoOutput *photoOutput) PhotoOutput_Callbacks中被调用的拍照输出帧启动回调。
typedef void(* OH_PhotoOutput_OnFrameShutter) (Camera_PhotoOutput *photoOutput, Camera_FrameShutterInfo *info) PhotoOutput_Callbacks中被调用的拍照输出帧快门回调。
typedef void(* OH_PhotoOutput_OnFrameEnd) (Camera_PhotoOutput *photoOutput, int32_t frameCount) PhotoOutput_Callbacks中被调用的拍照输出帧结束回调。
typedef void(* OH_PhotoOutput_OnError) (Camera_PhotoOutput *photoOutput, Camera_ErrorCode errorCode) PhotoOutput_Callbacks中被调用的拍照输出错误回调。
typedef struct PhotoOutput_Callbacks PhotoOutput_Callbacks 拍照输出的回调。
typedef struct Camera_PreviewOutput Camera_PreviewOutput 预览输出对象
typedef void(* OH_PreviewOutput_OnFrameStart) (Camera_PreviewOutput *previewOutput) PreviewOutput_Callbacks中被调用的预览输出帧开始回调。
typedef void(* OH_PreviewOutput_OnFrameEnd) (Camera_PreviewOutput *previewOutput, int32_t frameCount) PreviewOutput_Callbacks中被调用的预览输出帧结束回调。
typedef void(* OH_PreviewOutput_OnError) (Camera_PreviewOutput *previewOutput, Camera_ErrorCode errorCode) PreviewOutput_Callbacks中被调用的预览输出帧错误回调。
typedef struct PreviewOutput_Callbacks PreviewOutput_Callbacks 用于预览输出的回调。
typedef struct Camera_VideoOutput Camera_VideoOutput 录像输出对象
typedef void(* OH_VideoOutput_OnFrameStart) (Camera_VideoOutput *videoOutput) VideoOutput_Callbacks中被调用的录像输出帧开始回调。
typedef void(* OH_VideoOutput_OnFrameEnd) (Camera_VideoOutput *videoOutput, int32_t frameCount) VideoOutput_Callbacks中被调用的录像输出帧结束回调。
typedef void(* OH_VideoOutput_OnError) (Camera_VideoOutput *videoOutput, Camera_ErrorCode errorCode) VideoOutput_Callbacks中被调用的录像输出错误回调。
typedef struct VideoOutput_Callbacks VideoOutput_Callbacks 用于录像输出的回调。

枚举

名称 描述
Camera_ErrorCode {
CAMERA_OK = 0,
CAMERA_INVALID_ARGUMENT = 7400101,
CAMERA_OPERATION_NOT_ALLOWED = 7400102,
CAMERA_SESSION_NOT_CONFIG = 7400103,
CAMERA_SESSION_NOT_RUNNING = 7400104,
CAMERA_SESSION_CONFIG_LOCKED = 7400105,
CAMERA_DEVICE_SETTING_LOCKED = 7400106,
CAMERA_CONFLICT_CAMERA = 7400107,
CAMERA_DEVICE_DISABLED = 7400108,
CAMERA_DEVICE_PREEMPTED = 7400109,
CAMERA_SERVICE_FATAL_ERROR = 7400201
}
相机错误代码的枚举。
Camera_Status {
CAMERA_STATUS_APPEAR = 0,
CAMERA_STATUS_DISAPPEAR = 1,
CAMERA_STATUS_AVAILABLE = 2,
CAMERA_STATUS_UNAVAILABLE = 3
}
相机状态的枚举。
Camera_Position {
CAMERA_POSITION_UNSPECIFIED = 0,
CAMERA_POSITION_BACK = 1,
CAMERA_POSITION_FRONT = 2
}
相机位置的枚举。
Camera_Type {
CAMERA_TYPE_DEFAULT = 0,
CAMERA_TYPE_WIDE_ANGLE = 1,
CAMERA_TYPE_ULTRA_WIDE = 2,
CAMERA_TYPE_TELEPHOTO = 3,
CAMERA_TYPE_TRUE_DEPTH = 4
}
相机类型的枚举。
Camera_Connection {
CAMERA_CONNECTION_BUILT_IN = 0,
CAMERA_CONNECTION_USB_PLUGIN = 1,
CAMERA_CONNECTION_REMOTE = 2
}
相机连接类型的枚举。
Camera_Format {
CAMERA_FORMAT_RGBA_8888 = 3,
CAMERA_FORMAT_YUV_420_SP = 1003,
CAMERA_FORMAT_JPEG = 2000
}
相机格式类型的枚举。
Camera_FlashMode {
FLASH_MODE_CLOSE = 0,
FLASH_MODE_OPEN = 1,
FLASH_MODE_AUTO = 2,
FLASH_MODE_ALWAYS_OPEN = 3
}
闪光模式的枚举。
Camera_ExposureMode {
EXPOSURE_MODE_LOCKED = 0,
EXPOSURE_MODE_AUTO = 1,
EXPOSURE_MODE_CONTINUOUS_AUTO = 2
}
曝光模式的枚举。
Camera_FocusMode {
FOCUS_MODE_MANUAL = 0,
FOCUS_MODE_CONTINUOUS_AUTO = 1,
FOCUS_MODE_AUTO = 2,
FOCUS_MODE_LOCKED = 3
}
聚焦模式的枚举。
Camera_FocusState {
FOCUS_STATE_SCAN = 0,
FOCUS_STATE_FOCUSED = 1,
FOCUS_STATE_UNFOCUSED = 2
}
焦点状态的枚举。
Camera_VideoStabilizationMode {
STABILIZATION_MODE_OFF = 0,
STABILIZATION_MODE_LOW = 1,
STABILIZATION_MODE_MIDDLE = 2,
STABILIZATION_MODE_HIGH = 3,
STABILIZATION_MODE_AUTO = 4
}
录像防抖模式的枚举。
Camera_ImageRotation {
IAMGE_ROTATION_0 = 0,
IAMGE_ROTATION_90 = 90,
IAMGE_ROTATION_180 = 180,
IAMGE_ROTATION_270 = 270
}
图像旋转角度的枚举。
Camera_QualityLevel {
QUALITY_LEVEL_HIGH = 0,
QUALITY_LEVEL_MEDIUM = 1,
QUALITY_LEVEL_LOW = 2
}
图像质量等级的枚举。
Camera_MetadataObjectType {
FACE_DETECTION = 0
}
元数据对象类型的枚举。

函数

名称 描述
Camera_ErrorCode OH_Camera_GetCameraManager (Camera_Manager **cameraManager) 创建CameraManager实例。
Camera_ErrorCode OH_Camera_DeleteCameraManager (Camera_Manager *cameraManager) 删除CameraManager实例。
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_Close (Camera_Input *cameraInput) 关闭相机。
Camera_ErrorCode OH_CameraInput_Release (Camera_Input *cameraInput) 释放相机输入实例。
Camera_ErrorCode OH_CameraManager_RegisterCallback (Camera_Manager *cameraManager, CameraManager_Callbacks *callback) 注册相机状态更改事件回调。
Camera_ErrorCode OH_CameraManager_UnregisterCallback (Camera_Manager *cameraManager, CameraManager_Callbacks *callback) 注销摄像机状态更改事件回调。
Camera_ErrorCode OH_CameraManager_GetSupportedCameras (Camera_Manager *cameraManager, Camera_Device **cameras, uint32_t *size) 获取支持相机的描述。
Camera_ErrorCode OH_CameraManager_DeleteSupportedCameras (Camera_Manager *cameraManager, Camera_Device *cameras, uint32_t size) 删除支持的相机。
Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapability (Camera_Manager *cameraManager, const Camera_Device *camera, Camera_OutputCapability **cameraOutputCapability) 获取特定相机和特定模式支持的输出功能。
Camera_ErrorCode OH_CameraManager_DeleteSupportedCameraOutputCapability (Camera_Manager *cameraManager, Camera_OutputCapability *cameraOutputCapability) 删除支持的输出功能。
Camera_ErrorCode OH_CameraManager_IsCameraMuted (Camera_Manager *cameraManager, bool *isCameraMuted) 确定相机是否静音。
Camera_ErrorCode OH_CameraManager_CreateCaptureSession (Camera_Manager *cameraManager, Camera_CaptureSession **captureSession) 创建捕获会话实例。
Camera_ErrorCode OH_CameraManager_CreateCameraInput (Camera_Manager *cameraManager, const Camera_Device *camera, Camera_Input **cameraInput) 创建相机输入实例。
Camera_ErrorCode OH_CameraManager_CreateCameraInput_WithPositionAndType (Camera_Manager *cameraManager, Camera_Position position, Camera_Type type, Camera_Input **cameraInput) 创建具有位置和类型的相机输入实例
Camera_ErrorCode OH_CameraManager_CreatePreviewOutput (Camera_Manager *cameraManager, const Camera_Profile *profile, const char *surfaceId, Camera_PreviewOutput **previewOutput) 创建预览输出实例。
Camera_ErrorCode OH_CameraManager_CreatePhotoOutput (Camera_Manager *cameraManager, const Camera_Profile *profile, const char *surfaceId, Camera_PhotoOutput **photoOutput) 创建一个拍照输出实例。
Camera_ErrorCode OH_CameraManager_CreateVideoOutput (Camera_Manager *cameraManager, const Camera_VideoProfile *profile, const char *surfaceId, Camera_VideoOutput **videoOutput) 创建一个录像输出实例。
Camera_ErrorCode OH_CameraManager_CreateMetadataOutput (Camera_Manager *cameraManager, const Camera_MetadataObjectType *profile, Camera_MetadataOutput **metadataOutput) 创建元数据输出实例。
Camera_ErrorCode OH_CaptureSession_RegisterCallback (Camera_CaptureSession *session, CaptureSession_Callbacks *callback) 注册捕获会话事件回调。
Camera_ErrorCode OH_CaptureSession_UnregisterCallback (Camera_CaptureSession *session, CaptureSession_Callbacks *callback) 注销捕获会话事件回调。
Camera_ErrorCode OH_CaptureSession_BeginConfig (Camera_CaptureSession *session) 开始捕获会话配置。
Camera_ErrorCode OH_CaptureSession_CommitConfig (Camera_CaptureSession *session) 提交捕获会话配置。
Camera_ErrorCode OH_CaptureSession_AddInput (Camera_CaptureSession *session, Camera_Input *cameraInput) 添加相机输入。
Camera_ErrorCode OH_CaptureSession_RemoveInput (Camera_CaptureSession *session, Camera_Input *cameraInput) 删除相机输入。
Camera_ErrorCode OH_CaptureSession_AddPreviewOutput (Camera_CaptureSession *session, Camera_PreviewOutput *previewOutput) 添加预览输出。
Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput (Camera_CaptureSession *session, Camera_PreviewOutput *previewOutput) 删除预览输出。
Camera_ErrorCode OH_CaptureSession_AddPhotoOutput (Camera_CaptureSession *session, Camera_PhotoOutput *photoOutput) 添加拍照输出。
Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput (Camera_CaptureSession *session, Camera_PhotoOutput *photoOutput) 删除拍照输出。
Camera_ErrorCode OH_CaptureSession_AddVideoOutput (Camera_CaptureSession *session, Camera_VideoOutput *videoOutput) 添加录像输出。
Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput (Camera_CaptureSession *session, Camera_VideoOutput *videoOutput) 删除录像输出。
Camera_ErrorCode OH_CaptureSession_AddMetadataOutput (Camera_CaptureSession *session, Camera_MetadataOutput *metadataOutput) 添加元数据输出。
Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput (Camera_CaptureSession *session, Camera_MetadataOutput *metadataOutput) 删除元数据输出。
Camera_ErrorCode OH_CaptureSession_Start (Camera_CaptureSession *session) 启动捕获会话。
Camera_ErrorCode OH_CaptureSession_Stop (Camera_CaptureSession *session) 停止捕获会话。
Camera_ErrorCode OH_CaptureSession_Release (Camera_CaptureSession *session) 释放捕获会话。
Camera_ErrorCode OH_CaptureSession_HasFlash (Camera_CaptureSession *session, bool *hasFlash) 检查设备是否有闪光灯。
Camera_ErrorCode OH_CaptureSession_IsFlashModeSupported (Camera_CaptureSession *session, Camera_FlashMode flashMode, bool *isSupported) 检查是否支持指定的闪光灯模式。
Camera_ErrorCode OH_CaptureSession_GetFlashMode (Camera_CaptureSession *session, Camera_FlashMode *flashMode) 获取当前闪光灯模式。
Camera_ErrorCode OH_CaptureSession_SetFlashMode (Camera_CaptureSession *session, Camera_FlashMode flashMode) 设置闪光灯模式。
Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported (Camera_CaptureSession *session, Camera_ExposureMode exposureMode, bool *isSupported) 检查是否支持指定的曝光模式。
Camera_ErrorCode OH_CaptureSession_GetExposureMode (Camera_CaptureSession *session, Camera_ExposureMode *exposureMode) 获取当前曝光模式。
Camera_ErrorCode OH_CaptureSession_SetExposureMode (Camera_CaptureSession *session, Camera_ExposureMode exposureMode) 设置曝光模式。
Camera_ErrorCode OH_CaptureSession_GetMeteringPoint (Camera_CaptureSession *session, Camera_Point *point) 获取当前测量点。
Camera_ErrorCode OH_CaptureSession_SetMeteringPoint (Camera_CaptureSession *session, Camera_Point point) 设置计量区域的中心点。
Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange (Camera_CaptureSession *session, float *minExposureBias, float *maxExposureBias, float *step) 查询曝光补偿范围。
Camera_ErrorCode OH_CaptureSession_SetExposureBias (Camera_CaptureSession *session, float exposureBias) 设置曝光补偿。
Camera_ErrorCode OH_CaptureSession_GetExposureBias (Camera_CaptureSession *session, float *exposureBias) 获取当前曝光补偿。
Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported (Camera_CaptureSession *session, Camera_FocusMode focusMode, bool *isSupported) 检查是否支持指定的聚焦模式。
Camera_ErrorCode OH_CaptureSession_GetFocusMode (Camera_CaptureSession *session, Camera_FocusMode *focusMode) 获取当前聚焦模式。
Camera_ErrorCode OH_CaptureSession_SetFocusMode (Camera_CaptureSession *session, Camera_FocusMode focusMode) 设置聚焦模式。
Camera_ErrorCode OH_CaptureSession_GetFocusPoint (Camera_CaptureSession *session, Camera_Point *focusPoint) 获取当前焦点。
Camera_ErrorCode OH_CaptureSession_SetFocusPoint (Camera_CaptureSession *session, Camera_Point focusPoint) 设置焦点。
Camera_ErrorCode OH_CaptureSession_GetZoomRatioRange (Camera_CaptureSession *session, float *minZoom, float *maxZoom) 获取所有支持的缩放比例范围。
Camera_ErrorCode OH_CaptureSession_GetZoomRatio (Camera_CaptureSession *session, float *zoom) 获取当前缩放比例。
Camera_ErrorCode OH_CaptureSession_SetZoomRatio (Camera_CaptureSession *session, float zoom) 设置缩放比例。
Camera_ErrorCode OH_CaptureSession_IsVideoStabilizationModeSupported (Camera_CaptureSession *session, Camera_VideoStabilizationMode mode, bool *isSupported) 检查是否支持指定的录像防抖模式。
Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode (Camera_CaptureSession *session, Camera_VideoStabilizationMode *mode) 获取当前录像防抖模式。
Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode (Camera_CaptureSession *session, Camera_VideoStabilizationMode mode) 设置录像防抖模式。
Camera_ErrorCode OH_MetadataOutput_RegisterCallback (Camera_MetadataOutput *metadataOutput, MetadataOutput_Callbacks *callback) 注册元数据输出更改事件回调。
Camera_ErrorCode OH_MetadataOutput_UnregisterCallback (Camera_MetadataOutput *metadataOutput, MetadataOutput_Callbacks *callback) 注销元数据输出更改事件回调。
Camera_ErrorCode OH_MetadataOutput_Start (Camera_MetadataOutput *metadataOutput) 启动元数据输出。
Camera_ErrorCode OH_MetadataOutput_Stop (Camera_MetadataOutput *metadataOutput) 停止元数据输出。
Camera_ErrorCode OH_MetadataOutput_Release (Camera_MetadataOutput *metadataOutput) 释放元数据输出。
Camera_ErrorCode OH_PhotoOutput_RegisterCallback (Camera_PhotoOutput *photoOutput, PhotoOutput_Callbacks *callback) 注册拍照输出更改事件回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterCallback (Camera_PhotoOutput *photoOutput, PhotoOutput_Callbacks *callback) 注销拍照输出更改事件回调。
Camera_ErrorCode OH_PhotoOutput_Capture (Camera_PhotoOutput *photoOutput) 拍摄照片。
Camera_ErrorCode OH_PhotoOutput_Capture_WithCaptureSetting (Camera_PhotoOutput *photoOutput, Camera_PhotoCaptureSetting setting) 使用捕获设置捕获拍照。
Camera_ErrorCode OH_PhotoOutput_Release (Camera_PhotoOutput *photoOutput) 释放拍照输出。
Camera_ErrorCode OH_PhotoOutput_IsMirrorSupported (Camera_PhotoOutput *photoOutput, bool *isSupported) 检查是否支持镜像拍照。
Camera_ErrorCode OH_PreviewOutput_RegisterCallback (Camera_PreviewOutput *previewOutput, PreviewOutput_Callbacks *callback) 注册预览输出更改事件回调。
Camera_ErrorCode OH_PreviewOutput_UnregisterCallback (Camera_PreviewOutput *previewOutput, PreviewOutput_Callbacks *callback) 注销预览输出更改事件回调。
Camera_ErrorCode OH_PreviewOutput_Start (Camera_PreviewOutput *previewOutput) 开始预览输出。
Camera_ErrorCode OH_PreviewOutput_Stop (Camera_PreviewOutput *previewOutput) 停止预览输出。
Camera_ErrorCode OH_PreviewOutput_Release (Camera_PreviewOutput *previewOutput) 释放预览输出。
Camera_ErrorCode OH_VideoOutput_RegisterCallback (Camera_VideoOutput *videoOutput, VideoOutput_Callbacks *callback) 注册录像输出更改事件回调。
Camera_ErrorCode OH_VideoOutput_UnregisterCallback (Camera_VideoOutput *videoOutput, VideoOutput_Callbacks *callback) 注销录像输出更改事件回调。
Camera_ErrorCode OH_VideoOutput_Start (Camera_VideoOutput *videoOutput) 开始录像输出。
Camera_ErrorCode OH_VideoOutput_Stop (Camera_VideoOutput *videoOutput) 停止录像输出。
Camera_ErrorCode OH_VideoOutput_Release (Camera_VideoOutput *videoOutput) 释放录像输出。

类型定义说明

Camera_CaptureEndInfo

typedef struct Camera_CaptureEndInfo Camera_CaptureEndInfo

描述

捕获结束信息。

起始版本: 11

Camera_CaptureSession

typedef struct Camera_CaptureSession Camera_CaptureSession

描述

捕获会话对象。

可以使用OH_CameraManager_CreateCaptureSession方法创建指针。

起始版本: 11

Camera_Connection

typedef enum Camera_Connection Camera_Connection

描述

相机连接类型的枚举。

起始版本: 11

Camera_Device

typedef struct Camera_Device Camera_Device

描述

相机设备对象。

起始版本: 11

Camera_ErrorCode

typedef enum Camera_ErrorCode Camera_ErrorCode

描述

相机错误代码的枚举。

起始版本: 11

Camera_ExposureMode

typedef enum Camera_ExposureMode Camera_ExposureMode

描述

曝光模式的枚举。

起始版本: 11

Camera_FlashMode

typedef enum Camera_FlashMode Camera_FlashMode

描述

闪光模式的枚举。

起始版本: 11

Camera_FocusMode

typedef enum Camera_FocusMode Camera_FocusMode

描述

聚焦模式的枚举。

起始版本: 11

Camera_FocusState

typedef enum Camera_FocusState Camera_FocusState

描述

焦点状态的枚举。

起始版本: 11

Camera_Format

typedef enum Camera_Format Camera_Format

描述

相机格式类型的枚举。

起始版本: 11

Camera_FrameRateRange

typedef struct Camera_FrameRateRange Camera_FrameRateRange

描述

帧速率范围。

起始版本: 11

Camera_FrameShutterInfo

typedef struct Camera_FrameShutterInfo Camera_FrameShutterInfo

描述

帧快门回调信息。

起始版本: 11

Camera_ImageRotation

typedef enum Camera_ImageRotation Camera_ImageRotation

描述

图像旋转角度的枚举。

起始版本: 11

Camera_Input

typedef struct Camera_Input Camera_Input

描述

相机输入对象。

可以使用OH_CameraManager_CreateCameraInput方法创建指针。

起始版本: 11

Camera_Location

typedef struct Camera_Location Camera_Location

描述

拍照位置。

起始版本: 11

Camera_Manager

typedef struct Camera_Manager Camera_Manager

描述

相机管理器对象。

可以使用OH_Camera_GetCameraManager方法创建指针。

起始版本: 11

Camera_MetadataObject

typedef struct Camera_MetadataObject Camera_MetadataObject

描述

元数据对象基础。

起始版本: 11

Camera_MetadataObjectType

typedef enum Camera_MetadataObjectType Camera_MetadataObjectType

描述

元数据对象类型的枚举。

起始版本: 11

Camera_MetadataOutput

typedef struct Camera_MetadataOutput Camera_MetadataOutput

描述

元数据输出对象

可以使用OH_CameraManager_CreateMetadataOutput方法创建指针。

起始版本: 11

Camera_OutputCapability

typedef struct Camera_OutputCapability Camera_OutputCapability

描述

相机输出能力。

起始版本: 11

Camera_PhotoCaptureSetting

typedef struct Camera_PhotoCaptureSetting Camera_PhotoCaptureSetting

描述

要设置的拍照捕获选项。

起始版本: 11

Camera_PhotoOutput

typedef struct Camera_PhotoOutput Camera_PhotoOutput

描述

拍照输出对象

可以使用OH_CameraManager_CreatePhotoOutput方法创建指针。

起始版本: 11

Camera_Point

typedef struct Camera_Point Camera_Point

描述

点参数。

起始版本: 11

Camera_Position

typedef enum Camera_Position Camera_Position

描述

相机位置的枚举。

起始版本: 11

Camera_PreviewOutput

typedef struct Camera_PreviewOutput Camera_PreviewOutput

描述

预览输出对象

可以使用OH_CameraManager_CreatePreviewOutput方法创建指针。

起始版本: 11

Camera_Profile

typedef struct Camera_Profile Camera_Profile

描述

相机流的配置文件。

起始版本: 11

Camera_QualityLevel

typedef enum Camera_QualityLevel Camera_QualityLevel

描述

图像质量等级的枚举。

起始版本: 11

Camera_Rect

typedef struct Camera_Rect Camera_Rect

描述

矩形定义。

起始版本: 11

Camera_Size

typedef struct Camera_Size Camera_Size

描述

大小参数。

起始版本: 11

Camera_Status

typedef enum Camera_Status Camera_Status

描述

相机状态的枚举。

起始版本: 11

Camera_StatusInfo

typedef struct Camera_StatusInfo Camera_StatusInfo

描述

相机状态信息。

起始版本: 11

Camera_Type

typedef enum Camera_Type Camera_Type

描述

相机类型的枚举。

起始版本: 11

Camera_VideoOutput

typedef struct Camera_VideoOutput Camera_VideoOutput

描述

录像输出对象

可以使用OH_CameraManager_CreateVideoOutput方法创建指针。

起始版本: 11

Camera_VideoProfile

typedef struct Camera_VideoProfile Camera_VideoProfile

描述

录像配置文件。

起始版本: 11

Camera_VideoStabilizationMode

typedef enum Camera_VideoStabilizationMode Camera_VideoStabilizationMode

描述

录像防抖模式的枚举。

起始版本: 11

CameraInput_Callbacks

typedef struct CameraInput_Callbacks CameraInput_Callbacks

描述

相机输入错误事件的回调。

起始版本: 11

参见:

OH_CameraInput_RegisterCallback

CameraManager_Callbacks

typedef struct CameraManager_Callbacks CameraManager_Callbacks

描述

相机设备状态的回调。

起始版本: 11

参见:

OH_CameraManager_RegisterCallback

CaptureSession_Callbacks

typedef struct CaptureSession_Callbacks CaptureSession_Callbacks

描述

捕获会话的回调。

起始版本: 11

参见:

OH_CaptureSession_RegisterCallback

MetadataOutput_Callbacks

typedef struct MetadataOutput_Callbacks MetadataOutput_Callbacks

描述

元数据输出的回调。

起始版本: 11

参见:

OH_MetadataOutput_RegisterCallback

OH_CameraInput_OnError

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

描述

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

起始版本: 11

参数:

名称 描述
cameraInput 传递回调的Camera_Input
errorCode 相机输入的Camera_ErrorCode

参见:

Camera_ErrorCode中的:

CAMERA_CONFLICT_CAMERA

CAMERA_DEVICE_DISABLED

CAMERA_DEVICE_PREEMPTED

CAMERA_SERVICE_FATAL_ERROR

OH_CameraManager_StatusCallback

typedef void(* OH_CameraManager_StatusCallback) (Camera_Manager *cameraManager, Camera_StatusInfo *status)

描述

CameraManager_Callbacks中被调用的相机管理器状态回调。

起始版本: 11

参数:

名称 描述
cameraManager 传递回调的Camera_Manager
status 每个相机设备的Camera_StatusInfo

OH_CaptureSession_OnError

typedef void(* OH_CaptureSession_OnError) (Camera_CaptureSession *session, Camera_ErrorCode errorCode)

描述

CaptureSession_Callbacks中被调用的捕获会话错误回调。

起始版本: 11

参数:

名称 描述
session 传递回调的Camera_CaptureSession
errorCode 捕获会话的Camera_ErrorCode

参见:

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_CaptureSession_OnFocusStateChange

typedef void(* OH_CaptureSession_OnFocusStateChange) (Camera_CaptureSession *session, Camera_FocusState focusState)

描述

CaptureSession_Callbacks中被调用的捕获会话焦点状态回调。

起始版本: 11

参数:

名称 描述
session 传递回调的Camera_CaptureSession
focusState 回调传递的Camera_FocusState

OH_MetadataOutput_OnError

typedef void(* OH_MetadataOutput_OnError) (Camera_MetadataOutput *metadataOutput, Camera_ErrorCode errorCode)

描述

MetadataOutput_Callbacks中被调用的元数据输出错误回调。

起始版本: 11

参数:

名称 描述
metadataOutput 传递回调的Camera_MetadataOutput
errorCode 元数据输出的Camera_ErrorCode

参见:

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_MetadataOutput_OnMetadataObjectAvailable

typedef void(* OH_MetadataOutput_OnMetadataObjectAvailable) (Camera_MetadataOutput *metadataOutput, Camera_MetadataObject *metadataObject, uint32_t size)

描述

MetadataOutput_Callbacks中被调用的元数据输出元数据对象可用回调。

起始版本: 11

参数:

名称 描述
metadataOutput 传递回调的Camera_MetadataOutput
metadataObject Camera_MetadataObject将由回调传递。
size 元数据对象的大小。

OH_PhotoOutput_OnError

typedef void(* OH_PhotoOutput_OnError) (Camera_PhotoOutput *photoOutput, Camera_ErrorCode errorCode)

描述

PhotoOutput_Callbacks中被调用的拍照输出错误回调。

起始版本: 11

参数:

名称 描述
photoOutput 传递回调的Camera_PhotoOutput
errorCode 拍照输出的Camera_ErrorCode

参见:

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_PhotoOutput_OnFrameEnd

typedef void(* OH_PhotoOutput_OnFrameEnd) (Camera_PhotoOutput *photoOutput, int32_t frameCount)

描述

PhotoOutput_Callbacks中被调用的拍照输出帧结束回调。

起始版本: 11

参数:

名称 描述
photoOutput 传递回调的Camera_PhotoOutput
frameCount 回调传递的帧计数。

OH_PhotoOutput_OnFrameShutter

typedef void(* OH_PhotoOutput_OnFrameShutter) (Camera_PhotoOutput *photoOutput, Camera_FrameShutterInfo *info)

描述

PhotoOutput_Callbacks中被调用的拍照输出帧快门回调。

起始版本: 11

参数:

名称 描述
photoOutput 传递回调的Camera_PhotoOutput
info 回调传递的Camera_FrameShutterInfo

OH_PhotoOutput_OnFrameStart

typedef void(* OH_PhotoOutput_OnFrameStart) (Camera_PhotoOutput *photoOutput)

描述

PhotoOutput_Callbacks中被调用的拍照输出帧启动回调。

起始版本: 11

参数:

名称 描述
photoOutput 传递回调的Camera_PhotoOutput

OH_PreviewOutput_OnError

typedef void(* OH_PreviewOutput_OnError) (Camera_PreviewOutput *previewOutput, Camera_ErrorCode errorCode)

描述

PreviewOutput_Callbacks中被调用的预览输出帧错误回调。

起始版本: 11

参数:

名称 描述
previewOutput 传递回调的Camera_PreviewOutput
errorCode 预览输出的Camera_ErrorCode

参见:

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_PreviewOutput_OnFrameEnd

typedef void(* OH_PreviewOutput_OnFrameEnd) (Camera_PreviewOutput *previewOutput, int32_t frameCount)

描述

PreviewOutput_Callbacks中被调用的预览输出帧结束回调。

起始版本: 11

参数:

名称 描述
previewOutput 传递回调的Camera_PreviewOutput
frameCount 回调传递的帧计数。

OH_PreviewOutput_OnFrameStart

typedef void(* OH_PreviewOutput_OnFrameStart) (Camera_PreviewOutput *previewOutput)

描述

PreviewOutput_Callbacks中被调用的预览输出帧开始回调。

起始版本: 11

参数:

名称 描述
previewOutput 传递回调的Camera_PreviewOutput

OH_VideoOutput_OnError

typedef void(* OH_VideoOutput_OnError) (Camera_VideoOutput *videoOutput, Camera_ErrorCode errorCode)

描述

VideoOutput_Callbacks中被调用的录像输出错误回调。

起始版本: 11

参数:

名称 描述
videoOutput 传递回调的Camera_VideoOutput
errorCode 录像输出的Camera_ErrorCode

参见:

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_VideoOutput_OnFrameEnd

typedef void(* OH_VideoOutput_OnFrameEnd) (Camera_VideoOutput *videoOutput, int32_t frameCount)

描述

VideoOutput_Callbacks中被调用的录像输出帧结束回调。

起始版本: 11

参数:

名称 描述
videoOutput 传递回调的Camera_VideoOutput
frameCount 回调传递的帧计数。

OH_VideoOutput_OnFrameStart

typedef void(* OH_VideoOutput_OnFrameStart) (Camera_VideoOutput *videoOutput)

描述

VideoOutput_Callbacks中被调用的录像输出帧开始回调。

起始版本: 11

参数:

名称 描述
videoOutput 传递回调的Camera_VideoOutput

PhotoOutput_Callbacks

typedef struct PhotoOutput_CallbacksPhotoOutput_Callbacks

描述

拍照输出的回调。

起始版本: 11

参见:

OH_PhotoOutput_RegisterCallback

PreviewOutput_Callbacks

typedef struct PreviewOutput_CallbacksPreviewOutput_Callbacks

描述

用于预览输出的回调。

起始版本: 11

参见:

OH_PreviewOutput_RegisterCallback

VideoOutput_Callbacks

typedef struct VideoOutput_CallbacksVideoOutput_Callbacks

描述

用于录像输出的回调。

起始版本: 11

参见:

OH_VideoOutput_RegisterCallback

枚举类型说明

Camera_Connection

enum Camera_Connection

描述

相机连接类型的枚举。

起始版本: 11

枚举值 描述
CAMERA_CONNECTION_BUILT_IN 内置摄像头。
CAMERA_CONNECTION_USB_PLUGIN 使用USB连接的摄像头。
CAMERA_CONNECTION_REMOTE 远程摄像头。

Camera_ErrorCode

enum Camera_ErrorCode

描述

相机错误代码的枚举。

起始版本: 11

枚举值 描述
CAMERA_OK 相机结果正常。
CAMERA_INVALID_ARGUMENT 参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED 不允许操作。
CAMERA_SESSION_NOT_CONFIG 会话未配置。
CAMERA_SESSION_NOT_RUNNING 会话未运行。
CAMERA_SESSION_CONFIG_LOCKED 会话配置已锁定。
CAMERA_DEVICE_SETTING_LOCKED 设备设置已锁定。
CAMERA_CONFLICT_CAMERA 因冲突而无法使用相机。
CAMERA_DEVICE_DISABLED 由于安全原因,相机已禁用。
CAMERA_DEVICE_PREEMPTED 因被抢占而无法使用相机。
CAMERA_SERVICE_FATAL_ERROR 相机服务致命错误。

Camera_ExposureMode

enum Camera_ExposureMode

描述

曝光模式的枚举。

起始版本: 11

枚举值 描述
EXPOSURE_MODE_LOCKED 锁定曝光模式。
EXPOSURE_MODE_AUTO 自动曝光模式。
EXPOSURE_MODE_CONTINUOUS_AUTO 连续自动曝光。

Camera_FlashMode

enum Camera_FlashMode

描述

闪光模式的枚举。

起始版本: 11

枚举值 描述
FLASH_MODE_CLOSE 关闭模式。
FLASH_MODE_OPEN 打开模式。
FLASH_MODE_AUTO 自动模式。
FLASH_MODE_ALWAYS_OPEN 始终打开模式。

Camera_FocusMode

enum Camera_FocusMode

描述

聚焦模式的枚举。

起始版本: 11

枚举值 描述
FOCUS_MODE_MANUAL 手动模式。
FOCUS_MODE_CONTINUOUS_AUTO 连续自动模式。
FOCUS_MODE_AUTO 自动模式。
FOCUS_MODE_LOCKED 锁定模式。

Camera_FocusState

enum Camera_FocusState

描述

焦点状态的枚举。

起始版本: 11

枚举值 描述
FOCUS_STATE_SCAN 扫描状态。
FOCUS_STATE_FOCUSED 聚焦状态。
FOCUS_STATE_UNFOCUSED 非聚焦状态。

Camera_Format

enum Camera_Format

描述

相机格式类型的枚举。

起始版本: 11

枚举值 描述
CAMERA_FORMAT_RGBA_8888 RGBA 8888格式。
CAMERA_FORMAT_YUV_420_SP YUV 420格式。
CAMERA_FORMAT_JPEG JPEG格式。

Camera_ImageRotation

enum Camera_ImageRotation

描述

图像旋转角度的枚举。

起始版本: 11

枚举值 描述
IAMGE_ROTATION_0 捕获图像旋转0度。
IAMGE_ROTATION_90 捕获图像旋转90度。
IAMGE_ROTATION_180 捕获图像旋转180度。
IAMGE_ROTATION_270 捕获图像旋转270度。

Camera_MetadataObjectType

enum Camera_MetadataObjectType

描述

元数据对象类型的枚举。

起始版本: 11

枚举值 描述
FACE_DETECTION 人脸检测。

Camera_Position

enum Camera_Position

描述

相机位置的枚举。

起始版本: 11

枚举值 描述
CAMERA_POSITION_UNSPECIFIED 未指定位置。
CAMERA_POSITION_BACK 后置。
CAMERA_POSITION_FRONT 前置。

Camera_QualityLevel

enum Camera_QualityLevel

描述

图像质量等级的枚举。

起始版本: 11

枚举值 描述
QUALITY_LEVEL_HIGH 高图像质量。
QUALITY_LEVEL_MEDIUM 中等图像质量。
QUALITY_LEVEL_LOW 低图像质量。

Camera_Status

enum Camera_Status

描述

相机状态的枚举。

起始版本: 11

枚举值 描述
CAMERA_STATUS_APPEAR 显示状态。
CAMERA_STATUS_DISAPPEAR 消失状态。
CAMERA_STATUS_AVAILABLE 可用状态。
CAMERA_STATUS_UNAVAILABLE 不可用状态。

Camera_Type

enum Camera_Type

描述

相机类型的枚举。

起始版本: 11

枚举值 描述
CAMERA_TYPE_DEFAULT 默认相机类型。
CAMERA_TYPE_WIDE_ANGLE 广角相机。
CAMERA_TYPE_ULTRA_WIDE 超广角相机。
CAMERA_TYPE_TELEPHOTO 电话相机。
CAMERA_TYPE_TRUE_DEPTH 景深相机。

Camera_VideoStabilizationMode

enum Camera_VideoStabilizationMode

描述

录像防抖模式的枚举。

起始版本: 11

枚举值 描述
STABILIZATION_MODE_OFF 关闭录像防抖。
STABILIZATION_MODE_LOW LOW模式提供基本的防抖效果。
STABILIZATION_MODE_MIDDLE MIDDLE模式意味着通过算法可以获得比LOW模式更好的效果。
STABILIZATION_MODE_HIGH HIGH模式意味着通过算法可以获得比MIDDLE模式更好的效果。
STABILIZATION_MODE_AUTO 自动选择模式,HDF相机可用。

函数说明

OH_Camera_DeleteCameraManager()

Camera_ErrorCode OH_Camera_DeleteCameraManager (Camera_Manager * cameraManager)

描述

删除CameraManager实例。

起始版本: 11

参数:

名称 描述
cameraManager 要删除的Camera_Manager实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_Camera_GetCameraManager()

Camera_ErrorCode OH_Camera_GetCameraManager (Camera_Manager ** cameraManager)

描述

创建CameraManager实例。

起始版本: 11

参数:

名称 描述
cameraManager 如果方法调用成功,将创建输出Camera_Manager

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraInput_Close()

Camera_ErrorCode OH_CameraInput_Close (Camera_Input * cameraInput)

描述

关闭相机。

起始版本: 11

参数:

名称 描述
cameraInput 要关闭的Camera_Input实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraInput_Open()

Camera_ErrorCode OH_CameraInput_Open (Camera_Input * cameraInput)

描述

打开相机。

起始版本: 11

参数:

名称 描述
cameraInput 要打开的Camera_Input实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不能使用相机会导致冲突返回CAMERA_CONFLICT_CAMERA;如果由于安全原因禁用了摄像头返回CAMERA_DEVICE_DISABLED;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraInput_RegisterCallback()

Camera_ErrorCode OH_CameraInput_RegisterCallback (Camera_Input * cameraInput, CameraInput_Callbacks * callback )

描述

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

起始版本: 11

参数:

名称 描述
cameraInput Camera_Input实例。
callback 要注册的CameraInput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraInput_Release()

Camera_ErrorCode OH_CameraInput_Release (Camera_Input * cameraInput)

描述

释放相机输入实例。

起始版本: 11

参数:

名称 描述
cameraInput 要释放的Camera_Input实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraInput_UnregisterCallback()

Camera_ErrorCode OH_CameraInput_UnregisterCallback (Camera_Input * cameraInput, CameraInput_Callbacks * callback )

描述

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

起始版本: 11

参数:

名称 描述
cameraInput Camera_Input实例。
callback 要注销的CameraInput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_CreateCameraInput()

Camera_ErrorCode OH_CameraManager_CreateCameraInput (Camera_Manager * cameraManager, const Camera_Device * camera, Camera_Input ** cameraInput )

描述

创建相机输入实例。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
camera 用于创建Camera_InputCamera_Device
cameraInput 如果方法调用成功,将创建Camera_Input

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

需要权限:

ohos.permission.CAMERA

OH_CameraManager_CreateCameraInput_WithPositionAndType()

Camera_ErrorCode OH_CameraManager_CreateCameraInput_WithPositionAndType (Camera_Manager * cameraManager, Camera_Position position, Camera_Type type, Camera_Input ** cameraInput )

描述

创建具有位置和类型的相机输入实例

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
position 用于创建Camera_InputCamera_Position
type 用于创建Camera_InputCamera_Type
cameraInput 如果方法调用成功,将创建Camera_Input

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

需要权限:

ohos.permission.CAMERA

OH_CameraManager_CreateCaptureSession()

Camera_ErrorCode OH_CameraManager_CreateCaptureSession (Camera_Manager * cameraManager, Camera_CaptureSession ** captureSession )

描述

创建捕获会话实例。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
captureSession 如果方法调用成功,则将创建Camera_CaptureSession

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraManager_CreateMetadataOutput()

Camera_ErrorCode OH_CameraManager_CreateMetadataOutput (Camera_Manager * cameraManager, const Camera_MetadataObjectType * profile, Camera_MetadataOutput ** metadataOutput )

描述

创建元数据输出实例。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
profile 用于创建Camera_MetadataOutputCamera_MetadataObjectType.
metadataOutput 如果方法调用成功,将创建Camera_MetadataOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraManager_CreatePhotoOutput()

Camera_ErrorCode OH_CameraManager_CreatePhotoOutput (Camera_Manager * cameraManager, const Camera_Profile * profile, const char * surfaceId, Camera_PhotoOutput ** photoOutput )

描述

创建一个拍照输出实例。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
profile 用于创建Camera_PhotoOutputCamera_Profile
surfaceId 用于创建Camera_PhotoOutput
photoOutput 如果方法调用成功,将创建Camera_PhotoOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraManager_CreatePreviewOutput()

Camera_ErrorCode OH_CameraManager_CreatePreviewOutput (Camera_Manager * cameraManager, const Camera_Profile * profile, const char * surfaceId, Camera_PreviewOutput ** previewOutput )

描述

创建预览输出实例。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
profile 用于创建Camera_PreviewOutputCamera_Profile
surfaceId 用于创建Camera_PreviewOutput
previewOutput 如果方法调用成功,将创建Camera_PreviewOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraManager_CreateVideoOutput()

Camera_ErrorCode OH_CameraManager_CreateVideoOutput (Camera_Manager * cameraManager, const Camera_VideoProfile * profile, const char * surfaceId, Camera_VideoOutput ** videoOutput )

描述

创建一个录像输出实例。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
profile 用于创建Camera_VideoOutputCamera_VideoProfile
surfaceId 用于创建Camera_VideoOutput
videoOutput 如果方法调用成功,将创建Camera_VideoOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CameraManager_DeleteSupportedCameraOutputCapability()

Camera_ErrorCode OH_CameraManager_DeleteSupportedCameraOutputCapability (Camera_Manager * cameraManager, Camera_OutputCapability * cameraOutputCapability )

描述

删除支持的输出功能。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
cameraOutputCapability 要删除的Camera_OutputCapability

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_DeleteSupportedCameras()

Camera_ErrorCode OH_CameraManager_DeleteSupportedCameras (Camera_Manager * cameraManager, Camera_Device * cameras, uint32_t size )

描述

删除支持的相机。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
cameras 要删除的Camera_Device列表。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_GetSupportedCameraOutputCapability()

Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapability (Camera_Manager * cameraManager, const Camera_Device * camera, Camera_OutputCapability ** cameraOutputCapability )

描述

获取特定相机和特定模式支持的输出功能。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
cameras 要查询的Camera_Device
cameraOutputCapability 如果方法调用成功,则将记录支持的Camera_OutputCapability

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_GetSupportedCameras()

Camera_ErrorCode OH_CameraManager_GetSupportedCameras (Camera_Manager * cameraManager, Camera_Device ** cameras, uint32_t * size )

描述

获取支持相机的描述。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
cameras 如果方法调用成功,则将记录支持的Camera_Device列表。
size 如果方法调用成功,则将记录支持的Camera_Device列表的大小。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_IsCameraMuted()

Camera_ErrorCode OH_CameraManager_IsCameraMuted (Camera_Manager * cameraManager, bool * isCameraMuted )

描述

确定相机是否静音。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
isCameraMuted 如果方法调用成功,将判断相机是否静音。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_RegisterCallback()

Camera_ErrorCode OH_CameraManager_RegisterCallback (Camera_Manager * cameraManager, CameraManager_Callbacks * callback )

描述

注册相机状态更改事件回调。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
callback 要注册的CameraManager_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CameraManager_UnregisterCallback()

Camera_ErrorCode OH_CameraManager_UnregisterCallback (Camera_Manager * cameraManager, CameraManager_Callbacks * callback )

描述

注销摄像机状态更改事件回调。

起始版本: 11

参数:

名称 描述
cameraManager Camera_Manager实例。
callback 要注销的CameraManager_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CaptureSession_AddInput()

Camera_ErrorCode OH_CaptureSession_AddInput (Camera_CaptureSession * session, Camera_Input * cameraInput )

描述

添加相机输入。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
cameraInput 要添加的目标Camera_Input

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_AddMetadataOutput()

Camera_ErrorCode OH_CaptureSession_AddMetadataOutput (Camera_CaptureSession * session, Camera_MetadataOutput * metadataOutput )

描述

添加元数据输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
metadataOutput 要添加的目标Camera_MetadataOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_AddPhotoOutput()

Camera_ErrorCode OH_CaptureSession_AddPhotoOutput (Camera_CaptureSession * session, Camera_PhotoOutput * photoOutput )

描述

添加拍照输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
photoOutput 要添加的目标Camera_PhotoOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_AddPreviewOutput()

Camera_ErrorCode OH_CaptureSession_AddPreviewOutput (Camera_CaptureSession * session, Camera_PreviewOutput * previewOutput )

描述

添加预览输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
previewOutput 要添加的目标Camera_PreviewOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_AddVideoOutput()

Camera_ErrorCode OH_CaptureSession_AddVideoOutput (Camera_CaptureSession * session, Camera_VideoOutput * videoOutput )

描述

添加录像输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
videoOutput 要添加的目标Camera_VideoOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_BeginConfig()

Camera_ErrorCode OH_CaptureSession_BeginConfig (Camera_CaptureSession * session)

描述

开始捕获会话配置。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果会话配置已锁定返回CAMERA_SESSION_CONFIG_LOCKED。具体参考Camera_ErrorCode

OH_CaptureSession_CommitConfig()

Camera_ErrorCode OH_CaptureSession_CommitConfig (Camera_CaptureSession * session)

描述

提交捕获会话配置。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CaptureSession_GetExposureBias()

Camera_ErrorCode OH_CaptureSession_GetExposureBias (Camera_CaptureSession * session, float * exposureBias )

描述

获取当前曝光补偿。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
exposureBias 当前的曝光补偿。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetExposureBiasRange()

Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange (Camera_CaptureSession * session, float * minExposureBias, float * maxExposureBias, float * step )

描述

查询曝光补偿范围。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
minExposureBias 曝光补偿的最小值。
maxExposureBias 曝光补偿的最大值。
step 每个级别之间的曝光补偿阶梯。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetExposureMode()

Camera_ErrorCode OH_CaptureSession_GetExposureMode (Camera_CaptureSession * session, Camera_ExposureMode * exposureMode )

描述

获取当前曝光模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
exposureMode 当前的Camera_ExposureMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetFlashMode()

Camera_ErrorCode OH_CaptureSession_GetFlashMode (Camera_CaptureSession * session, Camera_FlashMode * flashMode )

描述

获取当前闪光灯模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
flashMode 当前Camera_FlashMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetFocusMode()

Camera_ErrorCode OH_CaptureSession_GetFocusMode (Camera_CaptureSession * session, Camera_FocusMode * focusMode )

描述

获取当前聚焦模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
exposureBias 当前Camera_FocusMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetFocusPoint()

Camera_ErrorCode OH_CaptureSession_GetFocusPoint (Camera_CaptureSession * session, Camera_Point * focusPoint )

描述

获取当前焦点。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
focusPoint 当前Camera_Point

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetMeteringPoint()

Camera_ErrorCode OH_CaptureSession_GetMeteringPoint (Camera_CaptureSession * session, Camera_Point * point )

描述

获取当前测量点。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
point 当前Camera_Point测量点。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetVideoStabilizationMode()

Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode (Camera_CaptureSession * session, Camera_VideoStabilizationMode * mode )

描述

获取当前录像防抖模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
mode 当前Camera_VideoStabilizationMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetZoomRatio()

Camera_ErrorCode OH_CaptureSession_GetZoomRatio (Camera_CaptureSession * session, float * zoom )

描述

获取当前缩放比例。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
zoom 当前缩放比例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_GetZoomRatioRange()

Camera_ErrorCode OH_CaptureSession_GetZoomRatioRange (Camera_CaptureSession * session, float * minZoom, float * maxZoom )

描述

获取所有支持的缩放比例范围。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
minZoom 缩放比范围的最小值。
maxZoom 缩放比例范围的最大值。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_HasFlash()

Camera_ErrorCode OH_CaptureSession_HasFlash (Camera_CaptureSession * session, bool * hasFlash )

描述

检查设备是否有闪光灯。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
hasFlash 是否支持闪光灯的结果。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_IsExposureModeSupported()

Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported (Camera_CaptureSession * session, Camera_ExposureMode exposureMode, bool * isSupported )

描述

检查是否支持指定的曝光模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
exposureMode 要检查的Camera_ExposureMode
isSupported 是否支持曝光模式的结果。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_IsFlashModeSupported()

Camera_ErrorCode OH_CaptureSession_IsFlashModeSupported (Camera_CaptureSession * session, Camera_FlashMode flashMode, bool * isSupported )

描述

检查是否支持指定的闪光灯模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
flashMode 要检查的Camera_FlashMode
isSupported 是否支持闪光灯模式的结果。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_IsFocusModeSupported()

Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported (Camera_CaptureSession * session, Camera_FocusMode focusMode, bool * isSupported )

描述

检查是否支持指定的聚焦模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
focusMode 要检查的Camera_FocusMode
isSupported 是否支持聚焦模式的结果。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_IsVideoStabilizationModeSupported()

Camera_ErrorCode OH_CaptureSession_IsVideoStabilizationModeSupported (Camera_CaptureSession * session, Camera_VideoStabilizationMode mode, bool * isSupported )

描述

检查是否支持指定的录像防抖模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
mode 要检查的Camera_VideoStabilizationMode
isSupported 是否支持录像防抖模式的结果。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_RegisterCallback()

Camera_ErrorCode OH_CaptureSession_RegisterCallback (Camera_CaptureSession * session, CaptureSession_Callbacks * callback )

描述

注册捕获会话事件回调。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
callback 要注册的CaptureSession_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_CaptureSession_Release()

Camera_ErrorCode OH_CaptureSession_Release (Camera_CaptureSession * session)

描述

释放捕获会话。

起始版本: 11

参数:

名称 描述
session 要释放的Camera_CaptureSession实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CaptureSession_RemoveInput()

Camera_ErrorCode OH_CaptureSession_RemoveInput (Camera_CaptureSession * session, Camera_Input * cameraInput )

描述

删除相机输入。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
cameraInput 要删除的目标Camera_Input

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_RemoveMetadataOutput()

Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput (Camera_CaptureSession * session, Camera_MetadataOutput * metadataOutput )

描述

删除元数据输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
metadataOutput 要删除的目标Camera_MetadataOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_RemovePhotoOutput()

Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput (Camera_CaptureSession * session, Camera_PhotoOutput * photoOutput )

描述

删除拍照输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
photoOutput 要删除的目标Camera_PhotoOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_RemovePreviewOutput()

Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput (Camera_CaptureSession * session, Camera_PreviewOutput * previewOutput )

描述

删除预览输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
previewOutput 要删除的目标Camera_PreviewOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_RemoveVideoOutput()

Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput (Camera_CaptureSession * session, Camera_VideoOutput * videoOutput )

描述

删除录像输出。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
videoOutput 要删除的目标Camera_VideoOutput

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果不允许操作返回CAMERA_OPERATION_NOT_ALLOWED。具体参考Camera_ErrorCode

OH_CaptureSession_SetExposureBias()

Camera_ErrorCode OH_CaptureSession_SetExposureBias (Camera_CaptureSession * session, float exposureBias )

描述

设置曝光补偿。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
exposureBias 要设置的目标曝光补偿。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetExposureMode()

Camera_ErrorCode OH_CaptureSession_SetExposureMode (Camera_CaptureSession * session, Camera_ExposureMode exposureMode )

描述

设置曝光模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
exposureMode 要设置的目标Camera_ExposureMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetFlashMode()

Camera_ErrorCode OH_CaptureSession_SetFlashMode (Camera_CaptureSession * session, Camera_FlashMode flashMode )

描述

设置闪光灯模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
flashMode 要设置的目标Camera_FlashMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetFocusMode()

Camera_ErrorCode OH_CaptureSession_SetFocusMode (Camera_CaptureSession * session, Camera_FocusMode focusMode )

描述

设置聚焦模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
focusMode 要设置的目标Camera_FocusMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetFocusPoint()

Camera_ErrorCode OH_CaptureSession_SetFocusPoint (Camera_CaptureSession * session, Camera_Point focusPoint )

描述

设置焦点。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
focusPoint 要设置的目标Camera_Point

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetMeteringPoint()

Camera_ErrorCode OH_CaptureSession_SetMeteringPoint (Camera_CaptureSession * session, Camera_Point point )

描述

设置计量区域的中心点。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
point 要设置的目标Camera_Point

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetVideoStabilizationMode()

Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode (Camera_CaptureSession * session, Camera_VideoStabilizationMode mode )

描述

设置录像防抖模式。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
mode 要设置的目标Camera_VideoStabilizationMode

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_SetZoomRatio()

Camera_ErrorCode OH_CaptureSession_SetZoomRatio (Camera_CaptureSession * session, float zoom )

描述

设置缩放比例。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
zoom 要设置的目标缩放比。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG。具体参考Camera_ErrorCode

OH_CaptureSession_Start()

Camera_ErrorCode OH_CaptureSession_Start (Camera_CaptureSession * session)

描述

启动捕获会话。

起始版本: 11

参数:

名称 描述
session 要启动的Camera_CaptureSession实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG; 如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CaptureSession_Stop()

Camera_ErrorCode OH_CaptureSession_Stop (Camera_CaptureSession * session)

描述

停止捕获会话。

起始版本: 11

参数:

名称 描述
session 要停止的Camera_CaptureSession实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_CaptureSession_UnregisterCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterCallback (Camera_CaptureSession * session, CaptureSession_Callbacks * callback )

描述

注销捕获会话事件回调。

起始版本: 11

参数:

名称 描述
session Camera_CaptureSession实例。
callback 要注销的CaptureSession_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_MetadataOutput_RegisterCallback()

Camera_ErrorCode OH_MetadataOutput_RegisterCallback (Camera_MetadataOutput * metadataOutput, MetadataOutput_Callbacks * callback )

描述

注册元数据输出更改事件回调。

起始版本: 11

参数:

名称 描述
metadataOutput Camera_MetadataOutput实例。
callback 要注册的MetadataOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_MetadataOutput_Release()

Camera_ErrorCode OH_MetadataOutput_Release (Camera_MetadataOutput * metadataOutput)

描述

释放元数据输出。

起始版本: 11

参数:

名称 描述
metadataOutput 要释放的Camera_MetadataOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_MetadataOutput_Start()

Camera_ErrorCode OH_MetadataOutput_Start (Camera_MetadataOutput * metadataOutput)

描述

启动元数据输出。

起始版本: 11

参数:

名称 描述
metadataOutput 要启动的Camera_MetadataOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_MetadataOutput_Stop()

Camera_ErrorCode OH_MetadataOutput_Stop (Camera_MetadataOutput * metadataOutput)

描述

停止元数据输出。

起始版本: 11

参数:

名称 描述
metadataOutput 要停止的Camera_MetadataOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_MetadataOutput_UnregisterCallback()

Camera_ErrorCode OH_MetadataOutput_UnregisterCallback (Camera_MetadataOutput * metadataOutput, MetadataOutput_Callbacks * callback )

描述

注销元数据输出更改事件回调。

起始版本: 11

参数:

名称 描述
metadataOutput Camera_MetadataOutput实例。
callback 要注销的MetadataOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_PhotoOutput_Capture()

Camera_ErrorCode OH_PhotoOutput_Capture (Camera_PhotoOutput * photoOutput)

描述

拍摄照片。

起始版本: 11

参数:

名称 描述
photoOutput 用于捕获拍照的Camera_PhotoOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PhotoOutput_Capture_WithCaptureSetting()

Camera_ErrorCode OH_PhotoOutput_Capture_WithCaptureSetting (Camera_PhotoOutput * photoOutput, Camera_PhotoCaptureSetting setting )

描述

使用捕获设置捕获拍照。

起始版本: 11

参数:

名称 描述
photoOutput 用于捕获拍照的Camera_PhotoOutput实例。
setting 用于捕获拍照的Camera_PhotoCaptureSetting

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PhotoOutput_IsMirrorSupported()

Camera_ErrorCode OH_PhotoOutput_IsMirrorSupported (Camera_PhotoOutput * photoOutput, bool * isSupported )

描述

检查是否支持镜像拍照。

起始版本: 11

参数:

名称 描述
photoOutput Camera_PhotoOutput实例,用于检查是否支持镜像。
isSupported 是否支持镜像的结果。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PhotoOutput_RegisterCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterCallback (Camera_PhotoOutput * photoOutput, PhotoOutput_Callbacks * callback )

描述

注册拍照输出更改事件回调。

起始版本: 11

参数:

名称 描述
photoOutput Camera_PhotoOutput实例。
callback 要注册的PhotoOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_PhotoOutput_Release()

Camera_ErrorCode OH_PhotoOutput_Release (Camera_PhotoOutput * photoOutput)

描述

释放拍照输出。

起始版本: 11

参数:

名称 描述
photoOutput 要释放的Camera_PhotoOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PhotoOutput_UnregisterCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterCallback (Camera_PhotoOutput * photoOutput, PhotoOutput_Callbacks * callback )

描述

注销拍照输出更改事件回调。

起始版本: 11

参数:

名称 描述
photoOutput Camera_PhotoOutput实例。
callback 要注销的PhotoOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_PreviewOutput_RegisterCallback()

Camera_ErrorCode OH_PreviewOutput_RegisterCallback (Camera_PreviewOutput * previewOutput, PreviewOutput_Callbacks * callback )

描述

注册预览输出更改事件回调。

起始版本: 11

参数:

名称 描述
previewOutput Camera_PreviewOutput实例。
callback 要注册的PreviewOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_PreviewOutput_Release()

Camera_ErrorCode OH_PreviewOutput_Release (Camera_PreviewOutput * previewOutput)

描述

释放预览输出。

起始版本: 11

参数:

名称 描述
previewOutput 要释放的Camera_PreviewOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PreviewOutput_Start()

Camera_ErrorCode OH_PreviewOutput_Start (Camera_PreviewOutput * previewOutput)

描述

开始预览输出。

起始版本: 11

参数:

名称 描述
previewOutput 要启动的Camera_PreviewOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PreviewOutput_Stop()

Camera_ErrorCode OH_PreviewOutput_Stop (Camera_PreviewOutput * previewOutput)

描述

停止预览输出。

起始版本: 11

参数:

名称 描述
previewOutput 要停止的Camera_PreviewOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_PreviewOutput_UnregisterCallback()

Camera_ErrorCode OH_PreviewOutput_UnregisterCallback (Camera_PreviewOutput * previewOutput, PreviewOutput_Callbacks * callback )

描述

注销预览输出更改事件回调。

起始版本: 11

参数:

名称 描述
previewOutput Camera_PreviewOutput实例。
callback 要注销的PreviewOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_VideoOutput_RegisterCallback()

Camera_ErrorCode OH_VideoOutput_RegisterCallback (Camera_VideoOutput * videoOutput, VideoOutput_Callbacks * callback )

描述

注册录像输出更改事件回调。

起始版本: 11

参数:

名称 描述
videoOutput Camera_VideoOutput实例。
callback 要注册的VideoOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode

OH_VideoOutput_Release()

Camera_ErrorCode OH_VideoOutput_Release (Camera_VideoOutput * videoOutput)

描述

释放录像输出。

起始版本: 11

参数:

名称 描述
videoOutput 要释放的Camera_VideoOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_VideoOutput_Start()

Camera_ErrorCode OH_VideoOutput_Start (Camera_VideoOutput * videoOutput)

描述

开始录像输出。

起始版本: 11

参数:

名称 描述
videoOutput 要启动的Camera_VideoOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果捕获会话未配置返回CAMERA_SESSION_NOT_CONFIG;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_VideoOutput_Stop()

Camera_ErrorCode OH_VideoOutput_Stop (Camera_VideoOutput * videoOutput)

描述

停止录像输出。

起始版本: 11

参数:

名称 描述
videoOutput 要停止的Camera_VideoOutput实例。

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT;如果相机服务出现致命错误返回CAMERA_SERVICE_FATAL_ERROR。具体参考Camera_ErrorCode

OH_VideoOutput_UnregisterCallback()

Camera_ErrorCode OH_VideoOutput_UnregisterCallback (Camera_VideoOutput * videoOutput, VideoOutput_Callbacks * callback )

描述

注销录像输出更改事件回调。

起始版本: 11

参数:

名称 描述
videoOutput Camera_VideoOutput实例。
callback 要注销的VideoOutput_Callbacks

返回:

如果方法调用成功返回CAMERA_OK;如果参数丢失或参数类型不正确返回INVALID_ARGUMENT。具体参考Camera_ErrorCode