AVDemuxer
概述
AVDemuxer模块提供用于音视频解封装功能的函数。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
汇总
文件
| 名称 | 描述 |
|---|---|
| native_avdemuxer.h | 声明用于音视频解封装的Native API。 引用文件：<multimedia/player_framework/native_avdemuxer.h> 库：libnative_media_avdemuxer.so |
函数
| 名称 | 描述 |
|---|---|
| OH_AVDemuxer * OH_AVDemuxer_CreateWithSource (OH_AVSource *source) | 通过source实例对象创建OH_AVDemuxer实例对象。 |
| OH_AVErrCode OH_AVDemuxer_Destroy (OH_AVDemuxer *demuxer) | 销毁OH_AVDemuxer实例并清理内部资源。 |
| OH_AVErrCode OH_AVDemuxer_SelectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex) | 选中指定轨道，解封装器将会从该轨道中读取数据。 |
| OH_AVErrCode OH_AVDemuxer_UnselectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex) | 取消选择指定轨道，未选中的轨道的数据不会被解封装器读取。 |
| OH_AVErrCode OH_AVDemuxer_ReadSample (OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVMemory *sample, OH_AVCodecBufferAttr *info) | 从选中轨道中获取当前位置压缩帧及相关信息。 |
| OH_AVErrCode OH_AVDemuxer_ReadSampleBuffer (OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVBuffer *sample) | 从选中轨道中获取当前位置压缩帧及相关信息。 |
| OH_AVErrCode OH_AVDemuxer_SeekToTime (OH_AVDemuxer *demuxer, int64_t millisecond, OH_AVSeekMode mode) | 根据设定的跳转模式，将所有选中的轨道到指定时间附近。 |
| OH_AVErrCode OH_AVDemuxer_SetMediaKeySystemInfoCallback (OH_AVDemuxer *demuxer, DRM_MediaKeySystemInfoCallback callback) | 设置异步DRM信息回调函数。 |
| OH_AVErrCode OH_AVDemuxer_GetMediaKeySystemInfo (OH_AVDemuxer *demuxer, DRM_MediaKeySystemInfo *mediaKeySystemInfo) | 获取DRM信息。 |
函数说明
OH_AVDemuxer_CreateWithSource()
OH_AVDemuxer* OH_AVDemuxer_CreateWithSource (OH_AVSource *source)
描述
通过source实例对象创建OH_AVDemuxer实例对象。可以通过调用OH_AVDemuxer_Destroy释放实例。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| source | 指向OH_AVSource实例的指针。 |
返回：
返回一个指向OH_AVDemuxer实例的指针。
OH_AVDemuxer_Destroy()
OH_AVErrCode OH_AVDemuxer_Destroy (OH_AVDemuxer *demuxer)
描述
销毁OH_AVDemuxer实例并清理内部资源。同一实例只能被销毁一次。
注意，销毁的实例在被重新创建之前不能再被使用。建议实例销毁成功后将指针置为NULL。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode
OH_AVDemuxer_GetMediaKeySystemInfo()
OH_AVErrCode OH_AVDemuxer_GetMediaKeySystemInfo (OH_AVDemuxer *demuxer, DRM_MediaKeySystemInfo *mediaKeySystemInfo)
描述
获取DRM信息。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 11
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| mediaKeySystemInfo | 指向DRM信息的指针，请参阅DRM_MediaKeySystemInfo。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。
OH_AVDemuxer_ReadSample()
OH_AVErrCode OH_AVDemuxer_ReadSample (OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVMemory *sample, OH_AVCodecBufferAttr *info)
描述
从选中轨道中获取当前位置压缩帧及相关信息。
注意，读取轨道帧数据前，轨道必须被选中。调用接口后解封装器将自动前进到下一帧。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
废弃版本： 11
替代接口：OH_AVDemuxer_ReadSampleBuffer
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| trackIndex | 本次读取压缩帧的轨道的索引。 |
| sample | 指向OH_AVMemory实例的指针，用于储存压缩帧数据。 |
| info | 指向OH_AVCodecBufferAttr实例的指针，用于储存压缩帧的相关信息。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。
OH_AVDemuxer_ReadSampleBuffer()
OH_AVErrCode OH_AVDemuxer_ReadSampleBuffer (OH_AVDemuxer *demuxer, uint32_t trackIndex, OH_AVBuffer *sample)
描述
从选中轨道中获取当前位置压缩帧及相关信息。
注意，读取轨道帧数据前，轨道必须被选中。调用接口后解封装器将自动前进到下一帧。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 11
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| trackIndex | 本次读取压缩帧的轨道的索引。 |
| sample | 指向OH_AVBuffer实例的指针，用于储存压缩帧数据以及相关信息。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。
OH_AVDemuxer_SeekToTime()
OH_AVErrCode OH_AVDemuxer_SeekToTime (OH_AVDemuxer *demuxer, int64_t millisecond, OH_AVSeekMode mode)
描述
根据设定的跳转模式，将所有选中的轨道到指定时间附近。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| millisecond | 期望跳转位置对应的时间，单位为毫秒，该时间戳是相对文件开始的位置。 |
| mode | 跳转的模式，参考OH_AVSeekMode。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。
OH_AVDemuxer_SelectTrackByID()
OH_AVErrCode OH_AVDemuxer_SelectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex)
描述
选中指定轨道，解封装器将会从该轨道中读取数据。
注意，通过多次调用接口并传入不同轨道的索引来选中多个轨道。 调用OH_AVDemuxer_ReadSample时只会读取被选中的轨道中数据，同一轨道被选择多次时，接口会返回AV_ERR_OK，并且只会生效一次。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| trackIndex | 需选择的轨道的索引。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。
OH_AVDemuxer_SetMediaKeySystemInfoCallback()
OH_AVErrCode OH_AVDemuxer_SetMediaKeySystemInfoCallback (OH_AVDemuxer *demuxer, DRM_MediaKeySystemInfoCallback callback)
描述
设置异步DRM信息回调函数。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 11
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| callback | 回调函数，详见DRM_MediaKeySystemInfoCallback。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。
OH_AVDemuxer_UnselectTrackByID()
OH_AVErrCode OH_AVDemuxer_UnselectTrackByID (OH_AVDemuxer *demuxer, uint32_t trackIndex)
描述
取消选择指定轨道，未选中的轨道的数据不会被解封装器读取。
注意，通过多次调用接口并传入不同轨道的索引来取消对多个轨道的选择。 同一轨道被多次取消选择时，接口会返回AV_ERR_OK，并且只会生效一次。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| demuxer | 指向OH_AVDemuxer实例的指针。 |
| trackIndex | 需取消选择的轨道的索引。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅OH_AVErrCode。