智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
native_avsource.h
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
本文导读
概述
声明用于音视频媒体数据解析的接口。
引用文件： <multimedia/player_framework/native_avsource.h>
库： libnative_media_avsource.so
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
相关模块： AVSource
相关示例： AVCodec
汇总
结构体
展开
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| OH_AVSource | OH_AVSource | 为媒体资源接口定义native层对象。 |
函数
展开
| 名称 | 描述 |
|---|---|
| OH_AVSource *OH_AVSource_CreateWithDataSource(OH_AVDataSource *dataSource) | 为用户自定义数据源的资源对象创建OH_AVSource实例，可以通过调用OH_AVSource_Destroy接口释放实例。 参数dataSource生命周期需与返回的指针OH_AVSource *保持一致。 |
| OH_AVSource *OH_AVSource_CreateWithDataSourceExt(OH_AVDataSourceExt *dataSource, void *userData) | 为用户自定义数据源的资源对象创建OH_AVSource实例，可以通过调用OH_AVSource_Destroy接口释放实例。 回调支持通过userData传递用户自定义数据。 参数dataSource生命周期需与返回的指针OH_AVSource *保持一致。 |
| OH_AVSource *OH_AVSource_CreateWithURI(char *uri) | 为统一资源标识符对应的资源对象创建OH_AVSource实例，可以通过调用OH_AVSource_Destroy接口释放实例。该接口仅支持HTTP渐进式流媒体，不支持HLS/DASH的流媒体；对于HLS/DASH的流媒体播放，推荐使用AVPlayer组件进行开发。 |
| OH_AVSource *OH_AVSource_CreateWithFD(int32_t fd, int64_t offset, int64_t size) | 为文件描述符对应的资源对象创建OH_AVSource实例。可以通过调用OH_AVSource_Destroy接口释放实例。 接口如果传入offset不为文件起始位置，或size不为文件大小时，可能会因数据获取不完整导致OH_AVSource创建失败、后续解封装失败等未定义错误。 |
| OH_AVErrCode OH_AVSource_Destroy(OH_AVSource *source) | 销毁OH_AVSource实例并清理内部资源。 同一实例只能被销毁一次。销毁的实例在被重新创建之前不能再被使用。建议实例销毁成功后将指针置为NULL。 |
| OH_AVFormat *OH_AVSource_GetSourceFormat(OH_AVSource *source) | 获取媒体资源文件的基础信息。 需要注意的是，指向的OH_AVFormat实例在生命周期结束时需调用者通过调用接口OH_AVFormat_Destroy释放。 |
| OH_AVFormat *OH_AVSource_GetTrackFormat(OH_AVSource *source, uint32_t trackIndex) | 获取轨道的基础信息。 需要注意的是，指向的OH_AVFormat实例在生命周期结束时需调用者通过调用接口OH_AVFormat_Destroy释放。 |
| OH_AVFormat *OH_AVSource_GetCustomMetadataFormat(OH_AVSource *source) | 获取自定义元数据的基础信息。 需要注意的是，指向的OH_AVFormat实例在生命周期结束时需开发者通过调用接口OH_AVFormat_Destroy释放。 |
函数说明
OH_AVSource_CreateWithDataSource()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- OH_AVSource *OH_AVSource_CreateWithDataSource(OH_AVDataSource *dataSource)
描述
为用户自定义数据源的资源对象创建OH_AVSource实例，可以通过调用OH_AVSource_Destroy接口释放实例。
参数dataSource生命周期需与返回的指针OH_AVSource *保持一致。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 12
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_AVDataSource *dataSource | 用户自定义数据源。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVSource * | 如果执行成功，则返回一个指向OH_AVSource实例的指针，否则返回NULL。 可能的故障原因： 1. dataSource为nullptr。 2. dataSource->size == 0。 3. 设置数据源失败。 4. 内存不足。 5. 解码器引擎为nullptr。 6. dataSource->readAt == nullptr。 |
OH_AVSource_CreateWithDataSourceExt()
Phone20+PC/2in120+Tablet20+TV20+Wearable20+
收起
自动换行
深色代码主题
复制
- OH_AVSource *OH_AVSource_CreateWithDataSourceExt(OH_AVDataSourceExt *dataSource, void *userData)
描述
为用户自定义数据源的资源对象创建OH_AVSource实例，可以通过调用OH_AVSource_Destroy接口释放实例。
回调支持通过userData传递用户自定义数据。
参数dataSource生命周期需与返回的指针OH_AVSource *保持一致。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 20
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_AVDataSourceExt *dataSource | 指向数据源结构体的指针，该结构体可用于获取输入数据。 |
| void *userData | 指向用户自定义数据的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVSource * | 如果执行成功，则返回一个指向OH_AVSource实例的指针，否则返回NULL。 可能的故障原因： 1. dataSource为nullptr。 2. dataSource->size == 0。 3. 设置数据源失败。 4. 内存不足。 5. 解码器引擎为nullptr。 6. dataSource->readAt == nullptr。 |
OH_AVSource_CreateWithURI()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- OH_AVSource *OH_AVSource_CreateWithURI(char *uri)
描述
为统一资源标识符对应的资源对象创建OH_AVSource实例，可以通过调用OH_AVSource_Destroy接口释放实例。该接口仅支持HTTP渐进式流媒体，不支持HLS/DASH的流媒体；对于HLS/DASH的流媒体播放，推荐使用AVPlayer组件进行开发。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| char *uri | 远程媒体资源的统一资源标识符。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVSource * | 执行成功返回一个指向OH_AVSource实例的指针，否则返回NULL。 可能的故障原因： 1. 网络异常。 2. 资源无效。 3. 文件格式不支持。 4. 应用配置明文拦截。 |
OH_AVSource_CreateWithFD()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- 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
参数：
展开
| 参数项 | 描述 |
|---|---|
| int32_t fd | 数据资源的文件描述符。 |
| int64_t offset | 开始读取数据的位置，单位为字节。 |
| int64_t size | 文件的字节数大小，表示从offset指定位置开始可读取的数据长度。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVSource * | 执行成功返回一个指向OH_AVSource实例的指针，否则返回NULL。 可能的故障原因： 1. fd无效。 2. 传入offset不是文件起始位置。 3. size错误。 4. 资源无效。 5. 文件格式不支持。 |
OH_AVSource_Destroy()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- OH_AVErrCode OH_AVSource_Destroy(OH_AVSource *source)
描述
销毁OH_AVSource实例并清理内部资源。
同一实例只能被销毁一次。销毁的实例在被重新创建之前不能再被使用。建议实例销毁成功后将指针置为NULL。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_AVSource *source | 指向OH_AVSource实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVErrCode | AV_ERR_OK：操作成功。 AV_ERR_INVALID_VAL： 1. source指针无效，空指针。 2. 非OH_AVSource实例。 |
OH_AVSource_GetSourceFormat()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- OH_AVFormat *OH_AVSource_GetSourceFormat(OH_AVSource *source)
描述
获取媒体资源文件的基础信息。
需要注意的是，指向的OH_AVFormat实例在生命周期结束时需调用者通过调用接口OH_AVFormat_Destroy释放。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_AVSource *source | 指向OH_AVSource实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVFormat * | 执行成功返回文件的基础信息，否则返回NULL。 可能的故障原因： 1. source指针无效。 2. 空指针或非OH_AVSource实例。 3. source没有初始化。 |
OH_AVSource_GetTrackFormat()
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- OH_AVFormat *OH_AVSource_GetTrackFormat(OH_AVSource *source, uint32_t trackIndex)
描述
获取轨道的基础信息。
需要注意的是，指向的OH_AVFormat实例在生命周期结束时需调用者通过调用接口OH_AVFormat_Destroy释放。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 10
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_AVSource *source | 指向OH_AVSource实例的指针。 |
| uint32_t trackIndex | 需要获取信息的轨道的索引。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVFormat * | 执行成功返回轨道的基础信息，否则返回NULL。 可能的故障原因： 1. source指针无效，空指针或非OH_AVSource实例。 2. 轨道的索引超出范围。 3. source没有初始化。 |
OH_AVSource_GetCustomMetadataFormat()
Phone18+PC/2in118+Tablet18+TV19+Wearable18+
收起
自动换行
深色代码主题
复制
- OH_AVFormat *OH_AVSource_GetCustomMetadataFormat(OH_AVSource *source)
描述
获取自定义元数据的基础信息。
需要注意的是，指向的OH_AVFormat实例在生命周期结束时需调用者通过调用接口OH_AVFormat_Destroy释放。
系统能力： SystemCapability.Multimedia.Media.Spliter
起始版本： 18
参数：
展开
| 参数项 | 描述 |
|---|---|
| OH_AVSource *source | 指向OH_AVSource实例的指针。 |
返回：
展开
| 类型 | 说明 |
|---|---|
| OH_AVFormat * | 执行成功返回元数据的基础信息，否则返回NULL。 可能的故障原因： 1. source指针无效。 2. 空指针或非OH_AVSource实例。 3. source没有初始化。 |
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词