使用expo-av高效播放音频的最优方案及问题排查

方案优劣分析 #

方案一（PlayAudio） #

• 核心逻辑：用useRef持久化Audio.Sound实例，提前加载音频，播放时复用同一个实例
• 优势：
  • 复用已加载的实例，避免重复加载/卸载的IO开销，播放响应速度快，特别适合频繁播放同一音频的场景（比如按钮点击音效）
  • 内置了灵活的播放控制逻辑，支持从开头重放或继续播放
• 潜在问题：
  • 直接在组件顶层调用loadAsync但未处理异步结果，可能出现音频还没加载完成就触发播放的情况，导致状态异常
  • 若组件卸载时未清理实例，容易触发"Player doesn't exist"错误

方案二（PlayAudioBis） #

• 核心逻辑：每次播放都创建新的Audio.Sound实例，走完加载→播放→卸载的完整流程
• 劣势：
  • 每次播放都要重新加载音频，性能开销大，播放延迟明显，完全不适合高频播放场景
  • 播放后立即调用unloadAsync，会导致音频还没播放完就被销毁，基本听不到完整声音
• 适用场景：仅适合单次播放、低频使用且对延迟不敏感的长音频

方案三（PlayAudioTer） #

• 核心逻辑：用官方推荐的createAsync一步完成实例创建和加载，通过监听播放状态在结束后自动卸载
• 优势：
  • 简化了初始化流程，内部处理了异步逻辑，比手动创建+加载更稳妥
  • 播放结束后自动卸载，避免内存泄漏
• 不足：
  • 每次播放都生成新实例，同样存在重复加载的性能问题，频繁调用会卡顿
  • 缺少中途暂停、重放等控制逻辑，灵活性不足

最优方案：方案一（优化后）
原因：

1. 实例复用大幅降低性能开销，适配大多数高频播放场景；
2. 控制逻辑最完善，能满足多种播放需求；
3. 只要修复初始化和生命周期的问题，就能彻底解决"Player doesn't exist"错误。

"Player doesn't exist" 错误解决 #

这个错误本质是音频实例已被销毁或未正确初始化，针对方案一可以做以下优化：

1. 正确处理异步加载逻辑
   不要直接在组件顶层调用loadAsync，放在useEffect中并处理加载状态：

   import { Audio, useEffect, useRef, useState } from 'expo-av';
   
   const soundPath = require('sound.mp3');
   const soundRef = useRef(null);
   const [isSoundLoaded, setIsSoundLoaded] = useState(false);
   
   useEffect(() => {
     const loadSound = async () => {
       const sound = new Audio.Sound();
       try {
         await sound.loadAsync(soundPath);
         soundRef.current = sound;
         setIsSoundLoaded(true);
       } catch (e) {
         console.error('加载音频失败:', e);
       }
     };
   
     loadSound();
   
     // 组件卸载时清理实例
     return () => {
       if (soundRef.current) {
         soundRef.current.unloadAsync();
       }
     };
   }, []);
   

2. 播放前校验实例状态
   在PlayAudio函数中增加实例存在性检查，避免调用已销毁的实例：

   export const PlayAudio = async (audioRef, fromStart = true) => {
     if (!audioRef.current) {
       console.error('音频实例不存在');
       return;
     }
     try {
       const result = await audioRef.current.getStatusAsync();
       if (result.isLoaded) {
         if (result.isPlaying === false) {
           if (fromStart) {
             await audioRef.current.playFromPositionAsync(0);
           } else {
             await audioRef.current.playAsync();
           }
         } else if (fromStart) {
           await audioRef.current.pauseAsync();
           await audioRef.current.playFromPositionAsync(0);
         }
       }
     } catch (e) {
       console.error('播放音频错误:', e);
     }
   };
   

3. 规范实例生命周期管理
   若audioRef在多组件间共享，确保组件卸载时及时清理引用，不要持有已销毁组件的实例。

内容的提问来源于stack exchange，提问作者Seba99