写点什么

【HarmonyOS- 媒体技术 -AVPlayer】音视频播放开发全攻略

  • 2025-10-13
    北京
  • 本文字数:3434 字

    阅读完需:约 11 分钟

【HarmonyOS-媒体技术-AVPlayer】音视频播放开发全攻略

🌟 你还在为音视频播放功能发愁吗?

HarmonyOS 的 AVPlayer,就是你一直在寻找的那把“万能钥匙”!


🎧 📺 一、功能全面,兼容性强,开箱即用


AVPlayer 是 HarmonyOS 平台上强大的音视频播放组件,支持以下主流格式:

  • 音频解码格式:AAC、MP3 等

  • 视频解码格式:H.264 / AVC、H.265 / HEVC 等

  • 封装格式:MP4、M4A 等

无论是在线视频播放,还是本地媒体播放,AVPlayer 都能轻松应对!

典型应用:图库、华为视频、华为音乐、美团、新华社、蜻蜓 FM、京东、UC 浏览器;


🧩 二、开发门槛低,功能强大,支持多种语言


✅ ArkTS 开发

  • 快速构建音视频播放界面

  • 状态监听、错误捕获、流程控制一体化


✅ C/C++ NDK 开发

  • 与底层硬件深度整合,适用于高性能播放、自定义渲染等复杂项目


📦 三、开发流程清晰,代码结构规范,易于维护


🎯 音视频播放流程(ArkTS 示例):

// 1. 调用createAVPlayer()创建AVPlayer实例,初始化进入idle状态。this.avPlayer = await media.createAVPlayer();// 2. 设置业务需要的监听事件,搭配全流程场景使用。其中最关键的是AVPlayer状态变化:this.avPlayer.on('stateChange', async (state, reason) => {  if (this.avPlayer == null) {    console.info(`${this.tag}: avPlayer has not init on state change`);    return;  }  switch (state) {    case 'idle': // 成功调用reset接口后触发该状态机上报      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state idle called.`);      break;    case 'initialized': // avplayer 设置播放源后触发该状态上报      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state initialized called.`);      // 4.设置窗口:获取并设置属性SurfaceID,用于设置显示画面。可在收到initialized状态回调后设置,应用需要从XComponent组件获取surfaceID,获取方式请参考[XComponent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-xcomponent)      if (this.surfaceId) {        this.avPlayer.surfaceId = this.surfaceId; // 设置显示画面,当播放的资源为纯音频时无需设置        console.info(`${this.tag}: setAVPlayerCallback this.avPlayer.surfaceId = ${this.avPlayer.surfaceId}`);        // 5.准备播放:调用prepare(),AVPlayer进入prepared状态        this.avPlayer.prepare();      }      break;    case 'prepared': // prepare调用成功后上报该状态机      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state prepared called.`);      // 6.视频播控:播放play(),暂停pause(),跳转seek(),停止stop() 等操作      this.avPlayer.play(); // 调用播放接口开始播放      break;    case 'playing': // play成功调用后触发该状态机上报      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state playing called.`);      break;    case 'completed': // 播放结束后触发该状态机上报      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state completed called.`);      break;    case 'released':      console.info(`${this.tag}: setAVPlayerCallback released called.`);      break    case 'stopped':      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state stopped called.`);      break    case 'error':      console.error(`${this.tag}: setAVPlayerCallback AVPlayer state error called.`);      // 7.(可选)更换资源:调用reset()重置资源,AVPlayer重新进入idle状态,允许更换资源url。      this.avPlayer.reset();      break    case 'paused':      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state paused called.`);      break    default:      console.info(`${this.tag}: setAVPlayerCallback AVPlayer state unknown called.`);      break;  }});// 3. 设置资源:设置属性url,AVPlayer进入initialized状态。this.avPlayer.url = "xxx";
复制代码


🔧 四、NDK 开发:


✅ 示例代码片段(C++):

// 1.创建AVPlayer实例:调用OH_AVPlayer_Create(),AVPlayer初始化为AV_IDLE状态。OH_AVPlayer *player = OH_AVPlayer_Create();// 2.设置回调监听函数OHAVPlayerOnInfoCallback(OH_AVPlayer *player, AVPlayerOnInfoType type, OH_AVFormat *infoBody, void *userData) {  AVPlayerState avState = AV_IDLE;  switch (type) {    case AV_INFO_TYPE_STATE_CHANGE:      LOG("AVPlayerOnInfoType AV_INFO_TYPE_STATE_CHANGE");      OH_AVFormat_GetIntValue(infoBody, OH_PLAYER_STATE, &state);  OH_AVFormat_GetIntValue(infoBody, OH_PLAYER_STATE_CHANGE_REASON, &stateChangeReason);  LOG("OHAVPlayerOnInfoCallback AV_INFO_TYPE_STATE_CHANGE  state: %{public}d ,stateChangeReason: %{public}d",  state, stateChangeReason);  avState = static_cast<AVPlayerState>(state);  switch (avState) {    case AV_IDLE: // 成功调用reset接口后触发该状态机上报      LOG("AVPlayerState  AV_IDLE");      break;    case AV_INITIALIZED: {      LOG("AVPlayerState  AV_INITIALIZED");      auto context = SampleManager::GetInstance();      // 4.设置播放画面窗口:调用OH_AVPlayer_SetVideoSurface()设置播放画面窗口。此函数必须在SetSource之后,Prepare之前调用。      ret = OH_AVPlayer_SetVideoSurface(player, context->nativeWindow_);      LOG("OH_AVPlayer_SetVideoSurface ret:%{public}d", ret);      // 5.准备播放:调用OH_AVPlayer_Prepare(),AVPlayer进入AV_PREPARED状态,此时可以获取时长,设置音量。      ret = OH_AVPlayer_Prepare(player); // 设置播放源后触发该状态上报      if (ret != AV_ERR_OK) {        // 处理异常        LOG("player  %{public}s", "OH_AVPlayer_Prepare Err");      }    } break;    case AV_PREPARED:      LOG("AVPlayerState AV_PREPARED");      ret = OH_AVPlayer_SetAudioEffectMode(player, EFFECT_NONE); // 设置音频音效模式      LOG("OH_AVPlayer_SetAudioEffectMode ret:%{public}d", ret);      // 6.视频播控:播放OH_AVPlayer_Play(),暂停OH_AVPlayer_Pause(),跳转OH_AVPlayer_Seek(),停止OH_AVPlayer_Stop()等操作。      ret = OH_AVPlayer_Play(player); // 调用播放接口开始播放      LOG("OH_AVPlayer_Play ret:%{public}d", ret);      break;    case AV_PLAYING:      LOG("AVPlayerState AV_PLAYING");      break;    case AV_PAUSED:      LOG("AVPlayerState AV_PAUSED");      break;    case AV_STOPPED:      LOG("AVPlayerState AV_STOPPED");      break;    case AV_COMPLETED:      LOG("AVPlayerState AV_COMPLETED");      break;    case AV_ERROR:      LOG("AVPlayerState AV_ERROR");      break;    case AV_RELEASED:      LOG("AVPlayerState AV_RELEASED");      break;    default:      break;  }}// 3.设置资源:调用OH_AVPlayer_SetURLSource(),设置属性url,AVPlayer进入AV_INITIALIZED状态。OH_AVPlayer_SetURLSource(player, url);
复制代码


💡 五、开发建议与最佳实践


  • 严格遵守状态机规则:在 prepared/paused/completed 状态下调用 play(),在 playing 状态下调用 pause()。

  • 资源释放不可忽视:播放结束后务必调用 release()避免内存、线程等系统资源泄漏。

  • 权限管理要到位:当需要网络访问、媒体播放权限时,需要提前申请。


🎉 六、为什么选择 AVPlayer?


简单、便捷、高效 —— 功能强大、兼容广泛、性能稳定

若你想打造本地播放、在线点播、在线直播等功能场景的应用,AVPlayer 都是你不可或缺的开发利器!


📢 七、立即行动,开启你的音视频播放开发之旅!


👉 点击了解完整开发示例与 API 文档

HarmonyOS AVPlayer 开发指南 ArkTS API

HarmonyOS AVPlayer 开发指南 C API


🌐 加入 HarmonyOS 社区,共创未来!

我们诚邀广大开发者一起参与 HarmonyOS 技术生态建设,共建更开放、更智能的未来世界!

👉 加入开发者社区,获取最新资讯和技术支持

HarmonyOS 官方社区


📣 让 AVPlayer 成为你开发路上的得力助手,开启你的音视频播放新纪元! 🚀

2025-10-13 16:251835

评论

发布
暂无评论

Mysql如何迁移数据库数据

秃头小帅oi

从v3.1到v4.3,OceanBase稳定支撑快手PB级核心业务场景

老纪的技术唠嗑局

运维 数据库设计 OceanBase 社区版 mysql'

这个仓库堪称造轮子的鼻祖,建议看看!

Immerse

DApp极速开发指南:7天搞定Solidity合约+React前端全栈实战

区块链软件开发推广运营

交易所开发 dapp开发 链游开发 代币开发 交易所开发公链开发

直播预告 | 您的数据能喂给AI了吗?让GenAI读懂企业语言——产品分享会:矩阵起源MatrixOne Intelligence产品独家解析

MatrixOrigin

从《中国开源年度报告》看中国开源力量的十年变迁中,Apache SeaTunnel 的跃迁

白鲸开源

大数据 开源 Apache SeaTunnel Apache软件基金会 OpenRank

混合开发范式重构:FinClip驱动Native+小程序跨端生态进化

xuyinyin

基于华为开发者空间,仓颉宏实现语言集成查询LINQ

华为云开发者联盟

opengauss 华为开发者空间

程序员专属秋日养生指南(Coding版),文内有秋天第一杯奶茶

Comate编码助手

程序员 文心快码 秋天的第一杯奶茶 程序员养生

品牌出海的隐形风险:海外舆情监测你真的会用吗?

沃观Wovision

数据分析 出海企业 沃观Wovision 舆情监测系统

[鸿蒙征文]钢琴和弦小工具

大展红图

鸿蒙 音乐 HarmonyOS HarmonyOS NEXT 钢琴

告别碎片化输入:TextIn xParse如何为RAG打造「零损耗」知识管道

合合技术团队

人工智能 算法 #大数据

基于开发者空间OpenGauss数据库的分区表项目实践

华为云开发者联盟

opengauss 华为开发者空间

强化大型语言模型复杂指令推理能力的新方法

qife122

大型语言模型 指令跟随

深入底层:如何优雅部署 SeaTunnel 分离集群到 Kubernetes

白鲸开源

大数据 开源 Kubernetes 部署 Apache SeaTunnel

校招新人如何用文心快码让Landing期不再尴尬

Comate编码助手

职场新人 AI辅助编程 AI 代码助手 文心快码

基于远程开发环境部署Django与开发者空间GaussDB的实践应用

华为云开发者联盟

华为开发者空间

Apache Flink:从实时数据分析到实时AI

Apache Flink

flink AI 实时计算

硅空位中心实现量子网络化的新突破

qife122

量子技术 硅空位中心

三天接入,零重构:低代码中间件的快速集成机制全解析

星云低代码中间件

ide 低代码 企业应用 可视化编程

利用NLU标签优化ASR重评分模型

qife122

语音识别 自然语言理解

JNPF 6.0 +AI,低代码开发新体验

引迈信息

合规交易所架构设计:冷热钱包隔离+zk-KYC方案

区块链软件开发推广运营

交易所开发 dapp开发 链游开发 公链开发 代币开发

WAIC2025 | 澳鹏(中国)精彩亮相2025世界人工智能大会

澳鹏Appen

世界人工智能大会 WAIC WAIC2025

中国 Apache 项目 OpenRank 排行榜 Top 20:白鲸开源深度参与两大上榜项目

白鲸开源

开源 Apache DolphinScheduler Apache SeaTunnel 白鲸开源 Apache软件基金会

迈出万物互联的一小步:仓颉版TCPGroupChat群聊实现

华为云开发者联盟

仓颉 华为开发者空间

星云低代码:低代码不再是平台,而是“中间件”

星云低代码中间件

低代码 中间件 企业应用 可视化开发

技术文档 | 使用 Pulsar Functions 构建实时 AI Pipeline

AscentStream

Machine Learning pulsar

海外舆情监测系统能帮企业做什么?

沃观Wovision

海外舆情监控 沃观Wovision 舆情监测系统

【HarmonyOS-媒体技术-AVPlayer】音视频播放开发全攻略_HarmonyOS_HarmonyOS_InfoQ精选文章