video_processing_types.h

概述

视频处理类型定义。

库： libvideo_processing.so

系统能力： SystemCapability.Multimedia.VideoProcessingEngine

起始版本： 12

相关模块： VideoProcessing

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |VideoProcessing_ColorSpaceInfo|VideoProcessing_ColorSpaceInfo|视频颜色空间信息数据结构。| |OH_VideoProcessing|OH_VideoProcessing|定义视频处理对象。
定义一个OH_VideoProcessing空指针，调用OH_VideoProcessing_Create创建视频处理实例，该指针在创建实例之前必须为空。用户可以对不同的处理类型创建不同的视频处理实例。| |VideoProcessing_Callback|VideoProcessing_Callback|视频处理回调对象类型。
定义一个VideoProcessing_Callback空指针，调用OH_VideoProcessingCallback_Create来创建一个回调对象。创建之前该指针必须为空。通过调用OH_VideoProcessing_RegisterCallback来向视频处理实例注册回调对象。|

枚举

|名称|typedef关键字|描述| |–|–|–| |VideoDetailEnhancer_QualityLevel|VideoDetailEnhancer_QualityLevel|用于细节增强的质量等级。| |VideoProcessing_ErrorCode|VideoProcessing_ErrorCode|视频处理错误码。| |VideoProcessing_State|VideoProcessing_State|视频处理状态。
视频处理状态通过回调函数OH_VideoProcessingCallback_OnState进行报告。|

函数

|名称|typedef关键字|描述| |–|–|–| |typedef void (*OH_VideoProcessingCallback_OnError)(OH_VideoProcessing* videoProcessor,VideoProcessing_ErrorCode error, void* userData)|OH_VideoProcessingCallback_OnError|视频处理过程中报告错误的回调函数指针。| |typedef void (*OH_VideoProcessingCallback_OnState)(OH_VideoProcessing* videoProcessor, VideoProcessing_State state,void* userData)|OH_VideoProcessingCallback_OnState|报告视频处理状态的回调函数指针。
OH_VideoProcessing_Start成功调用之后状态会变为VideoProcessing_State.VIDEO_PROCESSING_STATE_RUNNING。调用OH_VideoProcessing_Stop，所有的缓存buffer处理完成后，状态会变为VideoProcessing_State.VIDEO_PROCESSING_STATE_STOPPED。| |typedef void (*OH_VideoProcessingCallback_OnNewOutputBuffer)(OH_VideoProcessing* videoProcessor, uint32_t index,void* userData)|OH_VideoProcessingCallback_OnNewOutputBuffer|报告输出buffer已填充好数据的回调函数指针。
每个新输出buffer填充好数据之后该buffer的索引就会报告给用户。调用OH_VideoProcessing_RenderOutputBuffer根据索引来处理渲染并输出该buffer。如果未注册该函数，则输出buffer填充好数据后不会报告用户，而是直接进行处理渲染并输出。|

变量

|名称|描述| |–|–| |const int32_t VIDEO_PROCESSING_TYPE_COLOR_SPACE_CONVERSION|表示创建颜色空间转换视频处理实例。
调用OH_VideoProcessing_Create创建颜色空间转换视频处理实例，如果不支持该能力返回VideoProcessing_ErrorCode.VIDEO_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
起始版本： 12| |const int32_t VIDEO_PROCESSING_TYPE_METADATA_GENERATION|表示创建元数据生成视频处理实例。
调用OH_VideoProcessing_Create创建元数据生成视频处理实例，如果不支持该能力返回VideoProcessing_ErrorCode.VIDEO_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
起始版本： 12| |const int32_t VIDEO_PROCESSING_TYPE_DETAIL_ENHANCER|表示创建细节增强视频处理实例。
调用OH_VideoProcessing_Create创建细节增强视频处理实例，如果不支持该能力返回VideoProcessing_ErrorCode.VIDEO_PROCESSING_ERROR_UNSUPPORTED_PROCESSING。
起始版本： 12| |const char* VIDEO_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL|指定视频细节增强的质量等级，参考VideoDetailEnhancer_QualityLevel查看具体取值。
调用OH_VideoProcessing_SetParameter设置质量等级。
调用OH_VideoProcessing_GetParameter获取当前质量等级。
起始版本： 12|

枚举类型说明

VideoDetailEnhancer_QualityLevel

enum VideoDetailEnhancer_QualityLevel

描述

用于细节增强的质量等级。参数VIDEO_DETAIL_ENHANCER_PARAMETER_KEY_QUALITY_LEVEL的具体取值，设置方法详见开发指南。

起始版本： 12

|枚举项|描述| |–|–| |VIDEO_DETAIL_ENHANCER_QUALITY_LEVEL_NONE|无细节增强。| |VIDEO_DETAIL_ENHANCER_QUALITY_LEVEL_LOW|低质量等级细节增强，速度较快，默认设置。| |VIDEO_DETAIL_ENHANCER_QUALITY_LEVEL_MEDIUM|中等质量等级细节增强，速度适中。| |VIDEO_DETAIL_ENHANCER_QUALITY_LEVEL_HIGH|高质量等级细节增强，速度相对较慢。|

参考：

OH_VideoProcessing_SetParameter

OH_VideoProcessing_GetParameter

VideoProcessing_ErrorCode

enum VideoProcessing_ErrorCode

描述

视频处理错误码。

起始版本： 12

|枚举项|描述| |–|–| |VIDEO_PROCESSING_SUCCESS|处理成功。| |VIDEO_PROCESSING_ERROR_INVALID_PARAMETER = 401|输入参数无效。以下情况都会返回该错误码：
1. 无效的输入或输出视频buffer，视频buffer为空。
2. 无效的参数，参数为空。
3. 无效的处理类型。| |VIDEO_PROCESSING_ERROR_UNKNOWN = 29210001|未知错误，比如GPU计算失败或memcpy失败。| |VIDEO_PROCESSING_ERROR_INITIALIZE_FAILED|视频处理全局环境初始化失败，比如初始化GPU环境失败。| |VIDEO_PROCESSING_ERROR_CREATE_FAILED|创建视频处理实例失败，比如实例总数超出上限。| |VIDEO_PROCESSING_ERROR_PROCESS_FAILED|处理过程失败，比如处理时间超时。| |VIDEO_PROCESSING_ERROR_UNSUPPORTED_PROCESSING|不支持的处理类型，可以调用OH_VideoProcessing_IsXXXSupported来检查是否支持这种处理。| |VIDEO_PROCESSING_ERROR_OPERATION_NOT_PERMITTED|不允许的操作，比如不满足调用接口所需的运行状态下调用该接口。| |VIDEO_PROCESSING_ERROR_NO_MEMORY|内存不足。| |VIDEO_PROCESSING_ERROR_INVALID_INSTANCE|视频处理实例无效，比如视频处理实例为空实例。| |VIDEO_PROCESSING_ERROR_INVALID_VALUE|输入值无效，以下情况都会造成这种错误：
1. 视频buffer宽高太大或者颜色空间错误。
2. 参数包含无效的值，比如细节增强的质量等级错误。|

VideoProcessing_State

enum VideoProcessing_State

描述

视频处理状态。

视频处理状态通过回调函数OH_VideoProcessingCallback_OnState进行报告。

起始版本： 12

|枚举项|描述| |–|–| |VIDEO_PROCESSING_STATE_RUNNING|视频处理进行中。| |VIDEO_PROCESSING_STATE_STOPPED|视频处理已停止。|

函数说明

OH_VideoProcessingCallback_OnError()

typedef void (*OH_VideoProcessingCallback_OnError)(OH_VideoProcessing* videoProcessor,VideoProcessing_ErrorCode error, void* userData)

描述

视频处理过程中报告错误的回调函数指针。

错误码VideoProcessing_ErrorCode：

VIDEO_PROCESSING_ERROR_UNSUPPORTED_PROCESSING，不支持的处理，比如不支持输入输出的颜色空间类型转换。

VIDEO_PROCESSING_ERROR_INVALID_VALUE，无效的视频属性，比如视频的颜色空间无效。

VIDEO_PROCESSING_ERROR_NO_MEMORY，内存不足。

VIDEO_PROCESSING_ERROR_PROCESS_FAILED，处理过程中出错。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_VideoProcessing* videoProcessor|视频处理实例。| |VideoProcessing_ErrorCode error|报告给用户的错误码。| | void* userData|用户的自定义数据。|

OH_VideoProcessingCallback_OnState()

typedef void (*OH_VideoProcessingCallback_OnState)(OH_VideoProcessing* videoProcessor, VideoProcessing_State state,void* userData)

描述

报告视频处理状态的回调函数指针。

OH_VideoProcessing_Start成功调用之后状态会变为VideoProcessing_State.VIDEO_PROCESSING_STATE_RUNNING。调用OH_VideoProcessing_Stop，所有的缓存buffer处理完成后，状态会变为VideoProcessing_State.VIDEO_PROCESSING_STATE_STOPPED。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_VideoProcessing* videoProcessor|视频处理实例。| | VideoProcessing_State state|视频处理状态。| |void* userData|用户的自定义数据。|

OH_VideoProcessingCallback_OnNewOutputBuffer()

typedef void (*OH_VideoProcessingCallback_OnNewOutputBuffer)(OH_VideoProcessing* videoProcessor, uint32_t index,void* userData)

描述

报告输出buffer已填充好数据的回调函数指针。

每个新输出buffer填充好数据之后该buffer的索引就会报告给用户。调用OH_VideoProcessing_RenderOutputBuffer根据索引来处理渲染并输出该buffer。如果未注册该函数，则输出buffer填充好数据后不会报告用户，而是直接进行处理渲染并输出。

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_VideoProcessing* videoProcessor|视频处理实例。| | uint32_t index|新输出buffer的索引。| |void* userData|用户自定义的数据。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Media Kit（媒体服务）

harmony 鸿蒙Interface (AVImageGenerator)

harmony 鸿蒙Interface (AVMetadataExtractor)

harmony 鸿蒙Interface (AVPlayer)

harmony 鸿蒙Interface (AVRecorder)

harmony 鸿蒙Interface (AVScreenCaptureRecorder)

harmony 鸿蒙Interface (AVTranscoder)

harmony 鸿蒙废弃的Interface (AudioPlayer, deprecated)

harmony 鸿蒙废弃的Interface (AudioRecorder, deprecated)

harmony 鸿蒙Interface (MediaSource)