harmony 鸿蒙camera_manager.h
camera_manager.h
概述
声明相机管理器的概念。
引用文件：
库： libohcamera.so
系统能力： SystemCapability.Multimedia.Camera.Core
起始版本： 11
相关模块： OH_Camera
汇总
结构体
|名称|typedef关键字|描述| |–|–|–| |CameraManager_Callbacks|CameraManager_Callbacks|相机设备状态的回调。|
函数
|名称|typedef关键字|描述| |–|–|–| |typedef void (*OH_CameraManager_StatusCallback)(Camera_Manager* cameraManager, Camera_StatusInfo* status)|OH_CameraManager_StatusCallback|在CameraManager_Callbacks中被调用的相机管理器状态回调。| |typedef void (*OH_CameraManager_TorchStatusCallback)(Camera_Manager* cameraManager, Camera_TorchStatusInfo* status)|OH_CameraManager_TorchStatusCallback|手电筒状态变化回调。| |typedef void (*OH_CameraManager_OnFoldStatusInfoChange)(Camera_Manager* cameraManager,Camera_FoldStatusInfo* foldStatusInfo)|OH_CameraManager_OnFoldStatusInfoChange|相机管理器折叠状态信息回调。| |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_RegisterTorchStatusCallback(Camera_Manager* cameraManager,OH_CameraManager_TorchStatusCallback torchStatusCallback)|-|注册手电筒状态变更事件回调。| |Camera_ErrorCode OH_CameraManager_UnregisterTorchStatusCallback(Camera_Manager* cameraManager,OH_CameraManager_TorchStatusCallback torchStatusCallback)|-|注销手电筒状态变更事件回调。| |Camera_ErrorCode OH_CameraManager_RegisterFoldStatusInfoCallback(Camera_Manager* cameraManager,OH_CameraManager_OnFoldStatusInfoChange foldStatusInfoCallback)|-|注册折叠状态信息变更事件回调。| |Camera_ErrorCode OH_CameraManager_UnregisterFoldStatusInfoCallback(Camera_Manager* cameraManager,OH_CameraManager_OnFoldStatusInfoChange foldStatusInfoCallback)|-|注销折叠状态信息变更事件回调。| |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_GetSupportedCameraOutputCapabilityWithSceneMode(Camera_Manager* cameraManager,const Camera_Device* camera, Camera_SceneMode sceneMode, 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_CreatePreviewOutputUsedInPreconfig(Camera_Manager* cameraManager,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_CreatePhotoOutputUsedInPreconfig(Camera_Manager* cameraManager,const char* surfaceId, Camera_PhotoOutput** photoOutput)|-|创建在预配置流中使用的照片输出实例。| |Camera_ErrorCode OH_CameraManager_CreatePhotoOutputWithoutSurface(Camera_Manager *cameraManager,const Camera_Profile *profile, Camera_PhotoOutput **photoOutput)|-|创建照片输出实例，调用此函数不需要surfaceId。| |Camera_ErrorCode OH_CameraManager_CreateVideoOutput(Camera_Manager* cameraManager, const Camera_VideoProfile* profile,const char* surfaceId, Camera_VideoOutput** videoOutput)|-|创建一个录像输出实例。| |Camera_ErrorCode OH_CameraManager_CreateVideoOutputUsedInPreconfig(Camera_Manager* cameraManager,const char* surfaceId, Camera_VideoOutput** videoOutput)|-|创建在预配置流中使用的视频输出实例。| |Camera_ErrorCode OH_CameraManager_CreateMetadataOutput(Camera_Manager* cameraManager,const Camera_MetadataObjectType* profile, Camera_MetadataOutput** metadataOutput)|-|创建元数据输出实例。| |Camera_ErrorCode OH_CameraManager_GetSupportedSceneModes(Camera_Device* camera,Camera_SceneMode** sceneModes, uint32_t* size)|-|获取特定相机支持的场景模式。| |Camera_ErrorCode OH_CameraManager_DeleteSceneModes(Camera_Manager* cameraManager, Camera_SceneMode* sceneModes)|-|删除场景模式。| |Camera_ErrorCode OH_CameraManager_IsTorchSupported(Camera_Manager* cameraManager,bool* isTorchSupported)|-|检查设备是否支持手电筒。| |Camera_ErrorCode OH_CameraManager_IsTorchSupportedByTorchMode(Camera_Manager* cameraManager,Camera_TorchMode torchMode, bool* isTorchSupported)|-|检查设备是否支持指定的手电筒模式。| |Camera_ErrorCode OH_CameraManager_SetTorchMode(Camera_Manager* cameraManager,Camera_TorchMode torchMode)|-|设置相机手电筒模式。| |Camera_ErrorCode OH_CameraManager_GetCameraDevice(Camera_Manager* cameraManager, Camera_Position position,Camera_Type type, Camera_Device* camera)|-|根据相机位置和相机类型查询指定的相机。| |Camera_ErrorCode OH_CameraManager_GetCameraConcurrentInfos(Camera_Manager* cameraManager, const Camera_Device* camera,uint32_t deviceSize,Camera_ConcurrentInfo** cameraConcurrentInfo,uint32_t* infoSize)|-|获取指定相机的并发信息。|
函数说明
OH_CameraManager_StatusCallback()
typedef void (*OH_CameraManager_StatusCallback)(Camera_Manager* cameraManager, Camera_StatusInfo* status)
描述
在CameraManager_Callbacks中被调用的相机管理器状态回调。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|传递回调的Camera_Manager。| |Camera_StatusInfo* status|每个相机设备的状态信息。|
OH_CameraManager_TorchStatusCallback()
typedef void (*OH_CameraManager_TorchStatusCallback)(Camera_Manager* cameraManager, Camera_TorchStatusInfo* status)
描述
手电筒状态变化回调。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|传递回调的Camera_Manager。| |Camera_TorchStatusInfo* status|手电筒的状态信息。|
OH_CameraManager_OnFoldStatusInfoChange()
typedef void (*OH_CameraManager_OnFoldStatusInfoChange)(Camera_Manager* cameraManager,Camera_FoldStatusInfo* foldStatusInfo)
描述
相机管理器折叠状态信息回调。
起始版本： 13
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|传递回调的Camera_Manager。| |Camera_FoldStatusInfo* foldStatusInfo|设备的折叠状态信息。|
OH_CameraManager_RegisterCallback()
Camera_ErrorCode OH_CameraManager_RegisterCallback(Camera_Manager* cameraManager, CameraManager_Callbacks* callback)
描述
注册相机状态更改事件回调。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |CameraManager_Callbacks* callback|要注册的相机设备状态回调。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_UnregisterCallback()
Camera_ErrorCode OH_CameraManager_UnregisterCallback(Camera_Manager* cameraManager, CameraManager_Callbacks* callback)
描述
注销相机状态更改事件回调。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |CameraManager_Callbacks* callback|要注销的相机设备状态回调。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_RegisterTorchStatusCallback()
Camera_ErrorCode OH_CameraManager_RegisterTorchStatusCallback(Camera_Manager* cameraManager,OH_CameraManager_TorchStatusCallback torchStatusCallback)
描述
注册手电筒状态变更事件回调。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |OH_CameraManager_TorchStatusCallback torchStatusCallback|要注册的手电筒状态变化回调。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_UnregisterTorchStatusCallback()
Camera_ErrorCode OH_CameraManager_UnregisterTorchStatusCallback(Camera_Manager* cameraManager,OH_CameraManager_TorchStatusCallback torchStatusCallback)
描述
注销手电筒状态变更事件回调。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |OH_CameraManager_TorchStatusCallback torchStatusCallback|要注销的手电筒状态变化回调。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_RegisterFoldStatusInfoCallback()
Camera_ErrorCode OH_CameraManager_RegisterFoldStatusInfoCallback(Camera_Manager* cameraManager,OH_CameraManager_OnFoldStatusInfoChange foldStatusInfoCallback)
描述
注册折叠状态信息变更事件回调。
起始版本： 13
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |OH_CameraManager_OnFoldStatusInfoChange foldStatusInfoCallback|要注册的折叠状态信息变更事件回调。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_UnregisterFoldStatusInfoCallback()
Camera_ErrorCode OH_CameraManager_UnregisterFoldStatusInfoCallback(Camera_Manager* cameraManager,OH_CameraManager_OnFoldStatusInfoChange foldStatusInfoCallback)
描述
注销折叠状态信息变更事件回调。
起始版本： 13
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |OH_CameraManager_OnFoldStatusInfoChange foldStatusInfoCallback|要注销的折叠状态信息变更事件回调。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_GetSupportedCameras()
Camera_ErrorCode OH_CameraManager_GetSupportedCameras(Camera_Manager* cameraManager,Camera_Device** cameras, uint32_t* size)
描述
获取支持指定的相机设备实例。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_Device** cameras|如果方法调用成功，将记录支持的Camera_Device列表。| |uint32_t* size|如果方法调用成功，将记录支持的Camera_Device列表的大小。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_DeleteSupportedCameras()
Camera_ErrorCode OH_CameraManager_DeleteSupportedCameras(Camera_Manager* cameraManager,Camera_Device* cameras, uint32_t size)
描述
删除支持的相机。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_Device* cameras|要删除的Camera_Device列表。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_GetSupportedCameraOutputCapability()
Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapability(Camera_Manager* cameraManager,const Camera_Device* camera, Camera_OutputCapability** cameraOutputCapability)
描述
查询指定相机支持的输出能力。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_Device* camera|要查询的Camera_Device。| |Camera_OutputCapability** cameraOutputCapability|如果方法调用成功，将记录支持的Camera_OutputCapability。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_GetSupportedCameraOutputCapabilityWithSceneMode()
Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapabilityWithSceneMode(Camera_Manager* cameraManager,const Camera_Device* camera, Camera_SceneMode sceneMode, Camera_OutputCapability** cameraOutputCapability)
描述
查询指定相机在指定模式下支持的输出能力。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_Device* camera|要查询的Camera_Device。| |Camera_SceneMode sceneMode|指定相机模式。| |Camera_OutputCapability** cameraOutputCapability|如果方法调用成功，将记录支持的Camera_OutputCapability列表。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_DeleteSupportedCameraOutputCapability()
Camera_ErrorCode OH_CameraManager_DeleteSupportedCameraOutputCapability(Camera_Manager* cameraManager,Camera_OutputCapability* cameraOutputCapability)
描述
删除支持的输出功能。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_OutputCapability* cameraOutputCapability|要删除的Camera_OutputCapability。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_IsCameraMuted()
Camera_ErrorCode OH_CameraManager_IsCameraMuted(Camera_Manager* cameraManager, bool* isCameraMuted)
描述
确定相机是否静音。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |bool* isCameraMuted|如果方法调用成功，将返回相机是否静音的结果。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_CreateCaptureSession()
Camera_ErrorCode OH_CameraManager_CreateCaptureSession(Camera_Manager* cameraManager,Camera_CaptureSession** captureSession)
描述
创建捕获会话实例。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_CaptureSession** captureSession|如果方法调用成功，将创建Camera_CaptureSession。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreateCameraInput()
Camera_ErrorCode OH_CameraManager_CreateCameraInput(Camera_Manager* cameraManager,const Camera_Device* camera, Camera_Input** cameraInput)
描述
创建相机输入实例。
需要权限： ohos.permission.CAMERA
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_Device* camera|用于创建Camera_Input实例的Camera_Device。| |Camera_Input** cameraInput|如果方法调用成功，将创建Camera_Input实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreateCameraInput_WithPositionAndType()
Camera_ErrorCode OH_CameraManager_CreateCameraInput_WithPositionAndType(Camera_Manager* cameraManager,Camera_Position position, Camera_Type type, Camera_Input** cameraInput)
描述
创建具有位置和类型的相机输入实例。
需要权限： ohos.permission.CAMERA
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_Position position|用于创建Camera_Input实例的相机位置。| |Camera_Type type|用于创建Camera_Input实例的相机类型。| |Camera_Input** cameraInput|如果方法调用成功，将创建Camera_Input实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreatePreviewOutput()
Camera_ErrorCode OH_CameraManager_CreatePreviewOutput(Camera_Manager* cameraManager, const Camera_Profile* profile,const char* surfaceId, Camera_PreviewOutput** previewOutput)
描述
创建预览输出实例。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_Profile* profile|用于创建Camera_PreviewOutput实例的相机流配置文件。| |const char* surfaceId|用于创建Camera_PreviewOutput实例的surfaceId。| |Camera_PreviewOutput** previewOutput|如果方法调用成功，将创建Camera_PreviewOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreatePreviewOutputUsedInPreconfig()
Camera_ErrorCode OH_CameraManager_CreatePreviewOutputUsedInPreconfig(Camera_Manager* cameraManager,const char* surfaceId, Camera_PreviewOutput** previewOutput)
描述
创建在预配置流中使用的预览输出实例。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const char* surfaceId|用于创建Camera_PreviewOutput实例的surfaceId。| |Camera_PreviewOutput** previewOutput|如果方法调用成功，将创建Camera_PreviewOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreatePhotoOutput()
Camera_ErrorCode OH_CameraManager_CreatePhotoOutput(Camera_Manager* cameraManager, const Camera_Profile* profile,const char* surfaceId, Camera_PhotoOutput** photoOutput)
描述
创建一个拍照输出实例。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_Profile* profile|用于创建Camera_PhotoOutput实例的相机流配置文件。| |const char* surfaceId|用于创建Camera_PhotoOutput实例的surfaceId。| |Camera_PhotoOutput** photoOutput|如果方法调用成功，将创建Camera_PhotoOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreatePhotoOutputUsedInPreconfig()
Camera_ErrorCode OH_CameraManager_CreatePhotoOutputUsedInPreconfig(Camera_Manager* cameraManager,const char* surfaceId, Camera_PhotoOutput** photoOutput)
描述
创建在预配置流中使用的照片输出实例。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const char* surfaceId|用于创建Camera_PhotoOutput实例的surfaceId。| |Camera_PhotoOutput** photoOutput|如果方法调用成功，将创建Camera_PhotoOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreatePhotoOutputWithoutSurface()
Camera_ErrorCode OH_CameraManager_CreatePhotoOutputWithoutSurface(Camera_Manager *cameraManager,const Camera_Profile *profile, Camera_PhotoOutput **photoOutput)
描述
创建照片输出实例，调用此函数不需要surfaceId。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager *cameraManager|相机管理器实例。| |const Camera_Profile *profile|用于创建Camera_PhotoOutput实例的相机流配置文件。| |Camera_PhotoOutput **photoOutput|如果方法调用成功，将创建Camera_PhotoOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreateVideoOutput()
Camera_ErrorCode OH_CameraManager_CreateVideoOutput(Camera_Manager* cameraManager, const Camera_VideoProfile* profile,const char* surfaceId, Camera_VideoOutput** videoOutput)
描述
创建一个录像输出实例。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_VideoProfile* profile|用于创建Camera_VideoOutput实例的录像配置文件。| |const char* surfaceId|用于创建Camera_VideoOutput实例的surfaceId。| |Camera_VideoOutput** videoOutput|如果方法调用成功，将创建Camera_VideoOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreateVideoOutputUsedInPreconfig()
Camera_ErrorCode OH_CameraManager_CreateVideoOutputUsedInPreconfig(Camera_Manager* cameraManager,const char* surfaceId, Camera_VideoOutput** videoOutput)
描述
创建在预配置流中使用的视频输出实例。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const char* surfaceId|用于创建Camera_VideoOutput实例的surfaceId。| |Camera_VideoOutput** videoOutput|如果方法调用成功，将创建Camera_VideoOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_CreateMetadataOutput()
Camera_ErrorCode OH_CameraManager_CreateMetadataOutput(Camera_Manager* cameraManager,const Camera_MetadataObjectType* profile, Camera_MetadataOutput** metadataOutput)
描述
创建元数据输出实例。
起始版本： 11
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |const Camera_MetadataObjectType* profile|用于创建Camera_MetadataOutput实例的元数据对象类型。| |Camera_MetadataOutput** metadataOutput|如果方法调用成功，将创建Camera_MetadataOutput实例。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_GetSupportedSceneModes()
Camera_ErrorCode OH_CameraManager_GetSupportedSceneModes(Camera_Device* camera,Camera_SceneMode** sceneModes, uint32_t* size)
描述
获取特定相机支持的场景模式。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Device* camera|要查询的Camera_Device。| |Camera_SceneMode** sceneModes|如果方法调用成功，将记录支持的场景模式列表。| |uint32_t* size|如果方法调用成功，将记录支持的场景模式列表大小。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_DeleteSceneModes()
Camera_ErrorCode OH_CameraManager_DeleteSceneModes(Camera_Manager* cameraManager, Camera_SceneMode* sceneModes)
描述
删除场景模式。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_SceneMode* sceneModes|要删除的场景模式列表。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_IsTorchSupported()
Camera_ErrorCode OH_CameraManager_IsTorchSupported(Camera_Manager* cameraManager,bool* isTorchSupported)
描述
检查设备是否支持手电筒。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |bool* isTorchSupported|设备是否支持手电筒。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。|
OH_CameraManager_IsTorchSupportedByTorchMode()
Camera_ErrorCode OH_CameraManager_IsTorchSupportedByTorchMode(Camera_Manager* cameraManager,Camera_TorchMode torchMode, bool* isTorchSupported)
描述
检查设备是否支持指定的手电筒模式。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_TorchMode torchMode|要检查的相机手电筒模式。| |bool* isTorchSupported|设备是否支持指定的手电筒模式。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_SetTorchMode()
Camera_ErrorCode OH_CameraManager_SetTorchMode(Camera_Manager* cameraManager,Camera_TorchMode torchMode)
描述
设置相机手电筒模式。
起始版本： 12
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_TorchMode torchMode|要设置的相机手电筒模式。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_GetCameraDevice()
Camera_ErrorCode OH_CameraManager_GetCameraDevice(Camera_Manager* cameraManager, Camera_Position position,Camera_Type type, Camera_Device* camera)
描述
根据相机位置和相机类型查询指定的相机。
起始版本： 18
参数：
|参数项|描述| |–|–| |Camera_Manager* cameraManager|相机管理器实例。| |Camera_Position position|要查询的相机位置。| |Camera_Type type|要查询的相机类型。| |Camera_Device* camera|要查询的Camera_Device。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。|
OH_CameraManager_GetCameraConcurrentInfos()
Camera_ErrorCode OH_CameraManager_GetCameraConcurrentInfos(Camera_Manager* cameraManager, const Camera_Device* camera,uint32_t deviceSize,Camera_ConcurrentInfo** cameraConcurrentInfo,uint32_t* infoSize)
描述
获取指定相机的并发信息。
起始版本： 18
参数：
|参数项|描述|
|–|–|
|Camera_Manager* cameraManager|相机管理器实例。|
|const Camera_Device* camera|用于查询的Camera_Device相机设备列表，推荐设置为包含OH_CameraManager_GetCameraDevice获取的前置与后置两个相机设备的相机设备列表。|
|uint32_t deviceSize|用于查询的相机设备列表长度, 必须设置为2（表示前置与后置两个用于并发的相机设备）。|
|Camera_ConcurrentInfo** cameraConcurrentInfo|查询到的相机并发能力数组Camera_ConcurrentInfo，作为入参应当默认设置为空。
如果相机支持并发，cameraConcurrentInfo会被赋值为查询到的相机并发能力数组Camera_ConcurrentInfo。
如果相机不支持并发，不会对cameraConcurrentInfo进行更改，并且返回错误码Camera_ErrorCode.CAMERA_SERVICE_FATAL_ERROR。|
|uint32_t* infoSize|查询到的相机并发能力数组长度，作为入参应当默认设置为0。
如果相机支持并发，infoSize会被赋值为查询到的相机并发能力数组长度。
如果相机不支持并发，不会对infoSize进行更改，并且返回错误码Camera_ErrorCode.CAMERA_SERVICE_FATAL_ERROR。|
返回：
|类型|说明|
|–|–|
|Camera_ErrorCode|CAMERA_OK：方法调用成功。
CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误，或者相机不支持并发。|
你可能感兴趣的鸿蒙文章
harmony 鸿蒙Interface (AutoDeviceSwitch)
harmony 鸿蒙Interface (AutoDeviceSwitchQuery)
harmony 鸿蒙Interface (AutoExposure)
harmony 鸿蒙Interface (AutoExposureQuery)
harmony 鸿蒙Interface (CameraInput)
harmony 鸿蒙Interface (CameraManager)
harmony 鸿蒙Interface (CameraOutput)
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦