HarmonyOS 应用开发《掌上英语》第34篇:多媒体播放状态机：AVPlayer 的生命周期管理

34多媒体播放状态机AVPlayer 的生命周期管理一、引言多媒体播放器本质上是一个有限状态机——它在不同的状态之间流转每个状态下只能执行特定的操作。HarmonyOS 的 AVPlayer 定义了六种明确的状态理解这些状态及其转换关系是正确使用播放器的基础。本文将从 AVPlayer 的状态定义入手结合 AudioPlayer 的源码深入分析状态管理在实际开发中的应用。二、AVPlayer 的六种状态AVPlayer 的生命周期由以下六种状态构成状态含义可执行操作idle初始状态播放器刚创建设置 URL/FDprepared资源已准备就绪play()playing正在播放pause()、stop()、seek()paused已暂停play()、stop()、seek()stopped已停止重新设置 URL/Preparereleased已释放播放器销毁无2.1 状态转换图┌──────────────────────────────────────┐ │ idle │ │ (createAVPlayer 后的初始状态) │ └────────┬─────────────────────────────┘ │ url 赋值 ▼ ┌──────────────────────────────────────┐ │ initialized │ │ (internal: 已设置数据源) │ └────────┬─────────────────────────────┘ │ prepare() ▼ ┌──────────────────────────────────────┐ │ prepared │ │ (资源已准备好等待 play) │ └──┬───────────────────────┬──────────┘ │ play() │ stop() ▼ ▼ ┌────────────┐ ┌──────────────┐ │ playing │ │ stopped │ │ (播放中) │ │ (已停止) │ └──┬────┬────┘ └──────┬───────┘ │ │ │ url 赋值 │ │ pause() prepare() │ ▼ │ (重新准备) │ ┌────────┐ ▼ │ │ paused │ ┌──────────────┐ │ │ (暂停) │ │ initialized │ │ └───┬────┘ └──────────────┘ │ │ play() │ └────────────┐ ▼ │ ┌──────────────────────┴────┐ │ released │ │ (已销毁不可逆) │ └───────────────────────────┘需要注意的是released状态是不可逆的一旦播放器被释放必须重新createAVPlayer()才能继续使用。三、AudioPlayer 中的状态管理实践3.1 初始化阶段从 idle 到 prepared在 AudioPlayer 中播放器的初始化发生在单例创建时privateasyncinitPlayer():Promisevoid{try{this.avPlayerawaitmedia.createAVPlayer();this.initPlayerEvents();}catch(e){Logger.error(AudioPlayer,初始化失败);}}media.createAVPlayer()创建成功后AVPlayer 处于idle状态。此时播放器刚刚分配了系统资源但还没有与任何音频数据源关联。3.2 play() 方法中的状态转换publicplay(url:string):void{if(!url||url){Logger.warn(AudioPlayer,URL为空);return;}if(!this.avPlayer)return;if(this.currentUrlurlthis.avPlayer.stateplaying){this.stop();return;}this.currentUrlurl;this.avPlayer.stop();// 如果已经在 playing/paused → stoppedletsrcurl.startsWith(http)?url:rawfile/${url};this.avPlayer.urlsrc;// stopped → initializedthis.avPlayer.prepare().then((){if(this.avPlayer)this.avPlayer.play();// initialized → prepared → playing});}完整的播放状态转换路径为idle → (url 赋值) → initialized → (prepare) → prepared → (play) → playing其中initialized是 AVPlayer 的内部中间状态在设置url或fdSrc后自动进入。3.3 重复播放检测if(this.currentUrlurlthis.avPlayer.stateplaying){this.stop();return;}这段代码体现了对状态的精细判断首先比较currentUrl和传入的url判断是否点击了同一个音频然后检查state playing确认播放器确实正在播放只有两者都满足才执行停止——这意味着如果播放器处于paused状态即使点击同一个 URL也会继续播放而非停止这种设计符合用户的交互直觉暂停后再次点击是继续播放而非停止播放。3.4 stop() 和 pause() 的状态检查publicstop():void{if(!this.avPlayer)return;if(this.avPlayer.stateplaying||this.avPlayer.statepaused)this.avPlayer.stop();}publicpause():void{if(!this.avPlayer)return;if(this.avPlayer.stateplaying)this.avPlayer.pause();}状态检查在这里起到了安全守卫的作用stop()只在playing或paused时调用avPlayer.stop()因为其他状态下调用stop()会抛出异常pause()只在playing时调用avPlayer.pause()已经暂停时再次调用是非法的这种先检查状态再执行操作的模式是使用状态机 API 的标准做法。3.5 release() 的不可逆操作publicrelease():void{this.stop();if(this.avPlayer)this.avPlayer.release();this.avPlayernull;AudioPlayer.instanceundefined;}avPlayer.release()将播放器从当前状态直接切换到released状态。这个操作是单向不可逆的因此release()之后将avPlayer置为null并通过instance undefined重置单例。下次调用getInstance()时会创建全新的播放器实例。四、stateChange 事件的使用4.1 注册状态变更监听AVPlayer 提供了stateChange事件允许开发者实时追踪状态变化privateinitPlayerEvents():void{if(!this.avPlayer)return;this.avPlayer.on(stateChange,(state:string){Logger.info(AudioPlayer,状态变更:${state});switch(state){caseprepared:// 播放器已准备就绪可以获取 duration 等信息break;caseplaying:// 开始播放可以更新 UI 播放状态break;casepaused:// 已暂停break;casestopped:// 已停止break;casereleased:// 播放器已释放break;caseerror:// 出错状态break;}});this.avPlayer.on(error,(err:BusinessError)Logger.error(AudioPlayer,错误:${JSON.stringify(err)}));this.avPlayer.on(endOfStream,()Logger.info(AudioPlayer,播放完成));}4.2 状态事件的实际用途stateChange在以下几个场景中非常有用更新 UI 播放按钮状态当状态变为playing时显示暂停图标变为paused时显示播放图标获取媒体信息状态变为prepared后可以安全地获取duration音频总时长错误恢复状态变为error后尝试重置播放器性能监控记录各状态的持续时间分析播放性能五、状态管理中常见的错误5.1 在错误状态下调用错误的方法// ❌ 错误在 idle 状态调用 play()this.avPlayer.play();// 会抛出 IllegalStateException// ✅ 正确先设置数据源再 prepare最后 playthis.avPlayer.url...;this.avPlayer.prepare().then((){this.avPlayer.play();});5.2 没有等待 prepare 完成// ❌ 错误prepare 是异步操作没有等待完成就 playthis.avPlayer.url...;this.avPlayer.prepare();this.avPlayer.play();// 可能还在 prepared 之前play 失败// ✅ 正确在 then 回调中 playthis.avPlayer.url...;this.avPlayer.prepare().then((){this.avPlayer.play();});5.3 释放后继续使用// ❌ 错误release 后播放器已不可用this.avPlayer.release();this.avPlayer.play();// 对象已释放行为未定义// ✅ 正确释放后将引用置空this.avPlayer.release();this.avPlayernull;六、状态机设计模式总结AVPlayer 的状态机设计遵循了State Pattern的核心思想状态明确六种状态清晰定义了播放器的所有可能情况转换受控每个状态到另一个状态的转换路径是固定的、可预测的错误预防在非法状态下调用方法会直接抛出异常避免数据损坏对于开发者而言理解状态机的最佳方式是在AudioPlayer的封装层统一处理状态转换对外暴露的是更高层次的业务操作play、pause、stop、release调用方不需要关心底层状态。这种封装思想使得 AVPlayer 的使用门槛大大降低同时也确保了状态操作的正确性。七、总结AVPlayer 的生命周期管理是多媒体开发的核心课题。通过深入理解六种状态的含义和转换规则我们可以写出更稳健的播放代码。而通过AudioPlayer这样的封装层将复杂的底层状态机转化为简单的业务接口则是让代码可持续维护的关键。在实际项目中建议为 AudioPlayer 补充stateChange事件的监听和对外回调让 UI 层也能实时感知播放状态的变化从而实现更丰富的交互反馈。