harmony 鸿蒙capture_session.h
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|捕获会话的错误码。|
参考:
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 鸿蒙Interface (AutoDeviceSwitch)
harmony 鸿蒙Interface (AutoDeviceSwitchQuery)
harmony 鸿蒙Interface (AutoExposure)
harmony 鸿蒙Interface (AutoExposureQuery)
harmony 鸿蒙Interface (CameraInput)
harmony 鸿蒙Interface (CameraManager)
harmony 鸿蒙Interface (CameraOutput)
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
8、 golang
-
9、 openharmony
-
10、 Vue中input框自动聚焦