1# capture_session.h 2<!--Kit: Camera Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @qano--> 5<!--Designer: @leo_ysl--> 6<!--Tester: @xchaosioda--> 7<!--Adviser: @zengyawen--> 8 9## 概述 10 11声明捕获会话概念。 12 13**引用文件：** <ohcamera/capture_session.h> 14 15**库：** libohcamera.so 16 17**系统能力：** SystemCapability.Multimedia.Camera.Core 18 19**起始版本：** 11 20 21**相关模块：** [OH_Camera](capi-oh-camera.md) 22 23## 汇总 24 25### 结构体 26 27| 名称 | typedef关键字 | 描述 | 28| -- | -- | -- | 29| [CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md) | CaptureSession_Callbacks | 捕获会话的回调。 | 30| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md) | Camera_CaptureSession | 捕获会话对象。<br> 可以使用[OH_CameraManager_CreateCaptureSession](capi-camera-manager-h.md#oh_cameramanager_createcapturesession)方法创建指针。 | 31 32### 函数 33 34| 名称 | typedef关键字 | 描述 | 35| -- | -- | -- | 36| [typedef void (\*OH_CaptureSession_OnFocusStateChange)(Camera_CaptureSession* session, Camera_FocusState focusState)](#oh_capturesession_onfocusstatechange) | OH_CaptureSession_OnFocusStateChange | 在[CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md)中被调用的捕获会话焦点状态回调。 | 37| [typedef void (\*OH_CaptureSession_OnError)(Camera_CaptureSession* session, Camera_ErrorCode errorCode)](#oh_capturesession_onerror) | OH_CaptureSession_OnError | 在[CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md)中被调用的捕获会话错误回调。 | 38| [typedef void (\*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* session,Camera_SmoothZoomInfo* smoothZoomInfo)](#oh_capturesession_onsmoothzoominfo) | OH_CaptureSession_OnSmoothZoomInfo | 拍照会话平滑变焦信息回调，触发平滑变焦后该回调会返回。 | 39| [typedef void (\*OH_CaptureSession_OnAutoDeviceSwitchStatusChange)(Camera_CaptureSession* session,Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo)](#oh_capturesession_onautodeviceswitchstatuschange) | OH_CaptureSession_OnAutoDeviceSwitchStatusChange | 捕获会话设备切换状态回调。 | 40| [typedef void (\*OH_CaptureSession_OnSystemPressureLevelChange)(Camera_CaptureSession* session,Camera_SystemPressureLevel systemPressureLevel)](#oh_capturesession_onsystempressurelevelchange) | OH_CaptureSession_OnSystemPressureLevelChange | 捕获系统压力状态变化回调。 | 41| [typedef void (\*OH_CaptureSession_OnControlCenterEffectStatusChange)(Camera_CaptureSession* session,Camera_ControlCenterStatusInfo* controlCenterStatusInfo)](#oh_capturesession_oncontrolcentereffectstatuschange) | OH_CaptureSession_OnControlCenterEffectStatusChange | 相机控制器效果激活状态变化回调。 | 42| [Camera_ErrorCode OH_CaptureSession_RegisterCallback(Camera_CaptureSession* session,CaptureSession_Callbacks* callback)](#oh_capturesession_registercallback) | - | 注册捕获会话事件回调。 | 43| [Camera_ErrorCode OH_CaptureSession_UnregisterCallback(Camera_CaptureSession* session,CaptureSession_Callbacks* callback)](#oh_capturesession_unregistercallback) | - | 注销捕获会话事件回调。 | 44| [Camera_ErrorCode OH_CaptureSession_RegisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)](#oh_capturesession_registersmoothzoominfocallback) | - | 注册平滑变焦信息事件回调。 | 45| [Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)](#oh_capturesession_unregistersmoothzoominfocallback) | - | 注销平滑变焦信息事件回调。 | 46| [Camera_ErrorCode OH_CaptureSession_SetSessionMode(Camera_CaptureSession* session, Camera_SceneMode sceneMode)](#oh_capturesession_setsessionmode) | - | 设置会话模式。<br> 此接口不能在[OH_CaptureSession_BeginConfig](#oh_capturesession_beginconfig)之后使用。<br> 建议在使用[OH_CameraManager_CreateCaptureSession](capi-camera-manager-h.md#oh_cameramanager_createcapturesession)后立即使用此接口。 | 47| [Camera_ErrorCode OH_CaptureSession_AddSecureOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)](#oh_capturesession_addsecureoutput) | - | 把其中一条PreviewOutput标记成安全输出。 | 48| [Camera_ErrorCode OH_CaptureSession_BeginConfig(Camera_CaptureSession* session)](#oh_capturesession_beginconfig) | - | 开始捕获会话配置。 | 49| [Camera_ErrorCode OH_CaptureSession_CommitConfig(Camera_CaptureSession* session)](#oh_capturesession_commitconfig) | - | 提交捕获会话配置。 | 50| [Camera_ErrorCode OH_CaptureSession_AddInput(Camera_CaptureSession* session, Camera_Input* cameraInput)](#oh_capturesession_addinput) | - | 添加相机输入。 | 51| [Camera_ErrorCode OH_CaptureSession_RemoveInput(Camera_CaptureSession* session, Camera_Input* cameraInput)](#oh_capturesession_removeinput) | - | 删除相机输入。 | 52| [Camera_ErrorCode OH_CaptureSession_AddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* previewOutput)](#oh_capturesession_addpreviewoutput) | - | 添加预览输出。 | 53| [Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* previewOutput)](#oh_capturesession_removepreviewoutput) | - | 删除预览输出。 | 54| [Camera_ErrorCode OH_CaptureSession_AddPhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput)](#oh_capturesession_addphotooutput) | - | 添加拍照输出。 | 55| [Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput)](#oh_capturesession_removephotooutput) | - | 删除拍照输出。 | 56| [Camera_ErrorCode OH_CaptureSession_AddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)](#oh_capturesession_addvideooutput) | - | 添加录像输出。 | 57| [Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)](#oh_capturesession_removevideooutput) | - | 删除录像输出。 | 58| [Camera_ErrorCode OH_CaptureSession_AddMetadataOutput(Camera_CaptureSession* session,Camera_MetadataOutput* metadataOutput)](#oh_capturesession_addmetadataoutput) | - | 添加元数据输出。 | 59| [Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput(Camera_CaptureSession* session,Camera_MetadataOutput* metadataOutput)](#oh_capturesession_removemetadataoutput) | - | 删除元数据输出。 | 60| [Camera_ErrorCode OH_CaptureSession_Start(Camera_CaptureSession* session)](#oh_capturesession_start) | - | 启动捕获会话。 | 61| [Camera_ErrorCode OH_CaptureSession_Stop(Camera_CaptureSession* session)](#oh_capturesession_stop) | - | 停止捕获会话。 | 62| [Camera_ErrorCode OH_CaptureSession_Release(Camera_CaptureSession* session)](#oh_capturesession_release) | - | 释放捕获会话。 | 63| [Camera_ErrorCode OH_CaptureSession_HasFlash(Camera_CaptureSession* session, bool* hasFlash)](#oh_capturesession_hasflash) | - | 检查设备是否有闪光灯。 | 64| [Camera_ErrorCode OH_CaptureSession_IsFlashModeSupported(Camera_CaptureSession* session,Camera_FlashMode flashMode, bool* isSupported)](#oh_capturesession_isflashmodesupported) | - | 检查是否支持指定的闪光灯模式。 | 65| [Camera_ErrorCode OH_CaptureSession_GetFlashMode(Camera_CaptureSession* session, Camera_FlashMode* flashMode)](#oh_capturesession_getflashmode) | - | 获取当前闪光灯模式。 | 66| [Camera_ErrorCode OH_CaptureSession_SetFlashMode(Camera_CaptureSession* session, Camera_FlashMode flashMode)](#oh_capturesession_setflashmode) | - | 设置闪光灯模式。 | 67| [Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported(Camera_CaptureSession* session,Camera_ExposureMode exposureMode, bool* isSupported)](#oh_capturesession_isexposuremodesupported) | - | 检查是否支持指定的曝光模式。 | 68| [Camera_ErrorCode OH_CaptureSession_GetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode* exposureMode)](#oh_capturesession_getexposuremode) | - | 获取当前曝光模式。 | 69| [Camera_ErrorCode OH_CaptureSession_SetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode exposureMode)](#oh_capturesession_setexposuremode) | - | 设置曝光模式。 | 70| [Camera_ErrorCode OH_CaptureSession_GetMeteringPoint(Camera_CaptureSession* session, Camera_Point* point)](#oh_capturesession_getmeteringpoint) | - | 获取当前测量点。 | 71| [Camera_ErrorCode OH_CaptureSession_SetMeteringPoint(Camera_CaptureSession* session, Camera_Point point)](#oh_capturesession_setmeteringpoint) | - | 设置计量区域的中心点。 | 72| [Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange(Camera_CaptureSession* session, float* minExposureBias,float* maxExposureBias, float* step)](#oh_capturesession_getexposurebiasrange) | - | 查询曝光补偿范围。 | 73| [Camera_ErrorCode OH_CaptureSession_SetExposureBias(Camera_CaptureSession* session, float exposureBias)](#oh_capturesession_setexposurebias) | - | 设置曝光补偿。 | 74| [Camera_ErrorCode OH_CaptureSession_GetExposureBias(Camera_CaptureSession* session, float* exposureBias)](#oh_capturesession_getexposurebias) | - | 获取当前曝光补偿。 | 75| [Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported(Camera_CaptureSession* session,Camera_FocusMode focusMode, bool* isSupported)](#oh_capturesession_isfocusmodesupported) | - | 检查是否支持指定的聚焦模式。 | 76| [Camera_ErrorCode OH_CaptureSession_GetFocusMode(Camera_CaptureSession* session, Camera_FocusMode* focusMode)](#oh_capturesession_getfocusmode) | - | 获取当前聚焦模式。 | 77| [Camera_ErrorCode OH_CaptureSession_SetFocusMode(Camera_CaptureSession* session, Camera_FocusMode focusMode)](#oh_capturesession_setfocusmode) | - | 设置聚焦模式。 | 78| [Camera_ErrorCode OH_CaptureSession_GetFocusPoint(Camera_CaptureSession* session, Camera_Point* focusPoint)](#oh_capturesession_getfocuspoint) | - | 获取当前焦点。 | 79| [Camera_ErrorCode OH_CaptureSession_SetFocusPoint(Camera_CaptureSession* session, Camera_Point focusPoint)](#oh_capturesession_setfocuspoint) | - | 设置焦点。 | 80| [Camera_ErrorCode OH_CaptureSession_GetZoomRatioRange(Camera_CaptureSession* session, float* minZoom, float* maxZoom)](#oh_capturesession_getzoomratiorange) | - | 获取所有支持的缩放比例范围。 | 81| [Camera_ErrorCode OH_CaptureSession_GetZoomRatio(Camera_CaptureSession* session, float* zoom)](#oh_capturesession_getzoomratio) | - | 获取当前缩放比例。 | 82| [Camera_ErrorCode OH_CaptureSession_SetZoomRatio(Camera_CaptureSession* session, float zoom)](#oh_capturesession_setzoomratio) | - | 设置缩放比例。 | 83| [Camera_ErrorCode OH_CaptureSession_IsVideoStabilizationModeSupported(Camera_CaptureSession* session,Camera_VideoStabilizationMode mode, bool* isSupported)](#oh_capturesession_isvideostabilizationmodesupported) | - | 检查是否支持指定的录像防抖模式。 | 84| [Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode(Camera_CaptureSession* session,Camera_VideoStabilizationMode* mode)](#oh_capturesession_getvideostabilizationmode) | - | 获取当前录像防抖模式。 | 85| [Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode(Camera_CaptureSession* session,Camera_VideoStabilizationMode mode)](#oh_capturesession_setvideostabilizationmode) | - | 设置录像防抖模式。 | 86| [Camera_ErrorCode OH_CaptureSession_CanAddInput(Camera_CaptureSession* session,Camera_Input* cameraInput, bool* isSuccessful)](#oh_capturesession_canaddinput) | - | 确定是否可以将相机输入添加到会话中。 | 87| [Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* cameraOutput, bool* isSuccessful)](#oh_capturesession_canaddpreviewoutput) | - | 确定是否可以将相机预览输出添加到会话中。 | 88| [Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput(Camera_CaptureSession* session,Camera_PhotoOutput* cameraOutput, bool* isSuccessful)](#oh_capturesession_canaddphotooutput) | - | 确定是否可以将拍照输出添加到会话中。 | 89| [Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput(Camera_CaptureSession* session,Camera_VideoOutput* cameraOutput, bool* isSuccessful)](#oh_capturesession_canaddvideooutput) | - | 确定是否可以将录像输出添加到会话中。 | 90| [Camera_ErrorCode OH_CaptureSession_CanPreconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, bool* canPreconfig)](#oh_capturesession_canpreconfig) | - | 检查是否支持指定的预配置类型。 | 91| [Camera_ErrorCode OH_CaptureSession_CanPreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio, bool* canPreconfig)](#oh_capturesession_canpreconfigwithratio) | - | 检查是否支持带比例的预配置类型。 | 92| [Camera_ErrorCode OH_CaptureSession_Preconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType)](#oh_capturesession_preconfig) | - | 设置预配置类型。 | 93| [Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio)](#oh_capturesession_preconfigwithratio) | - | 设置带有比例的预配置类型。 | 94| [Camera_ErrorCode OH_CaptureSession_GetExposureValue(Camera_CaptureSession* session, float* exposureValue)](#oh_capturesession_getexposurevalue) | - | 查询曝光值。 | 95| [Camera_ErrorCode OH_CaptureSession_GetFocalLength(Camera_CaptureSession* session, float* focalLength)](#oh_capturesession_getfocallength) | - | 获取当前焦距值。 | 96| [Camera_ErrorCode OH_CaptureSession_SetSmoothZoom(Camera_CaptureSession* session,float targetZoom, Camera_SmoothZoomMode smoothZoomMode)](#oh_capturesession_setsmoothzoom) | - | 触发平滑变焦。 | 97| [Camera_ErrorCode OH_CaptureSession_GetSupportedColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace** colorSpace, uint32_t* size)](#oh_capturesession_getsupportedcolorspaces) | - | 获取支持的色彩空间列表。 | 98| [Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace)](#oh_capturesession_deletecolorspaces) | - | 删除色彩空间列表。 | 99| [Camera_ErrorCode OH_CaptureSession_GetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace)](#oh_capturesession_getactivecolorspace) | - | 获取当前色彩空间。 | 100| [Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace colorSpace)](#oh_capturesession_setactivecolorspace) | - | 设置当前色彩空间。 | 101| [Camera_ErrorCode OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)](#oh_capturesession_registerautodeviceswitchstatuscallback) | - | 注册设备切换事件回调。 | 102| [Camera_ErrorCode OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)](#oh_capturesession_unregisterautodeviceswitchstatuscallback) | - | 注销设备切换事件回调。 | 103| [Camera_ErrorCode OH_CaptureSession_IsAutoDeviceSwitchSupported(Camera_CaptureSession* session, bool* isSupported)](#oh_capturesession_isautodeviceswitchsupported) | - | 检查是否支持自动设备切换。 | 104| [Camera_ErrorCode OH_CaptureSession_EnableAutoDeviceSwitch(Camera_CaptureSession* session, bool enabled)](#oh_capturesession_enableautodeviceswitch) | - | 是否启用相机设备的自动切换。 | 105| [Camera_ErrorCode OH_CaptureSession_RegisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange)](#oh_capturesession_registersystempressurelevelchangecallback) | - | 注册系统压力状态变化回调。 | 106| [Camera_ErrorCode OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange)](#oh_capturesession_unregistersystempressurelevelchangecallback) | - | 注销系统压力状态变化回调。 | 107| [Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization(Camera_CaptureSession* session, Camera_QualityPrioritization qualityPrioritization)](#oh_capturesession_setqualityprioritization) | - | 设置录像质量优先级。<br> 默认为高质量，设置为功耗平衡将降低录像质量以减少功耗。实际功耗收益因平台而异。 | 108| [Camera_ErrorCode OH_CaptureSession_IsMacroSupported(Camera_CaptureSession* session, bool* isSupported)](#oh_capturesession_ismacrosupported) | - | 检查是否支持微距能力。 | 109| [Camera_ErrorCode OH_CaptureSession_EnableMacro(Camera_CaptureSession* session, bool enabled)](#oh_capturesession_enablemacro) | - | 是否启用相机设备的微距能力。 | 110| [Camera_ErrorCode OH_CaptureSession_SetWhiteBalance(Camera_CaptureSession* session, int32_t colorTemperature)](#oh_capturesession_setwhitebalance) | - | 设置白平衡的色温。<br> 设置前，建议通过[OH_CaptureSession_GetWhiteBalanceRange](#oh_capturesession_getwhitebalancerange)获取支持配置的白平衡色温范围。 | 111| [Camera_ErrorCode OH_CaptureSession_GetWhiteBalance(Camera_CaptureSession* session, int32_t *colorTemperature)](#oh_capturesession_getwhitebalance) | - | 获取当前白平衡色温值。 | 112| [Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode* whiteBalanceMode)](#oh_capturesession_getwhitebalancemode) | - | 获取当前的白平衡模式。 | 113| [Camera_ErrorCode OH_CaptureSession_IsWhiteBalanceModeSupported(Camera_CaptureSession* session,Camera_WhiteBalanceMode whiteBalanceMode, bool* isSupported)](#oh_capturesession_iswhitebalancemodesupported) | - | 检查是否支持指定的白平衡模式。 | 114| [Camera_ErrorCode OH_CaptureSession_SetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode whiteBalanceMode)](#oh_capturesession_setwhitebalancemode) | - | 设置白平衡模式。 | 115| [Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceRange(Camera_CaptureSession* session, int32_t *minColorTemperature, int32_t *maxColorTemperature)](#oh_capturesession_getwhitebalancerange) | - | 获取支持配置的白平衡色温范围。 | 116| [Camera_ErrorCode OH_CaptureSession_IsControlCenterSupported(Camera_CaptureSession* session, bool* isSupported)](#oh_capturesession_iscontrolcentersupported) | - | 检查是否支持相机控制器。 | 117| [Camera_ErrorCode OH_CaptureSession_GetSupportedEffectType(Camera_CaptureSession* session,Camera_ControlCenterEffectType** types, uint32_t* size)](#oh_capturesession_getsupportedeffecttype) | - | 获取相机控制器支持的效果类型。 | 118| [Camera_ErrorCode OH_CaptureSession_DeleteSupportedEffectType(Camera_CaptureSession* session,Camera_ControlCenterEffectType* types, uint32_t size)](#oh_capturesession_deletesupportedeffecttype) | - | 删除相机控制器效果类型列表。 | 119| [Camera_ErrorCode OH_CaptureSession_EnableControlCenter(Camera_CaptureSession* session, bool enabled)](#oh_capturesession_enablecontrolcenter) | - | 是否启用相机控制器。 | 120| [Camera_ErrorCode OH_CaptureSession_RegisterControlCenterEffectStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange)](#oh_capturesession_registercontrolcentereffectstatuschangecallback) | - | 注册相机控制器效果激活状态变化回调。 | 121| [Camera_ErrorCode OH_CaptureSession_UnregisterControlCenterEffectStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange)](#oh_capturesession_unregistercontrolcentereffectstatuschangecallback) | - | 注销相机控制器效果激活状态变化回调。 | 122| [ typedef void (\*OH_CaptureSession_OnMacroStatusChange)(Camera_CaptureSession* session, bool isMacroDetected)](#oh_capturesession_onmacrostatuschange) | OH_CaptureSession_OnMacroStatusChange | 相机会话微距状态改变回调。 | 123| [Camera_ErrorCode OH_CaptureSession_RegisterMacroStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnMacroStatusChange macroStatusChange)](#oh_capturesession_registermacrostatuschangecallback) | - | 注册相机会话微距状态改变回调函数。 | 124| [Camera_ErrorCode OH_CaptureSession_UnregisterMacroStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnMacroStatusChange macroStatusChange)](#oh_capturesession_unregistermacrostatuschangecallback) | - | 取消注册相机会话微距状态改变回调函数。 | 125 126## 函数说明 127 128### OH_CaptureSession_OnFocusStateChange() 129 130``` 131typedef void (*OH_CaptureSession_OnFocusStateChange)(Camera_CaptureSession* session, Camera_FocusState focusState) 132``` 133 134**描述** 135 136在[CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md)中被调用的捕获会话焦点状态回调。 137 138**起始版本：** 11 139 140 141**参数：** 142 143| 参数项 | 描述 | 144| -- | -- | 145| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 146| [Camera_FocusState](capi-camera-h.md#camera_focusstate) focusState | 回调传递的会话焦点状态。 | 147 148### OH_CaptureSession_OnError() 149 150``` 151typedef void (*OH_CaptureSession_OnError)(Camera_CaptureSession* session, Camera_ErrorCode errorCode) 152``` 153 154**描述** 155 156在[CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md)中被调用的捕获会话错误回调。 157 158**起始版本：** 11 159 160 161**参数：** 162 163| 参数项 | 描述 | 164| -- | -- | 165| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 166| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) errorCode | 捕获会话的错误码。 | 167 168**参考：** 169 170[CAMERA_SERVICE_FATAL_ERROR](capi-camera-h.md#camera_errorcode) 171 172 173### OH_CaptureSession_OnSmoothZoomInfo() 174 175``` 176typedef void (*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* session,Camera_SmoothZoomInfo* smoothZoomInfo) 177``` 178 179**描述** 180 181拍照会话平滑变焦信息回调，触发平滑变焦后该回调会返回。 182 183**起始版本：** 12 184 185 186**参数：** 187 188| 参数项 | 描述 | 189| -- | -- | 190| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 191| [Camera_SmoothZoomInfo](capi-oh-camera-camera-smoothzoominfo.md)* smoothZoomInfo | 回调传递的平滑变焦参数信息。 | 192 193### OH_CaptureSession_OnAutoDeviceSwitchStatusChange() 194 195``` 196typedef void (*OH_CaptureSession_OnAutoDeviceSwitchStatusChange)(Camera_CaptureSession* session,Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo) 197``` 198 199**描述** 200 201捕获会话设备切换状态回调。 202 203**起始版本：** 13 204 205 206**参数：** 207 208| 参数项 | 描述 | 209| -- | -- | 210| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 211| [Camera_AutoDeviceSwitchStatusInfo](capi-oh-camera-camera-autodeviceswitchstatusinfo.md)* autoDeviceSwitchStatusInfo | 回调传递的设备切换状态信息。 | 212 213### OH_CaptureSession_OnSystemPressureLevelChange() 214 215``` 216typedef void (*OH_CaptureSession_OnSystemPressureLevelChange)(Camera_CaptureSession* session,Camera_SystemPressureLevel systemPressureLevel) 217``` 218 219**描述** 220 221捕获系统压力状态变化回调。 222 223**起始版本：** 20 224 225 226**参数：** 227 228| 参数项 | 描述 | 229| -- | -- | 230| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 231| [Camera_SystemPressureLevel](capi-camera-h.md#camera_systempressurelevel) systemPressureLevel | 回调传递的系统压力等级。 | 232 233### OH_CaptureSession_OnControlCenterEffectStatusChange() 234 235``` 236typedef void (*OH_CaptureSession_OnControlCenterEffectStatusChange)(Camera_CaptureSession* session,Camera_ControlCenterStatusInfo* controlCenterStatusInfo) 237``` 238 239**描述** 240 241相机控制器效果激活状态变化回调。 242 243**起始版本：** 20 244 245 246**参数：** 247 248| 参数项 | 描述 | 249| -- | -- | 250| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 251| [Camera_ControlCenterStatusInfo](capi-oh-camera-camera-controlcenterstatusinfo.md)* controlCenterStatusInfo | 回调传递的相机控制器效果激活状态。 | 252 253### OH_CaptureSession_RegisterCallback() 254 255``` 256Camera_ErrorCode OH_CaptureSession_RegisterCallback(Camera_CaptureSession* session,CaptureSession_Callbacks* callback) 257``` 258 259**描述** 260 261注册捕获会话事件回调。 262 263**起始版本：** 11 264 265 266**参数：** 267 268| 参数项 | 描述 | 269| -- | -- | 270| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 271| [CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md)* callback | 要注册的捕获会话事件回调。 | 272 273**返回：** 274 275| 类型 | 说明 | 276| -- | -- | 277| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 278 279### OH_CaptureSession_UnregisterCallback() 280 281``` 282Camera_ErrorCode OH_CaptureSession_UnregisterCallback(Camera_CaptureSession* session,CaptureSession_Callbacks* callback) 283``` 284 285**描述** 286 287注销捕获会话事件回调。 288 289**起始版本：** 11 290 291 292**参数：** 293 294| 参数项 | 描述 | 295| -- | -- | 296| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 297| [CaptureSession_Callbacks](capi-oh-camera-capturesession-callbacks.md)* callback | 要注销的捕获会话事件回调。 | 298 299**返回：** 300 301| 类型 | 说明 | 302| -- | -- | 303| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 304 305### OH_CaptureSession_RegisterSmoothZoomInfoCallback() 306 307``` 308Camera_ErrorCode OH_CaptureSession_RegisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback) 309``` 310 311**描述** 312 313注册平滑变焦信息事件回调。 314 315**起始版本：** 12 316 317 318**参数：** 319 320| 参数项 | 描述 | 321| -- | -- | 322| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 323| [OH_CaptureSession_OnSmoothZoomInfo](#oh_capturesession_onsmoothzoominfo) smoothZoomInfoCallback | 要注册的平滑变焦信息事件回调。 | 324 325**返回：** 326 327| 类型 | 说明 | 328| -- | -- | 329| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 330 331### OH_CaptureSession_UnregisterSmoothZoomInfoCallback() 332 333``` 334Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback) 335``` 336 337**描述** 338 339注销平滑变焦信息事件回调。 340 341**起始版本：** 12 342 343 344**参数：** 345 346| 参数项 | 描述 | 347| -- | -- | 348| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 349| [OH_CaptureSession_OnSmoothZoomInfo](#oh_capturesession_onsmoothzoominfo) smoothZoomInfoCallback | 要注销的平滑变焦信息事件回调。 | 350 351**返回：** 352 353| 类型 | 说明 | 354| -- | -- | 355| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 356 357### OH_CaptureSession_SetSessionMode() 358 359``` 360Camera_ErrorCode OH_CaptureSession_SetSessionMode(Camera_CaptureSession* session, Camera_SceneMode sceneMode) 361``` 362 363**描述** 364 365设置会话模式。<br> 此接口不能在[OH_CaptureSession_BeginConfig](#oh_capturesession_beginconfig)之后使用。<br> 建议在使用[OH_CameraManager_CreateCaptureSession](capi-camera-manager-h.md#oh_cameramanager_createcapturesession)后立即使用此接口。 366 367**起始版本：** 12 368 369 370**参数：** 371 372| 参数项 | 描述 | 373| -- | -- | 374| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 375| [Camera_SceneMode](capi-camera-h.md#camera_scenemode) sceneMode | 相机模式。 | 376 377**返回：** 378 379| 类型 | 说明 | 380| -- | -- | 381| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。<br> CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。 | 382 383### OH_CaptureSession_AddSecureOutput() 384 385``` 386Camera_ErrorCode OH_CaptureSession_AddSecureOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput) 387``` 388 389**描述** 390 391把其中一条PreviewOutput标记成安全输出。 392 393**起始版本：** 12 394 395 396**参数：** 397 398| 参数项 | 描述 | 399| -- | -- | 400| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 401| [Camera_PreviewOutput](capi-oh-camera-camera-previewoutput.md)* previewOutput | 要标记为安全输出的Camera_PreviewOutput。 | 402 403**返回：** 404 405| 类型 | 说明 | 406| -- | -- | 407| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。<br> CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。 | 408 409### OH_CaptureSession_BeginConfig() 410 411``` 412Camera_ErrorCode OH_CaptureSession_BeginConfig(Camera_CaptureSession* session) 413``` 414 415**描述** 416 417开始捕获会话配置。 418 419**起始版本：** 11 420 421 422**参数：** 423 424| 参数项 | 描述 | 425| -- | -- | 426| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 427 428**返回：** 429 430| 类型 | 说明 | 431| -- | -- | 432| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。 | 433 434### OH_CaptureSession_CommitConfig() 435 436``` 437Camera_ErrorCode OH_CaptureSession_CommitConfig(Camera_CaptureSession* session) 438``` 439 440**描述** 441 442提交捕获会话配置。 443 444**起始版本：** 11 445 446 447**参数：** 448 449| 参数项 | 描述 | 450| -- | -- | 451| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 452 453**返回：** 454 455| 类型 | 说明 | 456| -- | -- | 457| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 458 459### OH_CaptureSession_AddInput() 460 461``` 462Camera_ErrorCode OH_CaptureSession_AddInput(Camera_CaptureSession* session, Camera_Input* cameraInput) 463``` 464 465**描述** 466 467添加相机输入。 468 469**起始版本：** 11 470 471 472**参数：** 473 474| 参数项 | 描述 | 475| -- | -- | 476| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 477| [Camera_Input](capi-oh-camera-camera-input.md)* cameraInput | 要添加的相机输入实例。 | 478 479**返回：** 480 481| 类型 | 说明 | 482| -- | -- | 483| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 484 485### OH_CaptureSession_RemoveInput() 486 487``` 488Camera_ErrorCode OH_CaptureSession_RemoveInput(Camera_CaptureSession* session, Camera_Input* cameraInput) 489``` 490 491**描述** 492 493删除相机输入。 494 495**起始版本：** 11 496 497 498**参数：** 499 500| 参数项 | 描述 | 501| -- | -- | 502| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 503| [Camera_Input](capi-oh-camera-camera-input.md)* cameraInput | 要删除的相机输入实例。 | 504 505**返回：** 506 507| 类型 | 说明 | 508| -- | -- | 509| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 510 511### OH_CaptureSession_AddPreviewOutput() 512 513``` 514Camera_ErrorCode OH_CaptureSession_AddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* previewOutput) 515``` 516 517**描述** 518 519添加预览输出。 520 521**起始版本：** 11 522 523 524**参数：** 525 526| 参数项 | 描述 | 527| -- | -- | 528| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 529| [Camera_PreviewOutput](capi-oh-camera-camera-previewoutput.md)* previewOutput | 要添加的预览输出实例。 | 530 531**返回：** 532 533| 类型 | 说明 | 534| -- | -- | 535| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 536 537### OH_CaptureSession_RemovePreviewOutput() 538 539``` 540Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* previewOutput) 541``` 542 543**描述** 544 545删除预览输出。 546 547**起始版本：** 11 548 549 550**参数：** 551 552| 参数项 | 描述 | 553| -- | -- | 554| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 555| [Camera_PreviewOutput](capi-oh-camera-camera-previewoutput.md)* previewOutput | 要删除的预览输出实例。 | 556 557**返回：** 558 559| 类型 | 说明 | 560| -- | -- | 561| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 562 563### OH_CaptureSession_AddPhotoOutput() 564 565``` 566Camera_ErrorCode OH_CaptureSession_AddPhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput) 567``` 568 569**描述** 570 571添加拍照输出。 572 573**起始版本：** 11 574 575 576**参数：** 577 578| 参数项 | 描述 | 579| -- | -- | 580| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 581| [Camera_PhotoOutput](capi-oh-camera-camera-photooutput.md)* photoOutput | 要添加的拍照输出实例。 | 582 583**返回：** 584 585| 类型 | 说明 | 586| -- | -- | 587| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 588 589### OH_CaptureSession_RemovePhotoOutput() 590 591``` 592Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput) 593``` 594 595**描述** 596 597删除拍照输出。 598 599**起始版本：** 11 600 601 602**参数：** 603 604| 参数项 | 描述 | 605| -- | -- | 606| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 607| [Camera_PhotoOutput](capi-oh-camera-camera-photooutput.md)* photoOutput | 要删除的拍照输出实例。 | 608 609**返回：** 610 611| 类型 | 说明 | 612| -- | -- | 613| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 614 615### OH_CaptureSession_AddVideoOutput() 616 617``` 618Camera_ErrorCode OH_CaptureSession_AddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput) 619``` 620 621**描述** 622 623添加录像输出。 624 625**起始版本：** 11 626 627 628**参数：** 629 630| 参数项 | 描述 | 631| -- | -- | 632| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 633| [Camera_VideoOutput](capi-oh-camera-camera-videooutput.md)* videoOutput | 要添加的录像输出实例。 | 634 635**返回：** 636 637| 类型 | 说明 | 638| -- | -- | 639| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 640 641### OH_CaptureSession_RemoveVideoOutput() 642 643``` 644Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput) 645``` 646 647**描述** 648 649删除录像输出。 650 651**起始版本：** 11 652 653 654**参数：** 655 656| 参数项 | 描述 | 657| -- | -- | 658| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 659| [Camera_VideoOutput](capi-oh-camera-camera-videooutput.md)* videoOutput | 要删除的录像输出实例。 | 660 661**返回：** 662 663| 类型 | 说明 | 664| -- | -- | 665| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 666 667### OH_CaptureSession_AddMetadataOutput() 668 669``` 670Camera_ErrorCode OH_CaptureSession_AddMetadataOutput(Camera_CaptureSession* session,Camera_MetadataOutput* metadataOutput) 671``` 672 673**描述** 674 675添加元数据输出。 676 677**起始版本：** 11 678 679 680**参数：** 681 682| 参数项 | 描述 | 683| -- | -- | 684| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 685| [Camera_MetadataOutput](capi-oh-camera-camera-metadataoutput.md)* metadataOutput | 要添加的元数据输出实例。 | 686 687**返回：** 688 689| 类型 | 说明 | 690| -- | -- | 691| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 692 693### OH_CaptureSession_RemoveMetadataOutput() 694 695``` 696Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput(Camera_CaptureSession* session,Camera_MetadataOutput* metadataOutput) 697``` 698 699**描述** 700 701删除元数据输出。 702 703**起始版本：** 11 704 705 706**参数：** 707 708| 参数项 | 描述 | 709| -- | -- | 710| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 711| [Camera_MetadataOutput](capi-oh-camera-camera-metadataoutput.md)* metadataOutput | 要删除的元数据输出实例。 | 712 713**返回：** 714 715| 类型 | 说明 | 716| -- | -- | 717| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 | 718 719### OH_CaptureSession_Start() 720 721``` 722Camera_ErrorCode OH_CaptureSession_Start(Camera_CaptureSession* session) 723``` 724 725**描述** 726 727启动捕获会话。 728 729**起始版本：** 11 730 731 732**参数：** 733 734| 参数项 | 描述 | 735| -- | -- | 736| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 要启动的Camera_CaptureSession实例。 | 737 738**返回：** 739 740| 类型 | 说明 | 741| -- | -- | 742| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 743 744### OH_CaptureSession_Stop() 745 746``` 747Camera_ErrorCode OH_CaptureSession_Stop(Camera_CaptureSession* session) 748``` 749 750**描述** 751 752停止捕获会话。 753 754**起始版本：** 11 755 756 757**参数：** 758 759| 参数项 | 描述 | 760| -- | -- | 761| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 要停止的Camera_CaptureSession实例。 | 762 763**返回：** 764 765| 类型 | 说明 | 766| -- | -- | 767| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 768 769### OH_CaptureSession_Release() 770 771``` 772Camera_ErrorCode OH_CaptureSession_Release(Camera_CaptureSession* session) 773``` 774 775**描述** 776 777释放捕获会话。 778 779**起始版本：** 11 780 781 782**参数：** 783 784| 参数项 | 描述 | 785| -- | -- | 786| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 要释放的Camera_CaptureSession实例。 | 787 788**返回：** 789 790| 类型 | 说明 | 791| -- | -- | 792| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 793 794### OH_CaptureSession_HasFlash() 795 796``` 797Camera_ErrorCode OH_CaptureSession_HasFlash(Camera_CaptureSession* session, bool* hasFlash) 798``` 799 800**描述** 801 802检查设备是否有闪光灯。 803 804**起始版本：** 11 805 806 807**参数：** 808 809| 参数项 | 描述 | 810| -- | -- | 811| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 812| bool* hasFlash | 是否支持闪光灯的结果。返回true表示支持闪光灯，返回false表示不支持。 | 813 814**返回：** 815 816| 类型 | 说明 | 817| -- | -- | 818| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 819 820### OH_CaptureSession_IsFlashModeSupported() 821 822``` 823Camera_ErrorCode OH_CaptureSession_IsFlashModeSupported(Camera_CaptureSession* session,Camera_FlashMode flashMode, bool* isSupported) 824``` 825 826**描述** 827 828检查是否支持指定的闪光灯模式。 829 830**起始版本：** 11 831 832 833**参数：** 834 835| 参数项 | 描述 | 836| -- | -- | 837| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 838| [Camera_FlashMode](capi-camera-h.md#camera_flashmode) flashMode | 要检查的闪光灯模式。 | 839| bool* isSupported | 是否支持闪光灯模式的结果。返回true表示支持闪光灯模式，返回false表示不支持。 | 840 841**返回：** 842 843| 类型 | 说明 | 844| -- | -- | 845| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 846 847### OH_CaptureSession_GetFlashMode() 848 849``` 850Camera_ErrorCode OH_CaptureSession_GetFlashMode(Camera_CaptureSession* session, Camera_FlashMode* flashMode) 851``` 852 853**描述** 854 855获取当前闪光灯模式。 856 857**起始版本：** 11 858 859 860**参数：** 861 862| 参数项 | 描述 | 863| -- | -- | 864| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 865| [Camera_FlashMode](capi-camera-h.md#camera_flashmode)* flashMode | 当前闪光灯模式。 | 866 867**返回：** 868 869| 类型 | 说明 | 870| -- | -- | 871| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 872 873### OH_CaptureSession_SetFlashMode() 874 875``` 876Camera_ErrorCode OH_CaptureSession_SetFlashMode(Camera_CaptureSession* session, Camera_FlashMode flashMode) 877``` 878 879**描述** 880 881设置闪光灯模式。 882 883**起始版本：** 11 884 885 886**参数：** 887 888| 参数项 | 描述 | 889| -- | -- | 890| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 891| [Camera_FlashMode](capi-camera-h.md#camera_flashmode) flashMode | 要设置的闪光灯模式。 | 892 893**返回：** 894 895| 类型 | 说明 | 896| -- | -- | 897| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 898 899### OH_CaptureSession_IsExposureModeSupported() 900 901``` 902Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported(Camera_CaptureSession* session,Camera_ExposureMode exposureMode, bool* isSupported) 903``` 904 905**描述** 906 907检查是否支持指定的曝光模式。 908 909**起始版本：** 11 910 911 912**参数：** 913 914| 参数项 | 描述 | 915| -- | -- | 916| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 917| [Camera_ExposureMode](capi-camera-h.md#camera_exposuremode) exposureMode | 要检查的曝光模式。 | 918| bool* isSupported | 是否支持曝光模式的结果。返回true表示支持曝光模式，返回false表示不支持。 | 919 920**返回：** 921 922| 类型 | 说明 | 923| -- | -- | 924| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 925 926### OH_CaptureSession_GetExposureMode() 927 928``` 929Camera_ErrorCode OH_CaptureSession_GetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode* exposureMode) 930``` 931 932**描述** 933 934获取当前曝光模式。 935 936**起始版本：** 11 937 938 939**参数：** 940 941| 参数项 | 描述 | 942| -- | -- | 943| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 944| [Camera_ExposureMode](capi-camera-h.md#camera_exposuremode)* exposureMode | 当前的曝光模式。 | 945 946**返回：** 947 948| 类型 | 说明 | 949| -- | -- | 950| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 951 952### OH_CaptureSession_SetExposureMode() 953 954``` 955Camera_ErrorCode OH_CaptureSession_SetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode exposureMode) 956``` 957 958**描述** 959 960设置曝光模式。 961 962**起始版本：** 11 963 964 965**参数：** 966 967| 参数项 | 描述 | 968| -- | -- | 969| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 970| [Camera_ExposureMode](capi-camera-h.md#camera_exposuremode) exposureMode | 要设置的曝光模式。 | 971 972**返回：** 973 974| 类型 | 说明 | 975| -- | -- | 976| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 977 978### OH_CaptureSession_GetMeteringPoint() 979 980``` 981Camera_ErrorCode OH_CaptureSession_GetMeteringPoint(Camera_CaptureSession* session, Camera_Point* point) 982``` 983 984**描述** 985 986获取当前测量点。 987 988**起始版本：** 11 989 990 991**参数：** 992 993| 参数项 | 描述 | 994| -- | -- | 995| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 996| [Camera_Point](capi-oh-camera-camera-point.md)* point | 当前测量点。 | 997 998**返回：** 999 1000| 类型 | 说明 | 1001| -- | -- | 1002| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1003 1004### OH_CaptureSession_SetMeteringPoint() 1005 1006``` 1007Camera_ErrorCode OH_CaptureSession_SetMeteringPoint(Camera_CaptureSession* session, Camera_Point point) 1008``` 1009 1010**描述** 1011 1012设置计量区域的中心点。 1013 1014**起始版本：** 11 1015 1016 1017**参数：** 1018 1019| 参数项 | 描述 | 1020| -- | -- | 1021| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1022| [Camera_Point](capi-oh-camera-camera-point.md) point | 要设置的测量点。 | 1023 1024**返回：** 1025 1026| 类型 | 说明 | 1027| -- | -- | 1028| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1029 1030### OH_CaptureSession_GetExposureBiasRange() 1031 1032``` 1033Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange(Camera_CaptureSession* session, float* minExposureBias,float* maxExposureBias, float* step) 1034``` 1035 1036**描述** 1037 1038查询曝光补偿范围。 1039 1040**起始版本：** 11 1041 1042 1043**参数：** 1044 1045| 参数项 | 描述 | 1046| -- | -- | 1047| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1048| float* minExposureBias | 曝光补偿的最小值。 | 1049| float* maxExposureBias | 曝光补偿的最大值。 | 1050| float* step | 每个级别之间的曝光补偿阶梯。 | 1051 1052**返回：** 1053 1054| 类型 | 说明 | 1055| -- | -- | 1056| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1057 1058### OH_CaptureSession_SetExposureBias() 1059 1060``` 1061Camera_ErrorCode OH_CaptureSession_SetExposureBias(Camera_CaptureSession* session, float exposureBias) 1062``` 1063 1064**描述** 1065 1066设置曝光补偿。 1067 1068**起始版本：** 11 1069 1070 1071**参数：** 1072 1073| 参数项 | 描述 | 1074| -- | -- | 1075| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1076| float exposureBias | 要设置的曝光补偿。 | 1077 1078**返回：** 1079 1080| 类型 | 说明 | 1081| -- | -- | 1082| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1083 1084### OH_CaptureSession_GetExposureBias() 1085 1086``` 1087Camera_ErrorCode OH_CaptureSession_GetExposureBias(Camera_CaptureSession* session, float* exposureBias) 1088``` 1089 1090**描述** 1091 1092获取当前曝光补偿。 1093 1094**起始版本：** 11 1095 1096 1097**参数：** 1098 1099| 参数项 | 描述 | 1100| -- | -- | 1101| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1102| float* exposureBias | 当前的曝光补偿。 | 1103 1104**返回：** 1105 1106| 类型 | 说明 | 1107| -- | -- | 1108| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1109 1110### OH_CaptureSession_IsFocusModeSupported() 1111 1112``` 1113Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported(Camera_CaptureSession* session,Camera_FocusMode focusMode, bool* isSupported) 1114``` 1115 1116**描述** 1117 1118检查是否支持指定的聚焦模式。 1119 1120**起始版本：** 11 1121 1122 1123**参数：** 1124 1125| 参数项 | 描述 | 1126| -- | -- | 1127| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1128| [Camera_FocusMode](capi-camera-h.md#camera_focusmode) focusMode | 要检查的聚焦模式。 | 1129| bool* isSupported | 是否支持聚焦模式的结果。返回true表示支持聚焦模式，返回false表示不支持。 | 1130 1131**返回：** 1132 1133| 类型 | 说明 | 1134| -- | -- | 1135| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1136 1137### OH_CaptureSession_GetFocusMode() 1138 1139``` 1140Camera_ErrorCode OH_CaptureSession_GetFocusMode(Camera_CaptureSession* session, Camera_FocusMode* focusMode) 1141``` 1142 1143**描述** 1144 1145获取当前聚焦模式。 1146 1147**起始版本：** 11 1148 1149 1150**参数：** 1151 1152| 参数项 | 描述 | 1153| -- | -- | 1154| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1155| [Camera_FocusMode](capi-camera-h.md#camera_focusmode)* focusMode | 当前聚焦模式。 | 1156 1157**返回：** 1158 1159| 类型 | 说明 | 1160| -- | -- | 1161| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1162 1163### OH_CaptureSession_SetFocusMode() 1164 1165``` 1166Camera_ErrorCode OH_CaptureSession_SetFocusMode(Camera_CaptureSession* session, Camera_FocusMode focusMode) 1167``` 1168 1169**描述** 1170 1171设置聚焦模式。 1172 1173**起始版本：** 11 1174 1175 1176**参数：** 1177 1178| 参数项 | 描述 | 1179| -- | -- | 1180| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1181| [Camera_FocusMode](capi-camera-h.md#camera_focusmode) focusMode | 要设置的聚焦模式。 | 1182 1183**返回：** 1184 1185| 类型 | 说明 | 1186| -- | -- | 1187| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1188 1189### OH_CaptureSession_GetFocusPoint() 1190 1191``` 1192Camera_ErrorCode OH_CaptureSession_GetFocusPoint(Camera_CaptureSession* session, Camera_Point* focusPoint) 1193``` 1194 1195**描述** 1196 1197获取当前焦点。 1198 1199**起始版本：** 11 1200 1201 1202**参数：** 1203 1204| 参数项 | 描述 | 1205| -- | -- | 1206| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1207| [Camera_Point](capi-oh-camera-camera-point.md)* focusPoint | 当前焦点。 | 1208 1209**返回：** 1210 1211| 类型 | 说明 | 1212| -- | -- | 1213| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1214 1215### OH_CaptureSession_SetFocusPoint() 1216 1217``` 1218Camera_ErrorCode OH_CaptureSession_SetFocusPoint(Camera_CaptureSession* session, Camera_Point focusPoint) 1219``` 1220 1221**描述** 1222 1223设置焦点。 1224 1225**起始版本：** 11 1226 1227 1228**参数：** 1229 1230| 参数项 | 描述 | 1231| -- | -- | 1232| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1233| [Camera_Point](capi-oh-camera-camera-point.md) focusPoint | 要设置的目标点。 | 1234 1235**返回：** 1236 1237| 类型 | 说明 | 1238| -- | -- | 1239| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1240 1241### OH_CaptureSession_GetZoomRatioRange() 1242 1243``` 1244Camera_ErrorCode OH_CaptureSession_GetZoomRatioRange(Camera_CaptureSession* session, float* minZoom, float* maxZoom) 1245``` 1246 1247**描述** 1248 1249获取所有支持的缩放比例范围。 1250 1251**起始版本：** 11 1252 1253 1254**参数：** 1255 1256| 参数项 | 描述 | 1257| -- | -- | 1258| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1259| float* minZoom | 缩放比范围的最小值。 | 1260| float* maxZoom | 缩放比例范围的最大值。 | 1261 1262**返回：** 1263 1264| 类型 | 说明 | 1265| -- | -- | 1266| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1267 1268### OH_CaptureSession_GetZoomRatio() 1269 1270``` 1271Camera_ErrorCode OH_CaptureSession_GetZoomRatio(Camera_CaptureSession* session, float* zoom) 1272``` 1273 1274**描述** 1275 1276获取当前缩放比例。 1277 1278**起始版本：** 11 1279 1280 1281**参数：** 1282 1283| 参数项 | 描述 | 1284| -- | -- | 1285| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1286| float* zoom | 当前缩放比例。 | 1287 1288**返回：** 1289 1290| 类型 | 说明 | 1291| -- | -- | 1292| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1293 1294### OH_CaptureSession_SetZoomRatio() 1295 1296``` 1297Camera_ErrorCode OH_CaptureSession_SetZoomRatio(Camera_CaptureSession* session, float zoom) 1298``` 1299 1300**描述** 1301 1302设置缩放比例。 1303 1304**起始版本：** 11 1305 1306 1307**参数：** 1308 1309| 参数项 | 描述 | 1310| -- | -- | 1311| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1312| float zoom | 要设置的目标缩放比。<br> 设置可变焦距比到底层生效需要一定时间，获取正确设置的可变焦距比需要等待1~2帧的时间。 | 1313 1314**返回：** 1315 1316| 类型 | 说明 | 1317| -- | -- | 1318| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1319 1320### OH_CaptureSession_IsVideoStabilizationModeSupported() 1321 1322``` 1323Camera_ErrorCode OH_CaptureSession_IsVideoStabilizationModeSupported(Camera_CaptureSession* session,Camera_VideoStabilizationMode mode, bool* isSupported) 1324``` 1325 1326**描述** 1327 1328检查是否支持指定的录像防抖模式。 1329 1330**起始版本：** 11 1331 1332 1333**参数：** 1334 1335| 参数项 | 描述 | 1336| -- | -- | 1337| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1338| [Camera_VideoStabilizationMode](capi-camera-h.md#camera_videostabilizationmode) mode | 要检查的录像防抖模式。 | 1339| bool* isSupported | 是否支持录像防抖模式的结果。返回true表示支持录像防抖模式，返回false表示不支持。 | 1340 1341**返回：** 1342 1343| 类型 | 说明 | 1344| -- | -- | 1345| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1346 1347### OH_CaptureSession_GetVideoStabilizationMode() 1348 1349``` 1350Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode(Camera_CaptureSession* session,Camera_VideoStabilizationMode* mode) 1351``` 1352 1353**描述** 1354 1355获取当前录像防抖模式。 1356 1357**起始版本：** 11 1358 1359 1360**参数：** 1361 1362| 参数项 | 描述 | 1363| -- | -- | 1364| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1365| [Camera_VideoStabilizationMode](capi-camera-h.md#camera_videostabilizationmode)* mode | 当前录像防抖模式。 | 1366 1367**返回：** 1368 1369| 类型 | 说明 | 1370| -- | -- | 1371| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1372 1373### OH_CaptureSession_SetVideoStabilizationMode() 1374 1375``` 1376Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode(Camera_CaptureSession* session,Camera_VideoStabilizationMode mode) 1377``` 1378 1379**描述** 1380 1381设置录像防抖模式。 1382 1383**起始版本：** 11 1384 1385 1386**参数：** 1387 1388| 参数项 | 描述 | 1389| -- | -- | 1390| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1391| [Camera_VideoStabilizationMode](capi-camera-h.md#camera_videostabilizationmode) mode | 要设置的录像防抖模式。 | 1392 1393**返回：** 1394 1395| 类型 | 说明 | 1396| -- | -- | 1397| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1398 1399### OH_CaptureSession_CanAddInput() 1400 1401``` 1402Camera_ErrorCode OH_CaptureSession_CanAddInput(Camera_CaptureSession* session,Camera_Input* cameraInput, bool* isSuccessful) 1403``` 1404 1405**描述** 1406 1407确定是否可以将相机输入添加到会话中。 1408 1409**起始版本：** 12 1410 1411 1412**参数：** 1413 1414| 参数项 | 描述 | 1415| -- | -- | 1416| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1417| [Camera_Input](capi-oh-camera-camera-input.md)* cameraInput | 要设置的相机输入实例。 | 1418| bool* isSuccessful | 是否可以将相机输入添加到会话中的结果。返回true表示可以将相机输入添加到会话中，返回false表示不可以。 | 1419 1420**返回：** 1421 1422| 类型 | 说明 | 1423| -- | -- | 1424| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1425 1426### OH_CaptureSession_CanAddPreviewOutput() 1427 1428``` 1429Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput(Camera_CaptureSession* session,Camera_PreviewOutput* cameraOutput, bool* isSuccessful) 1430``` 1431 1432**描述** 1433 1434确定是否可以将相机预览输出添加到会话中。 1435 1436**起始版本：** 12 1437 1438 1439**参数：** 1440 1441| 参数项 | 描述 | 1442| -- | -- | 1443| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1444| [Camera_PreviewOutput](capi-oh-camera-camera-previewoutput.md)* cameraOutput | 要设置的预览输出实例。 | 1445| bool* isSuccessful | 是否可以将相机预览输出添加到会话中的结果。返回true表示可以将相机预览输出添加到会话中，返回false表示不可以。 | 1446 1447**返回：** 1448 1449| 类型 | 说明 | 1450| -- | -- | 1451| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1452 1453### OH_CaptureSession_CanAddPhotoOutput() 1454 1455``` 1456Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput(Camera_CaptureSession* session,Camera_PhotoOutput* cameraOutput, bool* isSuccessful) 1457``` 1458 1459**描述** 1460 1461确定是否可以将拍照输出添加到会话中。 1462 1463**起始版本：** 12 1464 1465 1466**参数：** 1467 1468| 参数项 | 描述 | 1469| -- | -- | 1470| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1471| [Camera_PhotoOutput](capi-oh-camera-camera-photooutput.md)* cameraOutput | 要设置的拍照输出实例。 | 1472| bool* isSuccessful | 拍照输出是否可以添加到会话中的结果。返回true表示拍照输出可以添加到会话中，返回false表示不可以。 | 1473 1474**返回：** 1475 1476| 类型 | 说明 | 1477| -- | -- | 1478| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1479 1480### OH_CaptureSession_CanAddVideoOutput() 1481 1482``` 1483Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput(Camera_CaptureSession* session,Camera_VideoOutput* cameraOutput, bool* isSuccessful) 1484``` 1485 1486**描述** 1487 1488确定是否可以将录像输出添加到会话中。 1489 1490**起始版本：** 12 1491 1492 1493**参数：** 1494 1495| 参数项 | 描述 | 1496| -- | -- | 1497| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1498| [Camera_VideoOutput](capi-oh-camera-camera-videooutput.md)* cameraOutput | 要添加的录像输出实例。 | 1499| bool* isSuccessful | 录像输出是否可以添加到会话中的结果。返回true表示录像输出可以添加到会话中，返回false表示不可以。 | 1500 1501**返回：** 1502 1503| 类型 | 说明 | 1504| -- | -- | 1505| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1506 1507### OH_CaptureSession_CanPreconfig() 1508 1509``` 1510Camera_ErrorCode OH_CaptureSession_CanPreconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, bool* canPreconfig) 1511``` 1512 1513**描述** 1514 1515检查是否支持指定的预配置类型。 1516 1517**起始版本：** 12 1518 1519 1520**参数：** 1521 1522| 参数项 | 描述 | 1523| -- | -- | 1524| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1525| [Camera_PreconfigType](capi-camera-h.md#camera_preconfigtype) preconfigType | 要检查的预配置类型。 | 1526| bool* canPreconfig | 是否支持预配置的结果。返回true表示支持预配置，返回false表示不支持。 | 1527 1528**返回：** 1529 1530| 类型 | 说明 | 1531| -- | -- | 1532| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1533 1534### OH_CaptureSession_CanPreconfigWithRatio() 1535 1536``` 1537Camera_ErrorCode OH_CaptureSession_CanPreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio, bool* canPreconfig) 1538``` 1539 1540**描述** 1541 1542检查是否支持带比例的预配置类型。 1543 1544**起始版本：** 12 1545 1546 1547**参数：** 1548 1549| 参数项 | 描述 | 1550| -- | -- | 1551| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1552| [Camera_PreconfigType](capi-camera-h.md#camera_preconfigtype) preconfigType | 要检查的预配置类型。 | 1553| [Camera_PreconfigRatio](capi-camera-h.md#camera_preconfigratio) preconfigRatio | 要检查的预配置比例。 | 1554| bool* canPreconfig | 是否支持预配置的结果。返回true表示支持预配置，返回false表示不支持。 | 1555 1556**返回：** 1557 1558| 类型 | 说明 | 1559| -- | -- | 1560| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1561 1562### OH_CaptureSession_Preconfig() 1563 1564``` 1565Camera_ErrorCode OH_CaptureSession_Preconfig(Camera_CaptureSession* session,Camera_PreconfigType preconfigType) 1566``` 1567 1568**描述** 1569 1570设置预配置类型。 1571 1572**起始版本：** 12 1573 1574 1575**参数：** 1576 1577| 参数项 | 描述 | 1578| -- | -- | 1579| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1580| [Camera_PreconfigType](capi-camera-h.md#camera_preconfigtype) preconfigType | 指定的预配置类型。 | 1581 1582**返回：** 1583 1584| 类型 | 说明 | 1585| -- | -- | 1586| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 1587 1588### OH_CaptureSession_PreconfigWithRatio() 1589 1590``` 1591Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio(Camera_CaptureSession* session,Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio) 1592``` 1593 1594**描述** 1595 1596设置带有比例的预配置类型。 1597 1598**起始版本：** 12 1599 1600 1601**参数：** 1602 1603| 参数项 | 描述 | 1604| -- | -- | 1605| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1606| [Camera_PreconfigType](capi-camera-h.md#camera_preconfigtype) preconfigType | 指定的预配置类型。 | 1607| [Camera_PreconfigRatio](capi-camera-h.md#camera_preconfigratio) preconfigRatio | 指定的预配置比例。 | 1608 1609**返回：** 1610 1611| 类型 | 说明 | 1612| -- | -- | 1613| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 1614 1615### OH_CaptureSession_GetExposureValue() 1616 1617``` 1618Camera_ErrorCode OH_CaptureSession_GetExposureValue(Camera_CaptureSession* session, float* exposureValue) 1619``` 1620 1621**描述** 1622 1623查询曝光值。 1624 1625**起始版本：** 12 1626 1627 1628**参数：** 1629 1630| 参数项 | 描述 | 1631| -- | -- | 1632| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1633| float* exposureValue | 当前的曝光值。 | 1634 1635**返回：** 1636 1637| 类型 | 说明 | 1638| -- | -- | 1639| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 1640 1641### OH_CaptureSession_GetFocalLength() 1642 1643``` 1644Camera_ErrorCode OH_CaptureSession_GetFocalLength(Camera_CaptureSession* session, float* focalLength) 1645``` 1646 1647**描述** 1648 1649获取当前焦距值。 1650 1651**起始版本：** 12 1652 1653 1654**参数：** 1655 1656| 参数项 | 描述 | 1657| -- | -- | 1658| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1659| float* focalLength | 当前焦距值。 | 1660 1661**返回：** 1662 1663| 类型 | 说明 | 1664| -- | -- | 1665| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1666 1667### OH_CaptureSession_SetSmoothZoom() 1668 1669``` 1670Camera_ErrorCode OH_CaptureSession_SetSmoothZoom(Camera_CaptureSession* session,float targetZoom, Camera_SmoothZoomMode smoothZoomMode) 1671``` 1672 1673**描述** 1674 1675触发平滑变焦。 1676 1677**起始版本：** 12 1678 1679 1680**参数：** 1681 1682| 参数项 | 描述 | 1683| -- | -- | 1684| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1685| float targetZoom | 要设置的目标变焦比。 | 1686| [Camera_SmoothZoomMode](capi-camera-h.md#camera_smoothzoommode) smoothZoomMode | 平滑变焦模式。 | 1687 1688**返回：** 1689 1690| 类型 | 说明 | 1691| -- | -- | 1692| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1693 1694### OH_CaptureSession_GetSupportedColorSpaces() 1695 1696``` 1697Camera_ErrorCode OH_CaptureSession_GetSupportedColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace** colorSpace, uint32_t* size) 1698``` 1699 1700**描述** 1701 1702获取支持的色彩空间列表。 1703 1704**起始版本：** 12 1705 1706 1707**参数：** 1708 1709| 参数项 | 描述 | 1710| -- | -- | 1711| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1712| OH_NativeBuffer_ColorSpace** colorSpace | 如果方法调用成功，将记录支持的OH_NativeBuffer_ColorSpace列表。 | 1713| uint32_t* size | 如果方法调用成功，将记录支持的OH_NativeBuffer_ColorSpace列表的大小。 | 1714 1715**返回：** 1716 1717| 类型 | 说明 | 1718| -- | -- | 1719| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1720 1721### OH_CaptureSession_DeleteColorSpaces() 1722 1723``` 1724Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace) 1725``` 1726 1727**描述** 1728 1729删除色彩空间列表。 1730 1731**起始版本：** 12 1732 1733 1734**参数：** 1735 1736| 参数项 | 描述 | 1737| -- | -- | 1738| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1739| [OH_NativeBuffer_ColorSpace](../apis-arkgraphics2d/capi-buffer-common-h.md#oh_nativebuffer_colorspace)* colorSpace | 如果方法调用成功，将删除的OH_NativeBuffer_ColorSpace列表。 | 1740 1741**返回：** 1742 1743| 类型 | 说明 | 1744| -- | -- | 1745| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1746 1747### OH_CaptureSession_GetActiveColorSpace() 1748 1749``` 1750Camera_ErrorCode OH_CaptureSession_GetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace* colorSpace) 1751``` 1752 1753**描述** 1754 1755获取当前色彩空间。 1756 1757**起始版本：** 12 1758 1759 1760**参数：** 1761 1762| 参数项 | 描述 | 1763| -- | -- | 1764| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1765| [OH_NativeBuffer_ColorSpace](../apis-arkgraphics2d/capi-buffer-common-h.md#oh_nativebuffer_colorspace)* colorSpace | 当前的OH_NativeBuffer_ColorSpace。 | 1766 1767**返回：** 1768 1769| 类型 | 说明 | 1770| -- | -- | 1771| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1772 1773### OH_CaptureSession_SetActiveColorSpace() 1774 1775``` 1776Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace(Camera_CaptureSession* session,OH_NativeBuffer_ColorSpace colorSpace) 1777``` 1778 1779**描述** 1780 1781设置当前色彩空间。 1782 1783**起始版本：** 12 1784 1785 1786**参数：** 1787 1788| 参数项 | 描述 | 1789| -- | -- | 1790| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1791| [OH_NativeBuffer_ColorSpace](../apis-arkgraphics2d/capi-buffer-common-h.md#oh_nativebuffer_colorspace) colorSpace | 要设置的目标OH_NativeBuffer_ColorSpace。 | 1792 1793**返回：** 1794 1795| 类型 | 说明 | 1796| -- | -- | 1797| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1798 1799### OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback() 1800 1801``` 1802Camera_ErrorCode OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange) 1803``` 1804 1805**描述** 1806 1807注册设备切换事件回调。 1808 1809**起始版本：** 13 1810 1811 1812**参数：** 1813 1814| 参数项 | 描述 | 1815| -- | -- | 1816| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1817| [OH_CaptureSession_OnAutoDeviceSwitchStatusChange](#oh_capturesession_onautodeviceswitchstatuschange) autoDeviceSwitchStatusChange | 要注册的设备切换事件回调。 | 1818 1819**返回：** 1820 1821| 类型 | 说明 | 1822| -- | -- | 1823| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1824 1825### OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback() 1826 1827``` 1828Camera_ErrorCode OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session,OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange) 1829``` 1830 1831**描述** 1832 1833注销设备切换事件回调。 1834 1835**起始版本：** 13 1836 1837 1838**参数：** 1839 1840| 参数项 | 描述 | 1841| -- | -- | 1842| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1843| [OH_CaptureSession_OnAutoDeviceSwitchStatusChange](#oh_capturesession_onautodeviceswitchstatuschange) autoDeviceSwitchStatusChange | 要注销的设备切换事件回调。 | 1844 1845**返回：** 1846 1847| 类型 | 说明 | 1848| -- | -- | 1849| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1850 1851### OH_CaptureSession_IsAutoDeviceSwitchSupported() 1852 1853``` 1854Camera_ErrorCode OH_CaptureSession_IsAutoDeviceSwitchSupported(Camera_CaptureSession* session, bool* isSupported) 1855``` 1856 1857**描述** 1858 1859检查是否支持自动设备切换。 1860 1861**起始版本：** 13 1862 1863 1864**参数：** 1865 1866| 参数项 | 描述 | 1867| -- | -- | 1868| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1869| bool* isSupported | 是否支持自动设备切换的结果。返回true表示支持自动设备切换，返回false表示不支持。 | 1870 1871**返回：** 1872 1873| 类型 | 说明 | 1874| -- | -- | 1875| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1876 1877### OH_CaptureSession_EnableAutoDeviceSwitch() 1878 1879``` 1880Camera_ErrorCode OH_CaptureSession_EnableAutoDeviceSwitch(Camera_CaptureSession* session, bool enabled) 1881``` 1882 1883**描述** 1884 1885是否启用相机设备的自动切换。 1886 1887**起始版本：** 13 1888 1889 1890**参数：** 1891 1892| 参数项 | 描述 | 1893| -- | -- | 1894| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1895| bool enabled | 是否启用自动切换的标志。返回true表示启用自动切换，返回false表示不启用。 | 1896 1897**返回：** 1898 1899| 类型 | 说明 | 1900| -- | -- | 1901| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 1902 1903### OH_CaptureSession_RegisterSystemPressureLevelChangeCallback() 1904 1905``` 1906Camera_ErrorCode OH_CaptureSession_RegisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange) 1907``` 1908 1909**描述** 1910 1911注册系统压力状态变化回调。 1912 1913**起始版本：** 20 1914 1915 1916**参数：** 1917 1918| 参数项 | 描述 | 1919| -- | -- | 1920| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 1921| [OH_CaptureSession_OnSystemPressureLevelChange](#oh_capturesession_onsystempressurelevelchange) systemPressureLevelChange | 要注册的系统压力状态变化OH_CaptureSession_OnSystemPressureLevelChange回调。 | 1922 1923**返回：** 1924 1925| 类型 | 说明 | 1926| -- | -- | 1927| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1928 1929### OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback() 1930 1931``` 1932Camera_ErrorCode OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange) 1933``` 1934 1935**描述** 1936 1937注销系统压力状态变化回调。 1938 1939**起始版本：** 20 1940 1941 1942**参数：** 1943 1944| 参数项 | 描述 | 1945| -- | -- | 1946| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 1947| [OH_CaptureSession_OnSystemPressureLevelChange](#oh_capturesession_onsystempressurelevelchange) systemPressureLevelChange | 要注销的系统压力状态变化OH_CaptureSession_OnSystemPressureLevelChange回调。 | 1948 1949**返回：** 1950 1951| 类型 | 说明 | 1952| -- | -- | 1953| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 1954 1955### OH_CaptureSession_SetQualityPrioritization() 1956 1957``` 1958Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization(Camera_CaptureSession* session, Camera_QualityPrioritization qualityPrioritization) 1959``` 1960 1961**描述** 1962 1963设置录像质量优先级。<br> 默认为高质量，设置为功耗平衡将降低录像质量以减少功耗。实际功耗收益因平台而异。 1964 1965**起始版本：** 14 1966 1967 1968**参数：** 1969 1970| 参数项 | 描述 | 1971| -- | -- | 1972| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1973| [Camera_QualityPrioritization](capi-camera-h.md#camera_qualityprioritization) qualityPrioritization | 要设置的录像质量优先级，默认为高质量。 | 1974 1975**返回：** 1976 1977| 类型 | 说明 | 1978| -- | -- | 1979| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 1980 1981### OH_CaptureSession_IsMacroSupported() 1982 1983``` 1984Camera_ErrorCode OH_CaptureSession_IsMacroSupported(Camera_CaptureSession* session, bool* isSupported) 1985``` 1986 1987**描述** 1988 1989检查是否支持微距能力。 1990 1991**起始版本：** 19 1992 1993 1994**参数：** 1995 1996| 参数项 | 描述 | 1997| -- | -- | 1998| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 1999| bool* isSupported | 是否支持微距能力的结果。返回true表示支持微距能力，返回false表示不支持。 | 2000 2001**返回：** 2002 2003| 类型 | 说明 | 2004| -- | -- | 2005| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | <br> CAMERA_OK = 0：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 2006 2007### OH_CaptureSession_EnableMacro() 2008 2009``` 2010Camera_ErrorCode OH_CaptureSession_EnableMacro(Camera_CaptureSession* session, bool enabled) 2011``` 2012 2013**描述** 2014 2015是否启用相机设备的微距能力。 2016 2017**起始版本：** 19 2018 2019 2020**参数：** 2021 2022| 参数项 | 描述 | 2023| -- | -- | 2024| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2025| bool enabled | 是否启用微距能力的标志。返回true表示启用微距能力，返回false表示不启用。 | 2026 2027**返回：** 2028 2029| 类型 | 说明 | 2030| -- | -- | 2031| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | <br> CAMERA_OK = 0：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。<br> CAMERA_OPERATION_NOT_ALLOWED：不允许操作。 | 2032 2033### OH_CaptureSession_SetWhiteBalance() 2034 2035``` 2036Camera_ErrorCode OH_CaptureSession_SetWhiteBalance(Camera_CaptureSession* session, int32_t colorTemperature) 2037``` 2038 2039**描述** 2040 2041设置白平衡的色温。<br> 设置前，建议通过[OH_CaptureSession_GetWhiteBalanceRange](#oh_capturesession_getwhitebalancerange)获取支持配置的白平衡色温范围。 2042 2043**起始版本：** 20 2044 2045 2046**参数：** 2047 2048| 参数项 | 描述 | 2049| -- | -- | 2050| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2051| int32_t colorTemperature | 色温值，单位为K。 | 2052 2053**返回：** 2054 2055| 类型 | 说明 | 2056| -- | -- | 2057| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：设置成功。<br> CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 | 2058 2059### OH_CaptureSession_GetWhiteBalance() 2060 2061``` 2062Camera_ErrorCode OH_CaptureSession_GetWhiteBalance(Camera_CaptureSession* session, int32_t *colorTemperature) 2063``` 2064 2065**描述** 2066 2067获取当前白平衡色温值。 2068 2069**起始版本：** 20 2070 2071 2072**参数：** 2073 2074| 参数项 | 描述 | 2075| -- | -- | 2076| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2077| int32_t *colorTemperature | 色温值，单位为K。 | 2078 2079**返回：** 2080 2081| 类型 | 说明 | 2082| -- | -- | 2083| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：函数调用成功。<br> CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 | 2084 2085### OH_CaptureSession_GetWhiteBalanceMode() 2086 2087``` 2088Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode* whiteBalanceMode) 2089``` 2090 2091**描述** 2092 2093获取当前的白平衡模式。 2094 2095 2096**参数：** 2097 2098| 参数项 | 描述 | 2099| -- | -- | 2100| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2101| [Camera_WhiteBalanceMode](capi-camera-h.md#camera_whitebalancemode)* whiteBalanceMode | 白平衡模式。 | 2102 2103**返回：** 2104 2105| 类型 | 说明 | 2106| -- | -- | 2107| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：函数调用成功。<br> CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 | 2108 2109### OH_CaptureSession_IsWhiteBalanceModeSupported() 2110 2111``` 2112Camera_ErrorCode OH_CaptureSession_IsWhiteBalanceModeSupported(Camera_CaptureSession* session,Camera_WhiteBalanceMode whiteBalanceMode, bool* isSupported) 2113``` 2114 2115**描述** 2116 2117检查是否支持指定的白平衡模式。 2118 2119**起始版本：** 20 2120 2121 2122**参数：** 2123 2124| 参数项 | 描述 | 2125| -- | -- | 2126| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2127| [Camera_WhiteBalanceMode](capi-camera-h.md#camera_whitebalancemode) whiteBalanceMode | 指定的白平衡模式。 | 2128| bool* isSupported | 用于返回是否支持指定的白平衡模式，支持返回true，否则返回false。 | 2129 2130**返回：** 2131 2132| 类型 | 说明 | 2133| -- | -- | 2134| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：函数调用成功。<br> CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 | 2135 2136### OH_CaptureSession_SetWhiteBalanceMode() 2137 2138``` 2139Camera_ErrorCode OH_CaptureSession_SetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode whiteBalanceMode) 2140``` 2141 2142**描述** 2143 2144设置白平衡模式。 2145 2146**起始版本：** 20 2147 2148 2149**参数：** 2150 2151| 参数项 | 描述 | 2152| -- | -- | 2153| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2154| [Camera_WhiteBalanceMode](capi-camera-h.md#camera_whitebalancemode) whiteBalanceMode | 白平衡模式。 | 2155 2156**返回：** 2157 2158| 类型 | 说明 | 2159| -- | -- | 2160| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：设置成功。<br> CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 | 2161 2162### OH_CaptureSession_GetWhiteBalanceRange() 2163 2164``` 2165Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceRange(Camera_CaptureSession* session, int32_t *minColorTemperature, int32_t *maxColorTemperature) 2166``` 2167 2168**描述** 2169 2170获取支持配置的白平衡色温范围。 2171 2172**起始版本：** 20 2173 2174 2175**参数：** 2176 2177| 参数项 | 描述 | 2178| -- | -- | 2179| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2180| int32_t *minColorTemperature | 支持的最小色温值，单位为K。 | 2181| int32_t *maxColorTemperature | 支持的最大色温值，单位为K。 | 2182 2183**返回：** 2184 2185| 类型 | 说明 | 2186| -- | -- | 2187| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：函数调用成功。<br> CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 | 2188 2189### OH_CaptureSession_IsControlCenterSupported() 2190 2191``` 2192Camera_ErrorCode OH_CaptureSession_IsControlCenterSupported(Camera_CaptureSession* session, bool* isSupported) 2193``` 2194 2195**描述** 2196 2197检查是否支持相机控制器。 2198 2199**起始版本：** 20 2200 2201 2202**参数：** 2203 2204| 参数项 | 描述 | 2205| -- | -- | 2206| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2207| bool* isSupported | 是否支持相机控制器的结果。true表示支持，false表示不支持。 | 2208 2209**返回：** 2210 2211| 类型 | 说明 | 2212| -- | -- | 2213| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK = 0：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 2214 2215### OH_CaptureSession_GetSupportedEffectType() 2216 2217``` 2218Camera_ErrorCode OH_CaptureSession_GetSupportedEffectType(Camera_CaptureSession* session,Camera_ControlCenterEffectType** types, uint32_t* size) 2219``` 2220 2221**描述** 2222 2223获取相机控制器支持的效果类型。 2224 2225**起始版本：** 20 2226 2227 2228**参数：** 2229 2230| 参数项 | 描述 | 2231| -- | -- | 2232| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2233| [Camera_ControlCenterEffectType](capi-camera-h.md#camera_controlcentereffecttype)** types | 如果方法调用成功，将记录支持的Camera_ControlCenterEffectType列表。 | 2234| uint32_t* size | 如果方法调用成功，将记录支持的Camera_ControlCenterEffectType列表的大小。 | 2235 2236**返回：** 2237 2238| 类型 | 说明 | 2239| -- | -- | 2240| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 | 2241 2242### OH_CaptureSession_DeleteSupportedEffectType() 2243 2244``` 2245Camera_ErrorCode OH_CaptureSession_DeleteSupportedEffectType(Camera_CaptureSession* session,Camera_ControlCenterEffectType* types, uint32_t size) 2246``` 2247 2248**描述** 2249 2250删除相机控制器效果类型列表。 2251 2252**起始版本：** 20 2253 2254 2255**参数：** 2256 2257| 参数项 | 描述 | 2258| -- | -- | 2259| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2260| [Camera_ControlCenterEffectType](capi-camera-h.md#camera_controlcentereffecttype)* types | 如果方法调用成功，要删除的Camera_ControlCenterEffectType列表。 | 2261| uint32_t size | 要删除的Camera_ControlCenterEffectType列表的大小。 | 2262 2263**返回：** 2264 2265| 类型 | 说明 | 2266| -- | -- | 2267| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 2268 2269### OH_CaptureSession_EnableControlCenter() 2270 2271``` 2272Camera_ErrorCode OH_CaptureSession_EnableControlCenter(Camera_CaptureSession* session, bool enabled) 2273``` 2274 2275**描述** 2276 2277是否启用相机控制器。 2278 2279**起始版本：** 20 2280 2281 2282**参数：** 2283 2284| 参数项 | 描述 | 2285| -- | -- | 2286| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | Camera_CaptureSession实例。 | 2287| bool enabled | 是否启用相机控制器的标志。true表示启用，false表示禁用。 | 2288 2289**返回：** 2290 2291| 类型 | 说明 | 2292| -- | -- | 2293| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK = 0：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。<br> CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。<br> CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。 | 2294 2295### OH_CaptureSession_RegisterControlCenterEffectStatusChangeCallback() 2296 2297``` 2298Camera_ErrorCode OH_CaptureSession_RegisterControlCenterEffectStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange) 2299``` 2300 2301**描述** 2302 2303注册相机控制器效果激活状态变化回调。 2304 2305**起始版本：** 20 2306 2307 2308**参数：** 2309 2310| 参数项 | 描述 | 2311| -- | -- | 2312| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 2313| [OH_CaptureSession_OnControlCenterEffectStatusChange](#oh_capturesession_oncontrolcentereffectstatuschange) controlCenterEffectStatusChange | 要注册的相机控制器效果激活状态变化OH_CaptureSession_OnControlCenterEffectStatusChange回调。 | 2314 2315**返回：** 2316 2317| 类型 | 说明 | 2318| -- | -- | 2319| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 2320 2321### OH_CaptureSession_UnregisterControlCenterEffectStatusChangeCallback() 2322 2323``` 2324Camera_ErrorCode OH_CaptureSession_UnregisterControlCenterEffectStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange) 2325``` 2326 2327**描述** 2328 2329注销相机控制器效果激活状态变化回调。 2330 2331**起始版本：** 20 2332 2333 2334**参数：** 2335 2336| 参数项 | 描述 | 2337| -- | -- | 2338| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 传递回调的Camera_CaptureSession实例。 | 2339| [OH_CaptureSession_OnControlCenterEffectStatusChange](#oh_capturesession_oncontrolcentereffectstatuschange) controlCenterEffectStatusChange | 要注销的相机控制器效果激活状态变化OH_CaptureSession_OnControlCenterEffectStatusChange回调。 | 2340 2341**返回：** 2342 2343| 类型 | 说明 | 2344| -- | -- | 2345| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 2346 2347### OH_CaptureSession_OnMacroStatusChange() 2348 2349``` 2350 typedef void (*OH_CaptureSession_OnMacroStatusChange)(Camera_CaptureSession* session, bool isMacroDetected) 2351``` 2352 2353**描述** 2354 2355相机会话微距状态改变回调。 2356 2357**起始版本：** 20 2358 2359 2360**参数：** 2361 2362| 参数项 | 描述 | 2363| -- | -- | 2364| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 指向Camera_CaptureSession实例的指针。 | 2365| bool isMacroDetected | 是否进入超级微距，true表示进入超级微距，false表示未进入超级微距。 | 2366 2367### OH_CaptureSession_RegisterMacroStatusChangeCallback() 2368 2369``` 2370 Camera_ErrorCode OH_CaptureSession_RegisterMacroStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnMacroStatusChange macroStatusChange) 2371``` 2372 2373**描述** 2374 2375注册相机会话微距状态改变回调函数。 2376 2377**起始版本：** 20 2378 2379 2380**参数：** 2381 2382| 参数项 | 描述 | 2383| -- | -- | 2384| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 指向Camera_CaptureSession实例的指针。 | 2385| [OH_CaptureSession_OnMacroStatusChange](#oh_capturesession_onmacrostatuschange) macroStatusChange | 微距状态改变回调函数。 | 2386 2387**返回：** 2388 2389| 类型 | 说明 | 2390| -- | -- | 2391| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 2392 2393### OH_CaptureSession_UnregisterMacroStatusChangeCallback() 2394 2395``` 2396 Camera_ErrorCode OH_CaptureSession_UnregisterMacroStatusChangeCallback(Camera_CaptureSession* session,OH_CaptureSession_OnMacroStatusChange macroStatusChange) 2397``` 2398 2399**描述** 2400 2401取消注册相机会话微距状态改变回调函数。 2402 2403**起始版本：** 20 2404 2405 2406**参数：** 2407 2408| 参数项 | 描述 | 2409| -- | -- | 2410| [Camera_CaptureSession](capi-oh-camera-camera-capturesession.md)* session | 指向Camera_CaptureSession实例的指针。 | 2411| [OH_CaptureSession_OnMacroStatusChange](#oh_capturesession_onmacrostatuschange) macroStatusChange | 微距状态改变回调函数。 | 2412 2413**返回：** 2414 2415| 类型 | 说明 | 2416| -- | -- | 2417| [Camera_ErrorCode](capi-camera-h.md#camera_errorcode) | CAMERA_OK：方法调用成功。<br> CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 | 2418 2419 2420