React Native远程URL音频播放失败及react-native-sound库相关问题咨询

1. react-native-sound库的维护状态 #

react-native-sound确实已经很久没有重大更新了，它对React Native 0.60+之后的新版本适配不够完善，你遇到的Cannot read property 'IsAndroid' of undefined错误就是典型的版本兼容问题——库内部调用的原生模块接口在RN新版本中已经发生变化，导致无法正常初始化。目前这个库基本处于半维护状态，不推荐在新项目中使用。

2. 可用的远程音频播放示例 #

推荐使用expo-av（无论你是用Expo managed workflow还是裸React Native项目都能兼容），这个库由Expo官方维护，更新频繁，兼容性好。下面是一个完整的远程音频播放示例：

步骤1：安装依赖 #

首先安装expo-av：

# 如果是Expo项目
npx expo install expo-av

# 如果是纯React Native裸项目
npm install expo-av
npx pod-install  # iOS需要执行这个

步骤2：实现播放组件 #

import React, { useState, useRef } from 'react';
import { Button, View, Text, Alert } from 'react-native';
import { Audio } from 'expo-av';

const RemoteAudioPlayer = () => {
  const [sound, setSound] = useState(null);
  const soundRef = useRef(null);

  const playRemoteAudio = async () => {
    try {
      await Audio.setAudioModeAsync({
        allowsRecordingIOS: false,
        playsInSilentModeIOS: true,
        shouldDuckAndroid: true,
        staysActiveInBackground: false,
        playThroughEarpieceAndroid: false,
      });

      const { sound: newSound } = await Audio.Sound.createAsync(
        { uri: 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3' },
        { shouldPlay: true }
      );
      setSound(newSound);
      soundRef.current = newSound;

      // 监听播放结束，自动清理资源
      newSound.setOnPlaybackStatusUpdate((status) => {
        if (status.didJustFinish) {
          setSound(null);
          soundRef.current = null;
        }
      });
    } catch (error) {
      Alert.alert('播放错误', `无法加载音频：${error.message}`);
    }
  };

  const stopAudio = async () => {
    if (sound) {
      await sound.stopAsync();
      await sound.unloadAsync();
      setSound(null);
      soundRef.current = null;
    }
  };

  // 组件卸载时强制清理音频资源，避免内存泄漏
  React.useEffect(() => {
    return () => {
      if (soundRef.current) {
        soundRef.current.unloadAsync();
      }
    };
  }, []);

  return (
    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center', gap: 16 }}>
      <Button title="播放远程音频" onPress={playRemoteAudio} />
      {sound && <Button title="停止播放" onPress={stopAudio} />}
    </View>
  );
};

export default RemoteAudioPlayer;

示例说明 #

• 自动处理音频资源的加载、播放和卸载，避免内存泄漏
• 适配了iOS和Android的音频模式设置，确保在静音模式、后台等场景下的播放行为符合预期
• 包含完整的错误捕获逻辑，播放失败时会弹出提示告知用户

如果你需要更复杂的功能（比如后台播放、播放列表管理），也可以选择react-native-track-player，它是一个专注于音频播放的第三方库，功能更全面，不过配置流程会稍微复杂一些。

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