34：多媒体播放状态机：AVPlayer 的生命周期管理
一、引言
多媒体播放器本质上是一个有限状态机——它在不同的状态之间流转，每个状态下只能执行特定的操作。HarmonyOS 的 AVPlayer 定义了六种明确的状态，理解这些状态及其转换关系，是正确使用播放器的基础。
本文将从 AVPlayer 的状态定义入手，结合 AudioPlayer 的源码，深入分析状态管理在实际开发中的应用。
二、AVPlayer 的六种状态
AVPlayer 的生命周期由以下六种状态构成：
| 状态 | 含义 | 可执行操作 |
|---|---|---|
| idle | 初始状态，播放器刚创建 | 设置 URL/FD |
| prepared | 资源已准备就绪 | play() |
| playing | 正在播放 | pause()、stop()、seek() |
| paused | 已暂停 | play()、stop()、seek() |
| stopped | 已停止 | 重新设置 URL/Prepare |
| released | 已释放，播放器销毁 | 无 |
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():Promise<void>{try{this.avPlayer=awaitmedia.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.currentUrl===url&&this.avPlayer.state==='playing'){this.stop();return;}this.currentUrl=url;this.avPlayer.stop();// 如果已经在 playing/paused → stoppedletsrc=url.startsWith('http')?url:`@rawfile/${url}`;this.avPlayer.url=src;// 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.currentUrl===url&&this.avPlayer.state==='playing'){this.stop();return;}这段代码体现了对状态的精细判断：
- 首先比较
currentUrl和传入的url，判断是否点击了同一个音频 - 然后检查
state === 'playing'，确认播放器确实正在播放 - 只有两者都满足才执行停止——这意味着如果播放器处于
paused状态，即使点击同一个 URL，也会继续播放而非停止
这种设计符合用户的交互直觉：暂停后再次点击是"继续播放"而非"停止播放"。
3.4 stop() 和 pause() 的状态检查
publicstop():void{if(!this.avPlayer)return;if(this.avPlayer.state==='playing'||this.avPlayer.state==='paused')this.avPlayer.stop();}publicpause():void{if(!this.avPlayer)return;if(this.avPlayer.state==='playing')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.avPlayer=null;AudioPlayer.instance=undefined;}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){case'prepared':// 播放器已准备就绪，可以获取 duration 等信息break;case'playing':// 开始播放，可以更新 UI 播放状态break;case'paused':// 已暂停break;case'stopped':// 已停止break;case'released':// 播放器已释放break;case'error':// 出错状态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.avPlayer=null;六、状态机设计模式总结
AVPlayer 的状态机设计遵循了State Pattern的核心思想：
- 状态明确：六种状态清晰定义了播放器的所有可能情况
- 转换受控：每个状态到另一个状态的转换路径是固定的、可预测的
- 错误预防：在非法状态下调用方法会直接抛出异常，避免数据损坏
对于开发者而言，理解状态机的最佳方式是在AudioPlayer的封装层统一处理状态转换，对外暴露的是更高层次的业务操作（play、pause、stop、release），调用方不需要关心底层状态。这种封装思想使得 AVPlayer 的使用门槛大大降低，同时也确保了状态操作的正确性。
七、总结
AVPlayer 的生命周期管理是多媒体开发的核心课题。通过深入理解六种状态的含义和转换规则，我们可以写出更稳健的播放代码。而通过AudioPlayer这样的封装层，将复杂的底层状态机转化为简单的业务接口，则是让代码可持续维护的关键。
在实际项目中，建议为 AudioPlayer 补充stateChange事件的监听和对外回调，让 UI 层也能实时感知播放状态的变化，从而实现更丰富的交互反馈。
