harmony 鸿蒙capture_session.h

  • 2025-06-16
  • 浏览 (2)

capture_session.h

概述

声明捕获会话概念。

引用文件:

库: libohcamera.so

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

起始版本: 11

相关模块: OH_Camera

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |CaptureSession_Callbacks|CaptureSession_Callbacks|捕获会话的回调。| |Camera_CaptureSession|Camera_CaptureSession|捕获会话对象。
可以使用OH_CameraManager_CreateCaptureSession方法创建指针。|

函数

|名称|typedef关键字|描述| |–|–|–| |typedef void (*OH_CaptureSession_OnFocusStateChange)(Camera_CaptureSession* session, Camera_FocusState focusState)|OH_CaptureSession_OnFocusStateChange|在CaptureSession_Callbacks中被调用的捕获会话焦点状态回调。| |typedef void (*OH_CaptureSession_OnError)(Camera_CaptureSession* session, Camera_ErrorCode errorCode)|OH_CaptureSession_OnError|在CaptureSession_Callbacks中被调用的捕获会话错误回调。| |typedef void (*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* session,Camera_SmoothZoomInfo* smoothZoomInfo)|OH_CaptureSession_OnSmoothZoomInfo|拍照会话平滑变焦信息回调,触发平滑变焦后该回调会返回。| |typedef void (*OH_CaptureSession_OnAutoDeviceSwitchStatusChange)(Camera_CaptureSession* session,Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo)|OH_CaptureSession_OnAutoDeviceSwitchStatusChange|捕获会话设备切换状态回调。| |typedef void (*OH_CaptureSession_OnSystemPressureLevel)(Camera_CaptureSession* session,Camera_SystemPressureLevel* systemPressureLevel)|OH_CaptureSession_OnSystemPressureLevel|捕获系统压力状态变化回调。| |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_RegisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)|-|注册平滑变焦信息事件回调。| |Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)|-|注销平滑变焦信息事件回调。| |Camera_ErrorCode OH_CaptureSession_SetSessionMode(Camera_CaptureSession* session, Camera_SceneMode sceneMode)|-|设置会话模式。
此接口不能在OH_CaptureSession_BeginConfig之后使用。
建议在使用OH_CameraManager_CreateCaptureSession后立即使用此接口。| |Camera_ErrorCode OH_CaptureSession_AddSecureOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)|-|把其中一条PreviewOutput标记成安全输出。| |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_CaptureSession_CanAddInput(Camera_CaptureSession* session,Camera_Input* cameraInput, bool* isSuccessful)|-|确定是否可以将相机输入添加到会话中。| |Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* cameraOutput, bool* isSuccessful)|-|确定是否可以将相机预览输出添加到会话中。| |Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput(Camera_CaptureSession* session,Camera_PhotoOutput* cameraOutput, bool* isSuccessful)|-|确定是否可以将拍照输出添加到会话中。| |Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput(Camera_CaptureSession* session,Camera_VideoOutput* cameraOutput, bool* isSuccessful)|-|确定是否可以将录像输出添加到会话中。| |Camera_ErrorCode OH_CaptureSession_CanPreconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, bool* canPreconfig)|-|检查是否支持指定的预配置类型。| |Camera_ErrorCode OH_CaptureSession_CanPreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio, bool* canPreconfig)|-|检查是否支持带比例的预配置类型。| |Camera_ErrorCode OH_CaptureSession_Preconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType)|-|设置预配置类型。| |Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio)|-|设置带有比例的预配置类型。| |Camera_ErrorCode OH_CaptureSession_GetExposureValue(Camera_CaptureSession* session, float* exposureValue)|-|查询曝光值。| |Camera_ErrorCode OH_CaptureSession_GetFocalLength(Camera_CaptureSession* session, float* focalLength)|-|获取当前焦距值。| |Camera_ErrorCode OH_CaptureSession_SetSmoothZoom(Camera_CaptureSession* session,float targetZoom, Camera_SmoothZoomMode smoothZoomMode)|-|触发平滑变焦。| |Camera_ErrorCode OH_CaptureSession_GetSupportedColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace** colorSpace, uint32_t* size)|-|获取支持的色彩空间列表。| |Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace)|-|删除色彩空间列表。| |Camera_ErrorCode OH_CaptureSession_GetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace)|-|获取当前色彩空间。| |Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace colorSpace)|-|设置当前色彩空间。| |Camera_ErrorCode OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)|-|注册设备切换事件回调。| |Camera_ErrorCode OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)|-|注销设备切换事件回调。| |Camera_ErrorCode OH_CaptureSession_IsAutoDeviceSwitchSupported(Camera_CaptureSession* session, bool* isSupported)|-|检查是否支持自动设备切换。| |Camera_ErrorCode OH_CaptureSession_EnableAutoDeviceSwitch(Camera_CaptureSession* session, bool enabled)|-|是否启用相机设备的自动切换。| |Camera_ErrorCode OH_CaptureSession_RegisterSystemPressureLevelCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevel systemPressureLevel)|-|注册系统压力状态回调。| |Camera_ErrorCode OH_CaptureSession_UnregisterSystemPressureLevelCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevel systemPressureLevel)|-|注销系统压力状态回调。| |Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization(Camera_CaptureSession* session, Camera_QualityPrioritization qualityPrioritization)|-|设置录像质量优先级。
默认为高质量,设置为功耗平衡将降低录像质量以减少功耗。实际功耗收益因平台而异。| |Camera_ErrorCode OH_CaptureSession_IsMacroSupported(Camera_CaptureSession* session, bool* isSupported)|-|检查是否支持微距能力。| |Camera_ErrorCode OH_CaptureSession_EnableMacro(Camera_CaptureSession* session, bool enabled)|-|是否启用相机设备的微距能力。| |Camera_ErrorCode OH_CaptureSession_SetWhiteBalance(Camera_CaptureSession* session, int32_t colorTemperature)|-|设置白平衡的色温。
设置前,建议通过OH_CaptureSession_GetWhiteBalanceRange获取支持配置的白平衡色温范围。| |Camera_ErrorCode OH_CaptureSession_GetWhiteBalance(Camera_CaptureSession* session, int32_t *colorTemperature)|-|获取当前白平衡色温值。| |Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode* whiteBalanceMode)|-|获取当前的白平衡模式。| |Camera_ErrorCode OH_CaptureSession_IsWhiteBalanceModeSupported(Camera_CaptureSession* session,Camera_WhiteBalanceMode whiteBalanceMode, bool* isSupported)|-|检查是否支持指定的白平衡模式。| |Camera_ErrorCode OH_CaptureSession_SetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode whiteBalanceMode)|-|设置白平衡模式。| |Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceRange(Camera_CaptureSession* session, int32_t *minColorTemperature, int32_t *maxColorTemperature)|-|获取支持配置的白平衡色温范围。|

函数说明

OH_CaptureSession_OnFocusStateChange()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |Camera_FocusState focusState|回调传递的会话焦点状态。|

OH_CaptureSession_OnError()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |Camera_ErrorCode errorCode|捕获会话的错误码。|

参考:

CAMERA_SERVICE_FATAL_ERROR

OH_CaptureSession_OnSmoothZoomInfo()

typedef void (*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* session,Camera_SmoothZoomInfo* smoothZoomInfo)

描述

拍照会话平滑变焦信息回调,触发平滑变焦后该回调会返回。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |Camera_SmoothZoomInfo* smoothZoomInfo|回调传递的平滑变焦参数信息。|

OH_CaptureSession_OnAutoDeviceSwitchStatusChange()

typedef void (*OH_CaptureSession_OnAutoDeviceSwitchStatusChange)(Camera_CaptureSession* session,Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo)

描述

捕获会话设备切换状态回调。

起始版本: 13

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo|回调传递的设备切换状态信息。|

OH_CaptureSession_OnSystemPressureLevel()

typedef void (*OH_CaptureSession_OnSystemPressureLevel)(Camera_CaptureSession* session,Camera_SystemPressureLevel* systemPressureLevel)

描述

捕获系统压力状态变化回调。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |Camera_SystemPressureLevel* systemPressureLevel|回调传递的系统压力等级。|

OH_CaptureSession_RegisterCallback()

Camera_ErrorCode OH_CaptureSession_RegisterCallback(Camera_CaptureSession* session,CaptureSession_Callbacks* callback)

描述

注册捕获会话事件回调。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |CaptureSession_Callbacks* callback|要注册的捕获会话事件回调。|

返回:

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

OH_CaptureSession_UnregisterCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterCallback(Camera_CaptureSession* session,CaptureSession_Callbacks* callback)

描述

注销捕获会话事件回调。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |CaptureSession_Callbacks* callback|要注销的捕获会话事件回调。|

返回:

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

OH_CaptureSession_RegisterSmoothZoomInfoCallback()

Camera_ErrorCode OH_CaptureSession_RegisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)

描述

注册平滑变焦信息事件回调。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback|要注册的平滑变焦信息事件回调。|

返回:

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

OH_CaptureSession_UnregisterSmoothZoomInfoCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)

描述

注销平滑变焦信息事件回调。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback|要注销的平滑变焦信息事件回调。|

返回:

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

OH_CaptureSession_SetSessionMode()

Camera_ErrorCode OH_CaptureSession_SetSessionMode(Camera_CaptureSession* session, Camera_SceneMode sceneMode)

描述

设置会话模式。
此接口不能在OH_CaptureSession_BeginConfig之后使用。
建议在使用OH_CameraManager_CreateCaptureSession后立即使用此接口。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_SceneMode sceneMode|相机模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。
CAMERA_SESSION_CONFIG_LOCKED:会话配置已锁定。|

OH_CaptureSession_AddSecureOutput()

Camera_ErrorCode OH_CaptureSession_AddSecureOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)

描述

把其中一条PreviewOutput标记成安全输出。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreviewOutput* previewOutput|要标记为安全输出的Camera_PreviewOutput。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。
CAMERA_SESSION_CONFIG_LOCKED:会话配置已锁定。|

OH_CaptureSession_BeginConfig()

Camera_ErrorCode OH_CaptureSession_BeginConfig(Camera_CaptureSession* session)

描述

开始捕获会话配置。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_CONFIG_LOCKED:会话配置已锁定。|

OH_CaptureSession_CommitConfig()

Camera_ErrorCode OH_CaptureSession_CommitConfig(Camera_CaptureSession* session)

描述

提交捕获会话配置。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。|

返回:

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

OH_CaptureSession_AddInput()

Camera_ErrorCode OH_CaptureSession_AddInput(Camera_CaptureSession* session, Camera_Input* cameraInput)

描述

添加相机输入。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Input* cameraInput|要添加的相机输入实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_RemoveInput()

Camera_ErrorCode OH_CaptureSession_RemoveInput(Camera_CaptureSession* session, Camera_Input* cameraInput)

描述

删除相机输入。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Input* cameraInput|要删除的相机输入实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_AddPreviewOutput()

Camera_ErrorCode OH_CaptureSession_AddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* previewOutput)

描述

添加预览输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreviewOutput* previewOutput|要添加的预览输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_RemovePreviewOutput()

Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* previewOutput)

描述

删除预览输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreviewOutput* previewOutput|要删除的预览输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_AddPhotoOutput()

Camera_ErrorCode OH_CaptureSession_AddPhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput)

描述

添加拍照输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PhotoOutput* photoOutput|要添加的拍照输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_RemovePhotoOutput()

Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput)

描述

删除拍照输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PhotoOutput* photoOutput|要删除的拍照输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_AddVideoOutput()

Camera_ErrorCode OH_CaptureSession_AddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)

描述

添加录像输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_VideoOutput* videoOutput|要添加的录像输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_RemoveVideoOutput()

Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)

描述

删除录像输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_VideoOutput* videoOutput|要删除的录像输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_AddMetadataOutput()

Camera_ErrorCode OH_CaptureSession_AddMetadataOutput(Camera_CaptureSession* session,Camera_MetadataOutput* metadataOutput)

描述

添加元数据输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_MetadataOutput* metadataOutput|要添加的元数据输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_RemoveMetadataOutput()

Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput(Camera_CaptureSession* session,Camera_MetadataOutput* metadataOutput)

描述

删除元数据输出。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_MetadataOutput* metadataOutput|要删除的元数据输出实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED:操作不允许。|

OH_CaptureSession_Start()

Camera_ErrorCode OH_CaptureSession_Start(Camera_CaptureSession* session)

描述

启动捕获会话。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|要启动的Camera_CaptureSession实例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。
CAMERA_SERVICE_FATAL_ERROR:相机服务出现致命错误。|

OH_CaptureSession_Stop()

Camera_ErrorCode OH_CaptureSession_Stop(Camera_CaptureSession* session)

描述

停止捕获会话。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|要停止的Camera_CaptureSession实例。|

返回:

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

OH_CaptureSession_Release()

Camera_ErrorCode OH_CaptureSession_Release(Camera_CaptureSession* session)

描述

释放捕获会话。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|要释放的Camera_CaptureSession实例。|

返回:

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

OH_CaptureSession_HasFlash()

Camera_ErrorCode OH_CaptureSession_HasFlash(Camera_CaptureSession* session, bool* hasFlash)

描述

检查设备是否有闪光灯。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |bool* hasFlash|是否支持闪光灯的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_IsFlashModeSupported()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_FlashMode flashMode|要检查的闪光灯模式。| |bool* isSupported|是否支持闪光灯模式的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetFlashMode()

Camera_ErrorCode OH_CaptureSession_GetFlashMode(Camera_CaptureSession* session, Camera_FlashMode* flashMode)

描述

获取当前闪光灯模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_FlashMode* flashMode|当前闪光灯模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetFlashMode()

Camera_ErrorCode OH_CaptureSession_SetFlashMode(Camera_CaptureSession* session, Camera_FlashMode flashMode)

描述

设置闪光灯模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_FlashMode flashMode|要设置的闪光灯模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_IsExposureModeSupported()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_ExposureMode exposureMode|要检查的曝光模式。| |bool* isSupported|是否支持曝光模式的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetExposureMode()

Camera_ErrorCode OH_CaptureSession_GetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode* exposureMode)

描述

获取当前曝光模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_ExposureMode* exposureMode|当前的曝光模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetExposureMode()

Camera_ErrorCode OH_CaptureSession_SetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode exposureMode)

描述

设置曝光模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_ExposureMode exposureMode|要设置的曝光模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetMeteringPoint()

Camera_ErrorCode OH_CaptureSession_GetMeteringPoint(Camera_CaptureSession* session, Camera_Point* point)

描述

获取当前测量点。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Point* point|当前测量点。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetMeteringPoint()

Camera_ErrorCode OH_CaptureSession_SetMeteringPoint(Camera_CaptureSession* session, Camera_Point point)

描述

设置计量区域的中心点。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Point point|要设置的测量点。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetExposureBiasRange()

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

描述

查询曝光补偿范围。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float* minExposureBias|曝光补偿的最小值。| |float* maxExposureBias|曝光补偿的最大值。| |float* step|每个级别之间的曝光补偿阶梯。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetExposureBias()

Camera_ErrorCode OH_CaptureSession_SetExposureBias(Camera_CaptureSession* session, float exposureBias)

描述

设置曝光补偿。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float exposureBias|要设置的曝光补偿。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetExposureBias()

Camera_ErrorCode OH_CaptureSession_GetExposureBias(Camera_CaptureSession* session, float* exposureBias)

描述

获取当前曝光补偿。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float* exposureBias|当前的曝光补偿。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_IsFocusModeSupported()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_FocusMode focusMode|要检查的聚焦模式。| |bool* isSupported|是否支持聚焦模式的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetFocusMode()

Camera_ErrorCode OH_CaptureSession_GetFocusMode(Camera_CaptureSession* session, Camera_FocusMode* focusMode)

描述

获取当前聚焦模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_FocusMode* focusMode|当前聚焦模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetFocusMode()

Camera_ErrorCode OH_CaptureSession_SetFocusMode(Camera_CaptureSession* session, Camera_FocusMode focusMode)

描述

设置聚焦模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_FocusMode focusMode|要设置的聚焦模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetFocusPoint()

Camera_ErrorCode OH_CaptureSession_GetFocusPoint(Camera_CaptureSession* session, Camera_Point* focusPoint)

描述

获取当前焦点。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Point* focusPoint|当前焦点。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetFocusPoint()

Camera_ErrorCode OH_CaptureSession_SetFocusPoint(Camera_CaptureSession* session, Camera_Point focusPoint)

描述

设置焦点。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Point focusPoint|要设置的目标点。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetZoomRatioRange()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float* minZoom|缩放比范围的最小值。| |float* maxZoom|缩放比例范围的最大值。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetZoomRatio()

Camera_ErrorCode OH_CaptureSession_GetZoomRatio(Camera_CaptureSession* session, float* zoom)

描述

获取当前缩放比例。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float* zoom|当前缩放比例。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetZoomRatio()

Camera_ErrorCode OH_CaptureSession_SetZoomRatio(Camera_CaptureSession* session, float zoom)

描述

设置缩放比例。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float zoom|要设置的目标缩放比。
设置可变焦距比到底层生效需要一定时间,获取正确设置的可变焦距比需要等待1~2帧的时间。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_IsVideoStabilizationModeSupported()

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

描述

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

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_VideoStabilizationMode mode|要检查的录像防抖模式。| |bool* isSupported|是否支持录像防抖模式的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetVideoStabilizationMode()

Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode(Camera_CaptureSession* session,Camera_VideoStabilizationMode* mode)

描述

获取当前录像防抖模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_VideoStabilizationMode* mode|当前录像防抖模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetVideoStabilizationMode()

Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode(Camera_CaptureSession* session,Camera_VideoStabilizationMode mode)

描述

设置录像防抖模式。

起始版本: 11

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_VideoStabilizationMode mode|要设置的录像防抖模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_CanAddInput()

Camera_ErrorCode OH_CaptureSession_CanAddInput(Camera_CaptureSession* session,Camera_Input* cameraInput, bool* isSuccessful)

描述

确定是否可以将相机输入添加到会话中。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_Input* cameraInput|要设置的相机输入实例。| |bool* isSuccessful|是否可以将相机输入添加到会话中的结果。|

返回:

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

OH_CaptureSession_CanAddPreviewOutput()

Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* cameraOutput, bool* isSuccessful)

描述

确定是否可以将相机预览输出添加到会话中。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreviewOutput* cameraOutput|要设置的预览输出实例。| |bool* isSuccessful|是否可以将相机预览输出添加到会话中的结果。|

返回:

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

OH_CaptureSession_CanAddPhotoOutput()

Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput(Camera_CaptureSession* session,Camera_PhotoOutput* cameraOutput, bool* isSuccessful)

描述

确定是否可以将拍照输出添加到会话中。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PhotoOutput* cameraOutput|要设置的拍照输出实例。| |bool* isSuccessful|拍照输出是否可以添加到会话中的结果。|

返回:

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

OH_CaptureSession_CanAddVideoOutput()

Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput(Camera_CaptureSession* session,Camera_VideoOutput* cameraOutput, bool* isSuccessful)

描述

确定是否可以将录像输出添加到会话中。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_VideoOutput* cameraOutput|要添加的录像输出实例。| |bool* isSuccessful|录像输出是否可以添加到会话中的结果。|

返回:

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

OH_CaptureSession_CanPreconfig()

Camera_ErrorCode OH_CaptureSession_CanPreconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, bool* canPreconfig)

描述

检查是否支持指定的预配置类型。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreconfigType preconfigType|要检查的预配置类型。| |bool* canPreconfig|是否支持预配置的结果。|

返回:

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

OH_CaptureSession_CanPreconfigWithRatio()

Camera_ErrorCode OH_CaptureSession_CanPreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio, bool* canPreconfig)

描述

检查是否支持带比例的预配置类型。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreconfigType preconfigType|要检查的预配置类型。| |Camera_PreconfigRatio preconfigRatio|要检查的预配置比例。| |bool* canPreconfig|是否支持预配置的结果。|

返回:

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

OH_CaptureSession_Preconfig()

Camera_ErrorCode OH_CaptureSession_Preconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType)

描述

设置预配置类型。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreconfigType preconfigType|指定的预配置类型。|

返回:

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

OH_CaptureSession_PreconfigWithRatio()

Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio)

描述

设置带有比例的预配置类型。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_PreconfigType preconfigType|指定的预配置类型。| |Camera_PreconfigRatio preconfigRatio|指定的预配置比例。|

返回:

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

OH_CaptureSession_GetExposureValue()

Camera_ErrorCode OH_CaptureSession_GetExposureValue(Camera_CaptureSession* session, float* exposureValue)

描述

查询曝光值。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float* exposureValue|当前的曝光值。|

返回:

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

OH_CaptureSession_GetFocalLength()

Camera_ErrorCode OH_CaptureSession_GetFocalLength(Camera_CaptureSession* session, float* focalLength)

描述

获取当前焦距值。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float* focalLength|当前焦距值。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetSmoothZoom()

Camera_ErrorCode OH_CaptureSession_SetSmoothZoom(Camera_CaptureSession* session,float targetZoom, Camera_SmoothZoomMode smoothZoomMode)

描述

触发平滑变焦。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |float targetZoom|要设置的目标变焦比。| |Camera_SmoothZoomMode smoothZoomMode|平滑变焦模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_GetSupportedColorSpaces()

Camera_ErrorCode OH_CaptureSession_GetSupportedColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace** colorSpace, uint32_t* size)

描述

获取支持的色彩空间列表。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |OH_NativeBuffer_ColorSpace** colorSpace|如果方法调用成功,将记录支持的OH_NativeBuffer_ColorSpace列表。| |uint32_t* size|如果方法调用成功,将记录支持的OH_NativeBuffer_ColorSpace列表的大小。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_DeleteColorSpaces()

Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace)

描述

删除色彩空间列表。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |OH_NativeBuffer_ColorSpace* colorSpace|如果方法调用成功,将删除的OH_NativeBuffer_ColorSpace列表。|

返回:

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

OH_CaptureSession_GetActiveColorSpace()

Camera_ErrorCode OH_CaptureSession_GetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace)

描述

获取当前色彩空间。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |OH_NativeBuffer_ColorSpace* colorSpace|当前的OH_NativeBuffer_ColorSpace。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_SetActiveColorSpace()

Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace colorSpace)

描述

设置当前色彩空间。

起始版本: 12

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |OH_NativeBuffer_ColorSpace colorSpace|要设置的目标OH_NativeBuffer_ColorSpace。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback()

Camera_ErrorCode OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)

描述

注册设备切换事件回调。

起始版本: 13

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange|要注册的设备切换事件回调。|

返回:

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

OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)

描述

注销设备切换事件回调。

起始版本: 13

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange|要注销的设备切换事件回调。|

返回:

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

OH_CaptureSession_IsAutoDeviceSwitchSupported()

Camera_ErrorCode OH_CaptureSession_IsAutoDeviceSwitchSupported(Camera_CaptureSession* session, bool* isSupported)

描述

检查是否支持自动设备切换。

起始版本: 13

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |bool* isSupported|是否支持自动设备切换的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_EnableAutoDeviceSwitch()

Camera_ErrorCode OH_CaptureSession_EnableAutoDeviceSwitch(Camera_CaptureSession* session, bool enabled)

描述

是否启用相机设备的自动切换。

起始版本: 13

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |bool enabled|是否启用自动切换的标志。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。
CAMERA_SERVICE_FATAL_ERROR:相机服务出现致命错误。|

OH_CaptureSession_RegisterSystemPressureLevelCallback()

Camera_ErrorCode OH_CaptureSession_RegisterSystemPressureLevelCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevel systemPressureLevel)

描述

注册系统压力状态回调。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |OH_CaptureSession_OnSystemPressureLevel systemPressureLevel|要注册的系统压力状态回调。|

返回:

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

OH_CaptureSession_UnregisterSystemPressureLevelCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterSystemPressureLevelCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevel systemPressureLevel)

描述

注销系统压力状态回调。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|传递回调的Camera_CaptureSession实例。| |OH_CaptureSession_OnSystemPressureLevel systemPressureLevel|要注销的系统压力状态回调。|

返回:

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

OH_CaptureSession_SetQualityPrioritization()

Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization(Camera_CaptureSession* session, Camera_QualityPrioritization qualityPrioritization)

描述

设置录像质量优先级。
默认为高质量,设置为功耗平衡将降低录像质量以减少功耗。实际功耗收益因平台而异。

起始版本: 14

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_QualityPrioritization qualityPrioritization|要设置的录像质量优先级,默认为高质量。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_IsMacroSupported()

Camera_ErrorCode OH_CaptureSession_IsMacroSupported(Camera_CaptureSession* session, bool* isSupported)

描述

检查是否支持微距能力。

起始版本: 19

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |bool* isSupported|是否支持微距能力的结果。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|
CAMERA_OK = 0:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。|

OH_CaptureSession_EnableMacro()

Camera_ErrorCode OH_CaptureSession_EnableMacro(Camera_CaptureSession* session, bool enabled)

描述

是否启用相机设备的微距能力。

起始版本: 19

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |bool enabled|是否启用微距能力的标志。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|
CAMERA_OK = 0:方法调用成功。
CAMERA_INVALID_ARGUMENT:参数丢失或参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:捕获会话未配置。
CAMERA_OPERATION_NOT_ALLOWED:不允许操作。|

OH_CaptureSession_SetWhiteBalance()

Camera_ErrorCode OH_CaptureSession_SetWhiteBalance(Camera_CaptureSession* session, int32_t colorTemperature)

描述

设置白平衡的色温。
设置前,建议通过OH_CaptureSession_GetWhiteBalanceRange获取支持配置的白平衡色温范围。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |int32_t colorTemperature|色温值,单位为K。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:设置成功。
CAMERA_INVALID_ARGUMENT:参数缺失或者参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:相机会话未配置。|

OH_CaptureSession_GetWhiteBalance()

Camera_ErrorCode OH_CaptureSession_GetWhiteBalance(Camera_CaptureSession* session, int32_t *colorTemperature)

描述

获取当前白平衡色温值。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |int32_t *colorTemperature|色温值,单位为K。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:函数调用成功。
CAMERA_INVALID_ARGUMENT:参数缺失或者参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:相机会话未配置。|

OH_CaptureSession_GetWhiteBalanceMode()

Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode* whiteBalanceMode)

描述

获取当前的白平衡模式。

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_WhiteBalanceMode* whiteBalanceMode|白平衡模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:函数调用成功。
CAMERA_INVALID_ARGUMENT:参数缺失或者参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:相机会话未配置。|

OH_CaptureSession_IsWhiteBalanceModeSupported()

Camera_ErrorCode OH_CaptureSession_IsWhiteBalanceModeSupported(Camera_CaptureSession* session,Camera_WhiteBalanceMode whiteBalanceMode, bool* isSupported)

描述

检查是否支持指定的白平衡模式。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_WhiteBalanceMode whiteBalanceMode|指定的白平衡模式。| |bool* isSupported|用于返回是否支持指定的白平衡模式,支持返回true,否则返回false。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:函数调用成功。
CAMERA_INVALID_ARGUMENT:参数缺失或者参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:相机会话未配置。|

OH_CaptureSession_SetWhiteBalanceMode()

Camera_ErrorCode OH_CaptureSession_SetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode whiteBalanceMode)

描述

设置白平衡模式。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |Camera_WhiteBalanceMode whiteBalanceMode|白平衡模式。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:设置成功。
CAMERA_INVALID_ARGUMENT:参数缺失或者参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:相机会话未配置。|

OH_CaptureSession_GetWhiteBalanceRange()

Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceRange(Camera_CaptureSession* session, int32_t *minColorTemperature, int32_t *maxColorTemperature)

描述

获取支持配置的白平衡色温范围。

起始版本: 20

参数:

|参数项|描述| |–|–| |Camera_CaptureSession* session|Camera_CaptureSession实例。| |int32_t *minColorTemperature|支持的最小色温值,单位为K。| |int32_t *maxColorTemperature|支持的最大色温值,单位为K。|

返回:

|类型|说明| |–|–| |Camera_ErrorCode|CAMERA_OK:函数调用成功。
CAMERA_INVALID_ARGUMENT:参数缺失或者参数类型不正确。
CAMERA_SESSION_NOT_CONFIG:相机会话未配置。|

你可能感兴趣的鸿蒙文章

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)

0  赞