React Native Track Player 在 Android 设备上的重复播放模式问题解析

问题背景

在 React Native Track Player 音频播放库的使用过程中，开发者报告了一个关于重复播放模式的特定问题。该问题表现为在 Android 设备上，无论将重复模式设置为 RepeatMode.Off 还是 RepeatMode.Track，音频都会自动重复播放，而 iOS 模拟器上则表现正常。

技术细节分析

重复播放模式的工作原理

React Native Track Player 提供了三种重复播放模式：

1. Off - 播放结束后停止
2. Track - 单曲循环
3. Queue - 列表循环

在底层实现上，Android 和 iOS 平台有不同的处理机制。iOS 使用 AVPlayer，而 Android 使用 ExoPlayer，这两种播放器的循环行为实现方式存在差异。

问题排查过程

开发者最初确认了以下几点：

1. 通过 getRepeatMode() 确认设置的值正确
2. 在 iOS 模拟器上行为正常
3. 尝试了 load() 和 add() 方法，结果相同

深入调查后发现，问题的根源并非来自 React Native Track Player 本身，而是与项目中同时使用的 expo-av 音频模块产生了冲突。具体表现为：

1. expo-av 的音频实例被设置为循环播放(isLooping=true)
2. 这种设置意外地影响了整个应用的音频播放行为
3. 在 Android 平台上，这种冲突尤为明显

技术解决方案

正确的配置方式

要确保 React Native Track Player 的重复模式正常工作，应遵循以下最佳实践：

1. 避免与其他音频库混用
2. 单独初始化 Track Player
3. 确保没有全局音频设置干扰

初始化示例代码

async function setupPlayer() {
  await TrackPlayer.setupPlayer({
    maxCacheSize: 1024 * 50,
  });

  await TrackPlayer.updateOptions({
    ratingType: RatingType.Heart,
    capabilities: [
      Capability.Play,
      Capability.Pause,
      Capability.SeekTo
    ],
    android: {
      appKilledPlaybackBehavior: AppKilledPlaybackBehavior.StopPlaybackAndRemoveNotification
    },
  });

  await TrackPlayer.setVolume(1);
  await TrackPlayer.setRepeatMode(RepeatMode.Off);
}

深入理解播放状态转换

开发者还观察到一个有趣的现象：当重复模式设置为 Off 时，音频结束时触发了以下状态序列：

1. ended
2. buffering
3. ready
4. playing
5. stopped

这实际上是播放器的正常行为：

1. 播放结束后触发 ended 事件
2. 播放器尝试重新缓冲
3. 准备就绪后短暂进入 playing 状态
4. 由于没有更多内容，最终进入 stopped 状态

这种状态转换序列反映了播放器内部的状态机设计，并非缺陷。

跨平台开发经验

这个案例揭示了 React Native 跨平台开发中的一个重要经验：

1. 不同平台的音频实现有本质差异
2. 混合使用多个音频库可能导致不可预测的行为
3. Android 对全局音频设置更为敏感

开发者在实现复杂音频功能时，应当：

1. 尽量使用单一音频解决方案
2. 充分测试各平台行为
3. 注意模块间的相互影响

总结

React Native Track Player 的重复播放模式在 Android 设备上的异常行为，本质上是由于与其他音频模块的冲突所致。通过隔离音频功能、避免混合使用不同音频库，可以确保播放控制功能按预期工作。这个案例也提醒我们，在跨平台音频开发中，理解底层实现差异和模块交互至关重要。