AVDemuxer

概述

AVDemuxer模块提供用于音视频解封装功能的函数。

@syscap SystemCapability.Multimedia.Media.Spliter

起始版本:

10

汇总

文件

名称 描述
native_avdemuxer.h 声明用于音视频解封装的Native API。
引用文件:<multimedia/player_framework/native_avdemuxer.h>
:libnative_media_avdemuxer.so

函数

名称 描述
*OH_AVDemuxer_CreateWithSource (OH_AVSource *source) 通过source实例对象创建OH_AVDemuxer实例对象。
OH_AVDemuxer_Destroy (OH_AVDemuxer *demuxer) 销毁OH_AVDemuxer实例并清理内部资源。
OH_AVDemuxer_SelectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex) 选中指定轨道,解封装器将会从该轨道中读取数据。
OH_AVDemuxer_UnselectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex) 取消选择指定轨道,未选中的轨道的数据不会被解封装器读取。
OH_AVDemuxer_ReadSample (OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVMemory *sample, OH_AVCodecBufferAttr *info) 从选中轨道中获取当前位置压缩帧及相关信息。
OH_AVDemuxer_SeekToTime (OH_AVDemuxer *demuxer, int64_t millisecond, OH_AVSeekMode mode) 根据设定的跳转模式,将所有选中的轨道到指定时间附近。

函数说明

OH_AVDemuxer_CreateWithSource()

OH_AVDemuxer* OH_AVDemuxer_CreateWithSource (OH_AVSource *source)

描述:

通过source实例对象创建OH_AVDemuxer实例对象。可以通过调用 OH_AVDemuxer_Destroy 释放实例。

@syscap SystemCapability.Multimedia.Media.Spliter

参数:

名称 描述
source 指向OH_AVSource实例的指针。

返回:

返回一个指向OH_AVDemuxer实例的指针。

起始版本:

10

OH_AVDemuxer_Destroy()

OH_AVErrCode OH_AVDemuxer_Destroy (OH_AVDemuxer *demuxer)

描述:

销毁OH_AVDemuxer实例并清理内部资源。同一实例只能被销毁一次。

销毁的实例在被重新创建之前不能再被使用.。建议实例销毁成功后将指针置为NULL。

@syscap SystemCapability.Multimedia.Media.Spliter

参数:

名称 描述
demuxer 指向OH_AVDemuxer实例的指针。

返回:

执行成功返回AV_ERR_OK, 否则返回具体错误码,请参阅OH_AVErrCode

起始版本:

10

OH_AVDemuxer_ReadSample()

OH_AVErrCode OH_AVDemuxer_ReadSample (OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVMemory *sample, OH_AVCodecBufferAttr *info)

描述:

从选中轨道中获取当前位置压缩帧及相关信息。

读取轨道帧数据前,轨道必须被选中。调用接口后解封装器 将自动前进到下一帧。

@syscap SystemCapability.Multimedia.Media.Spliter

参数:

名称 描述
demuxer 指向OH_AVDemuxer实例的指针。
trackIndex 本次读取压缩帧的轨道的索引。
sample 指向OH_AVMemory实例的指针,用于储存压缩帧数据。
info 指向OH_AVCodecBufferAttr实例的指针,用于储存压缩帧的相关信息。

返回:

执行成功返回AV_ERR_OK, 否则返回具体错误码,请参阅OH_AVErrCode

起始版本:

10

OH_AVDemuxer_SeekToTime()

OH_AVErrCode OH_AVDemuxer_SeekToTime (OH_AVDemuxer *demuxer, int64_t millisecond, OH_AVSeekMode mode)

描述:

根据设定的跳转模式,将所有选中的轨道到指定时间附近。

@syscap SystemCapability.Multimedia.Media.Spliter

参数:

名称 描述
demuxer 指向OH_AVDemuxer实例的指针。
millisecond 期望跳转位置对应的时间,单位为毫秒,该时间戳是相对文件开始的位置。
mode 跳转的模式,参考OH_AVSeekMode。

返回:

执行成功返回AV_ERR_OK, 否则返回具体错误码,请参阅OH_AVErrCode

起始版本:

10

OH_AVDemuxer_SelectTrackByID()

OH_AVErrCode OH_AVDemuxer_SelectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex)

描述:

选中指定轨道,解封装器将会从该轨道中读取数据。

通过多次调用接口并传入不同轨道的索引来 选中多个轨道。

调用OH_AVDemuxer_ReadSample时只会读取被选中的轨道中数据,同一轨道被选择多次时,接口会返回AV_ERR_OK,并且只会生效一次。

@syscap SystemCapability.Multimedia.Media.Spliter

参数:

名称 描述
demuxer 指向OH_AVDemuxer实例的指针。
trackIndex 需选择的轨道的索引。

返回:

执行成功返回AV_ERR_OK, 否则返回具体错误码,请参阅OH_AVErrCode

起始版本:

10

OH_AVDemuxer_UnselectTrackByID()

OH_AVErrCode OH_AVDemuxer_UnselectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex)

描述:

取消选择指定轨道,未选中的轨道的数据不会被解封装器读取。

通过多次调用接口并传入不同轨道的索引来取消对多个轨道的选择。

同一轨道被多次取消选择时,接口会返回AV_ERR_OK,并且只会生效一次。

@syscap SystemCapability.Multimedia.Media.Spliter

参数:

名称 描述
demuxer 指向OH_AVDemuxer实例的指针。
trackIndex 需取消选择的轨道的索引。

返回:

执行成功返回AV_ERR_OK, 否则返回具体错误码,请参阅OH_AVErrCode

起始版本:

10