VideoDecoder
概述
VideoDecoder模块提供用于视频解码的函数。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
汇总
文件
名称 | 描述 |
---|---|
native_avcodec_videodecoder.h | 声明用于视频解码的Native API。 |
函数
函数说明
OH_VideoDecoder_Configure()
OH_AVErrCode OH_VideoDecoder_Configure (OH_AVCodec *codec, OH_AVFormat *format )
描述
配置视频解码器,通常需要配置解码视频轨迹的描述信息,这些信息可以从OH_AVSource中提取。在调用准备之前,必须调用此接口。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
format | 指向OH_AVFormat的指针,用于给出要解码的视频轨道的描述。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_CreateByMime()
OH_AVCodec* OH_VideoDecoder_CreateByMime (const char *mime)
描述
从MIME类型创建视频解码器实例,大多数情况下建议使用。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
mime | MIME类型描述字符串,请参阅AVCODEC_MIMETYPE。 |
返回:
返回一个指向视频解码实例的指针。
OH_VideoDecoder_CreateByName()
OH_AVCodec* OH_VideoDecoder_CreateByName (const char *name)
描述
通过视频解码器名称创建视频解码器实例。使用此接口的前提是知道解码器的确切名称。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
name | 视频解码器名称。 |
返回:
返回指向视频解码实例的指针。
OH_VideoDecoder_Destroy()
OH_AVErrCode OH_VideoDecoder_Destroy (OH_AVCodec *codec)
描述
清理解码器内部资源,销毁解码器实例。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_Flush()
OH_AVErrCode OH_VideoDecoder_Flush (OH_AVCodec *codec)
描述
清除解码器中缓存的输入和输出数据。 调用此接口后,以前通过异步回调上报的所有缓冲区索引都将失效,请确保不要访问这些索引对应的缓冲区。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_FreeOutputBuffer()
OH_AVErrCode OH_VideoDecoder_FreeOutputBuffer (OH_AVCodec *codec, uint32_t index )
描述
将处理后的输出缓冲区返回到解码器。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 11
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
index | 输出Buffer对应的索引值。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_FreeOutputData()
OH_AVErrCode OH_VideoDecoder_FreeOutputData (OH_AVCodec *codec, uint32_t index )
描述
将处理后的输出缓冲区返回到解码器。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
废弃版本: 11
替代接口:OH_VideoDecoder_FreeOutputBuffer
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
index | 输出Buffer对应的索引值。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_GetOutputDescription()
OH_AVFormat* OH_VideoDecoder_GetOutputDescription (OH_AVCodec *codec)
描述
获取解码器输出数据的描述信息。
需要注意的是,返回值指向的OH_AVFormat实例的生命周期需要调用者手动释放。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
返回指向OH_AVFormat实例的指针。
OH_VideoDecoder_IsValid()
OH_AVErrCode OH_VideoDecoder_IsValid (OH_AVCodec *codec, bool *isValid )
描述
检查当前解码实例是否有效。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 10
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
isValid | 输出参数。指向布尔实例的指针,如果解码器实例有效,则为true,如果解码器实例无效,则为false。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_Prepare()
OH_AVErrCode OH_VideoDecoder_Prepare (OH_AVCodec *codec)
描述
要准备解码器的内部资源,在调用该接口之前,必须调用Configure接口。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_PushInputBuffer()
OH_AVErrCode OH_VideoDecoder_PushInputBuffer (OH_AVCodec *codec, uint32_t index )
描述
将填充数据的输入缓冲区提交给视频解码器。
输入回调将报告可用的输入缓冲区和相应的索引值,请参阅OH_AVCodecOnNeedInputBuffer。 一旦具有指定索引的缓冲区提交到视频解码器,则无法再次访问缓冲区,直到再次收到输入回调,报告具有相同索引的缓冲区可用。
此外,对于某些解码器,需要在开始时向解码器输入编解码特定数据,以初始化解码器的解码过程,如H264格式的PPS/SPS数据。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 11
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
index | 输入Buffer对应的索引值。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_PushInputData()
OH_AVErrCode OH_VideoDecoder_PushInputData (OH_AVCodec *codec, uint32_t index, OH_AVCodecBufferAttr attr )
描述
将填充数据的输入缓冲区提交给视频解码器。
输入回调将报告可用的输入缓冲区和相应的索引值,请参阅OH_AVCodecOnNeedInputData。 一旦具有指定索引的缓冲区提交到视频解码器,则无法再次访问缓冲区,直到再次收到输入回调,报告具有相同索引的缓冲区可用。
此外,对于某些解码器,需要在开始时向解码器输入编解码特定数据,以初始化解码器的解码过程,如H264格式的PPS/SPS数据。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
废弃版本: 11
替代接口:OH_VideoDecoder_PushInputBuffer
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
index | 输入Buffer对应的索引值。 |
attr | 描述缓冲区中包含的数据的信息。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_RegisterCallback()
OH_AVErrCode OH_VideoDecoder_RegisterCallback (OH_AVCodec *codec, OH_AVCodecCallback callback, void *userData )
描述
注册异步回调函数,让应用可以响应视频解码器生成的事件。在调用Prepare之前,必须调用此接口。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 11
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码器实例的指针。 |
callback | 所有回调函数的集合,请参见OH_AVCodecCallback。 |
userData | 用户特定数据。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_RenderOutputBuffer()
OH_AVErrCode OH_VideoDecoder_RenderOutputBuffer (OH_AVCodec *codec, uint32_t index )
描述
将处理后的输出缓冲返回给解码器,并通知解码器完成在输出表面上渲染,输出缓冲包含解码数据。
如果之前没有配置输出表面,则调用此接口仅将指定索引对应的输出缓冲区返回给解码器。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 11
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
index | 输出Buffer对应的索引值。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_RenderOutputData()
OH_AVErrCode OH_VideoDecoder_RenderOutputData (OH_AVCodec *codec, uint32_t index )
描述
将处理后的输出Buffer返回给解码器,并通知解码器完成在输出表面上渲染Buffer中包含的解码数据。
如果之前没有配置输出表面,则调用此接口仅将指定索引对应的输出缓冲区返回给解码器。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
废弃版本: 11
替代接口:OH_VideoDecoder_RenderOutputBuffer
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
index | 输出Buffer对应的索引值。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_Reset()
OH_AVErrCode OH_VideoDecoder_Reset (OH_AVCodec *codec)
描述
重置解码器。如果要继续解码,需要再次调用Configure接口配置解码器实例。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_SetCallback()
OH_AVErrCode OH_VideoDecoder_SetCallback (OH_AVCodec *codec, OH_AVCodecAsyncCallback callback, void *userData )
描述
设置异步回调函数,让应用可以响应视频解码器生成的事件。在调用Prepare之前,必须调用此接口。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
废弃版本: 11
替代接口:OH_VideoDecoder_RegisterCallback
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
callback | 所有回调函数的集合,请参阅OH_AVCodecAsyncCallback。 |
userData | 用户特定数据。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_SetDecryptionConfig()
OH_AVErrCode OH_VideoDecoder_SetDecryptionConfig (OH_AVCodec *codec, MediaKeySession *mediaKeySession, bool secureVideoPath)
描述
设置解密配置。在调用准备之前,可选择调用此接口。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 11
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
mediaKeySession | 指向带有解密功能的DRM会话实例的指针,请参阅MediaKeySession。 |
secureVideoPath | 安全视频通路。指定安全视频通路为true,否则为false。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_SetParameter()
OH_AVErrCode OH_VideoDecoder_SetParameter (OH_AVCodec *codec, OH_AVFormat *format )
描述
设置解码器的动态参数。
注意,该接口只能在解码器启动后调用。同时,参数配置错误可能会导致解码失败。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
format | 指向OH_AVFormat实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_SetSurface()
OH_AVErrCode OH_VideoDecoder_SetSurface (OH_AVCodec *codec, OHNativeWindow *window )
描述
指定输出表面以提供视频解码输出,必须在调用Prepare之前调用此接口。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
window | 指向OHNativeWindow实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_Start()
OH_AVErrCode OH_VideoDecoder_Start (OH_AVCodec *codec)
描述
启动解码器,准备成功后必须调用此接口。成功启动后,解码器将开始报告注册的回调事件。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。
OH_VideoDecoder_Stop()
OH_AVErrCode OH_VideoDecoder_Stop (OH_AVCodec *codec)
描述
停止解码器。停止后,可以通过Start重新进入Started状态。
需要注意的是,如果编解码器特定数据以前已输入到解码器,则需要再次输入。
系统能力: SystemCapability.Multimedia.Media.VideoDecoder
起始版本: 9
参数:
名称 | 描述 |
---|---|
codec | 指向视频解码实例的指针。 |
返回:
如果执行成功,则返回AV_ERR_OK,否则返回特定错误代码,请参阅OH_AVErrCode。