React Native TrackPlayer 3.2安卓端网络URL音频播放失效求助

一、检查安卓网络权限配置 #

安卓应用需声明网络权限才能访问外部资源，确保android/app/src/main/AndroidManifest.xml中添加以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

若使用HTTP协议的媒体URL（非HTTPS），安卓9（API 28）及以上默认禁止明文请求，需在<application>标签内补充：

android:usesCleartextTraffic="true"

二、确认TrackPlayer服务配置 #

TrackPlayer 3.x需要在AndroidManifest.xml中注册播放服务，检查<application>标签内是否存在：

<service android:name="com.doublesymmetry.trackplayer.service.MusicService" android:foregroundServiceType="mediaPlayback" />
<receiver android:name="com.doublesymmetry.trackplayer.service.MusicServiceReceiver" />

缺失则直接添加。

三、添加错误监听排查细节 #

即使日志无报错，也可通过TrackPlayer事件监听捕获播放异常，初始化后添加：

TrackPlayer.addEventListener('playback-error', (error) => {
  console.log('播放错误详情:', error);
});

同时主动获取播放状态，确认是否处于异常或缓冲阶段：

const state = await TrackPlayer.getState();
console.log('当前播放状态:', state);

四、验证媒体URL有效性 #

• 直接在安卓设备浏览器中打开目标URL，确认资源可正常播放，排除服务器防盗链、资源失效等问题
• 确认媒体格式为TrackPlayer支持的类型（如MP3、AAC，你的示例MP3格式无问题）

五、检查gradle最低版本配置 #

TrackPlayer 3.x要求安卓minSdkVersion不低于21，确保android/build.gradle中配置符合：

buildscript {
    ext {
        minSdkVersion = 21
        // 其他项目配置...
    }
}

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