harmony 鸿蒙AVDemuxer
AVDemuxer
概述
AVDemuxer模块提供用于音视频解封装功能的函数。
\@syscap SystemCapability.Multimedia.Media.Spliter
起始版本：
10
汇总
文件
| 名称 | 描述 |
|---|---|
| native_avdemuxer.h | 声明用于音视频解封装的Native API。 引用文件： 库：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
你可能感兴趣的鸿蒙文章
- 所属分类： 后端技术
- 本文标签：
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
6、 golang
-
8、 openharmony