AVSource
概述
AVSource模块提供用于构造音视频资源对象功能的函数。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
汇总
文件
| 名称 | 描述 |
|---|---|
| native_avsource.h | 声明用于音视频解封装的Native API。 |
类型定义
| 名称 | 描述 |
|---|---|
| typedef struct OH_AVSource OH_AVSource | 为媒体资源接口定义native层对象。 |
函数
| 名称 | 描述 |
|---|---|
| OH_AVSource * OH_AVSource_CreateWithURI (char *uri) | 为统一资源标识符对应的的资源对象创建OH_AVSource实例对象。 |
| OH_AVSource * OH_AVSource_CreateWithFD (int32_t fd, int64_t offset, int64_t size) | 为文件描述符对应的资源对象创建OH_AVSource实例对象。 |
| OH_AVErrCode OH_AVSource_Destroy (OH_AVSource *source) | 销毁OH_AVSource实例并清理内部资源。 |
| OH_AVFormat * OH_AVSource_GetSourceFormat (OH_AVSource *source) | 获取媒体资源文件的基础信息。 |
| OH_AVFormat * OH_AVSource_GetTrackFormat (OH_AVSource *source, uint32_t trackIndex) | 获取轨道的基础信息。 |
类型定义说明
OH_AVSource
typedef struct OH_AVSource OH_AVSource
描述 为媒体资源接口定义native层对象。
起始版本： 10
函数说明
OH_AVSource_CreateWithFD()
OH_AVSource* OH_AVSource_CreateWithFD (int32_t fd, int64_t offset, int64_t size)
描述
为文件描述符对应的资源对象创建OH_AVSource实例对象。
可以通过调用OH_AVSource_Destroy释放实例。
该接口如果传入offset不为文件起始位置，或size不为文件大小时，可能会因数据获取不完整导致 OH_AVSource创建失败、后续解封装失败等未定义错误。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| fd | 数据资源的文件描述符。 |
| offset | 开始读取数据的位置。 |
| size | 文件的字节数大小。 |
返回：
返回一个指向OH_AVSource实例的指针。
OH_AVSource_CreateWithURI()
OH_AVSource* OH_AVSource_CreateWithURI (char *uri)
描述
为统一资源标识符对应的的资源对象创建OH_AVSource实例对象，可以通过调用OH_AVSource_Destroy释放实例。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| uri | 远程媒体资源的统一资源标识符。 |
返回：
返回一个指向OH_AVSource实例的指针。
OH_AVSource_Destroy()
OH_AVErrCode OH_AVSource_Destroy (OH_AVSource *source)
描述
销毁OH_AVSource实例并清理内部资源。
同一实例只能被销毁一次。销毁的实例在被重新创建之前不能再被使用。建议实例销毁成功后将指针置为NULL。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| source | 指向OH_AVSource实例的指针。 |
返回：
执行成功返回AV_ERR_OK, 否则返回具体错误码，请参阅 OH_AVErrCode。
OH_AVSource_GetSourceFormat()
OH_AVFormat* OH_AVSource_GetSourceFormat (OH_AVSource *source)
描述
获取媒体资源文件的基础信息。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| source | 指向OH_AVSource实例的指针。 |
返回：
返回媒体资源文件的基础信息。
OH_AVSource_GetTrackFormat()
OH_AVFormat* OH_AVSource_GetTrackFormat (OH_AVSource *source, uint32_t trackIndex)
描述
获取轨道的基础信息。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数:
| 名称 | 描述 |
|---|---|
| source | 指向OH_AVSource实例的指针。 |
| trackIndex | 需要获取信息的轨道的索引。 |
返回：
返回轨道的基础信息。