react-native-sound在Android AVD中播放有进程但无声音如何解决？

开发者阿泽

2026-7-30

React Native Sound 在 Android AVD 播放无声音问题排查方案

1. 先排查 Android 模拟器本身的音频配置

打开 AVD Manager，编辑目标模拟器，展开Show Advanced Settings
确认Audio Input和Audio Output未设置为None，选择你电脑的声卡设备
重启模拟器后重新测试播放

2. 验证 Android 项目的权限与库配置

检查AndroidManifest.xml是否添加了必要权限：

<uses-permission android:name="android.permission.INTERNET" /> <!-- 网络音频需添加 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- 本地音频需添加 -->
<uses-permission android:name="android.permission.MEDIA_CONTENT_CONTROL" />

确认build.gradle（Module 级别）已正确引入依赖：

dependencies {
  implementation project(':react-native-sound')
}

检查MainApplication.java中是否注册了模块：

import com.zmxv.RNSound.RNSoundPackage;

@Override
protected List<ReactPackage> getPackages() {
  return Arrays.asList(
      new MainReactPackage(),
      new RNSoundPackage() // 确保该行存在
  );
}

3. 代码层面的播放参数检查

强制设置音量，避免默认音量为0：

sound.setVolume(1.0); // 设置最大音量测试

确认本地音频文件路径：需放在android/app/src/main/res/raw目录下，或使用正确的文件URI

避免组件挂载时立即播放，可添加延迟确保资源加载完成：

useEffect(() => {
  const sound = new Sound('test.mp3', Sound.MAIN_BUNDLE, (error) => {
    if (error) {
      console.log('音频加载失败', error);
      return;
    }
    setTimeout(() => {
      sound.play((success) => {
        if (!success) console.log('播放启动失败');
      });
    }, 1000);
  });
  return () => sound.release();
}, []);