3行代码实现ExoPlayer音频控制：单曲循环与随机播放全攻略

3行代码实现ExoPlayer音频控制：单曲循环与随机播放全攻略

【免费下载链接】ExoPlayer 项目地址: https://gitcode.com/gh_mirrors/ex/ExoPlayer

你是否还在为ExoPlayer播放模式切换烦恼？本文将通过极简代码示例，教你3步实现单曲循环与随机播放功能，同时避开90%开发者会踩的线程安全陷阱。读完本文你将掌握：

• 单曲循环（Repeat Mode）的参数配置与状态监听
• 随机播放（Shuffle Mode）的列表重组逻辑
• UI控件与播放模式的联动实现
• 常见异常的调试方法与解决方案

ExoPlayer播放模式基础

ExoPlayer作为Android平台功能最全面的媒体播放库，提供了标准化的播放控制接口。其核心播放模式通过Player接口定义，主要包含重复模式（Repeat Mode）和随机模式（Shuffle Mode）两类控制参数。

核心模式参数说明

模式类型	常量定义	功能描述
重复模式	REPEAT_MODE_OFF	关闭重复播放
重复模式	REPEAT_MODE_ONE	单曲循环（当前音频重复播放）
重复模式	REPEAT_MODE_ALL	列表循环（所有音频循环播放）
随机模式	setShuffleModeEnabled(true)	开启随机播放

官方接口文档：Player.java

单曲循环功能实现

单曲循环是通过设置REPEAT_MODE_ONE参数实现的，需要在播放器初始化后调用setRepeatMode方法。以下是最小化实现代码：

// 创建播放器实例
SimpleExoPlayer player = new SimpleExoPlayer.Builder(context).build();

// 设置单曲循环模式
player.setRepeatMode(Player.REPEAT_MODE_ONE);

// 准备媒体资源并开始播放
MediaItem mediaItem = MediaItem.fromUri(audioUri);
player.setMediaItem(mediaItem);
player.prepare();
player.play();

状态监听与模式切换

在实际应用中，通常需要根据用户操作动态切换模式，建议结合Player.Listener实现状态监听：

player.addListener(new Player.Listener() {
  @Override
  public void onRepeatModeChanged(int repeatMode) {
    // 监听模式变化，更新UI状态
    updateRepeatButtonUI(repeatMode);
  }
});

// 模式切换示例（按钮点击事件）
repeatButton.setOnClickListener(v -> {
  int currentMode = player.getRepeatMode();
  int newMode = currentMode == Player.REPEAT_MODE_ONE 
      ? Player.REPEAT_MODE_OFF 
      : Player.REPEAT_MODE_ONE;
  player.setRepeatMode(newMode);
});

测试用例参考：ExoPlayerTest.java

随机播放功能实现

随机播放需要同时设置shuffleModeEnabled和REPEAT_MODE_ALL参数，实现列表随机遍历。注意随机播放仅对多音频列表有效：

基础实现代码

// 创建包含多个音频的播放列表
List<MediaItem> mediaItems = new ArrayList<>();
mediaItems.add(MediaItem.fromUri(audioUri1));
mediaItems.add(MediaItem.fromUri(audioUri2));
mediaItems.add(MediaItem.fromUri(audioUri3));

// 开启随机播放模式
player.setShuffleModeEnabled(true);
player.setRepeatMode(Player.REPEAT_MODE_ALL); // 配合随机播放循环列表
player.setMediaItems(mediaItems);
player.prepare();
player.play();

高级应用：自定义随机算法

如需实现特定的随机逻辑（如避免连续播放同一首），可通过自定义ShuffleOrder实现：

// 使用自定义随机序列
player.setShuffleOrder(new DefaultShuffleOrder(
  new long[]{1, 2, 3}, // 音频ID数组
  System.currentTimeMillis() // 随机种子
));

UI控件集成方案

ExoPlayer提供默认播放控制UI组件，可通过布局文件快速集成模式切换按钮：

<com.google.android.exoplayer2.ui.PlayerControlView
  android:id="@+id/playerControlView"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  app:show_shuffle_button="true"
  app:show_repeat_button="true"/>

UI组件文档：ui-components.md

常见问题解决方案

1. 单曲循环不生效

• 检查是否使用LoopingMediaSource（已废弃），应改用Player.REPEAT_MODE_ONE
• 确保音频文件时长正确解析，无效时长会导致播放完成事件不触发

2. 随机播放顺序固定

• 每次启用随机播放时应使用不同种子：new DefaultShuffleOrder(seed)
• 避免在播放过程中动态修改播放列表

3. 模式切换引发ANR

• 确保所有Player操作在主线程执行
• 使用PlayerHelper工具类封装模式切换逻辑：PlayerHelper.java

总结与最佳实践

1. 模式组合推荐：

   • 单曲循环：REPEAT_MODE_ONE + shuffleModeEnabled=false
   • 列表随机：REPEAT_MODE_ALL + shuffleModeEnabled=true
   • 列表顺序：REPEAT_MODE_ALL + shuffleModeEnabled=false

2. 状态保存： 在onSaveInstanceState中保存模式状态：

   @Override
   protected void onSaveInstanceState(Bundle outState) {
     super.onSaveInstanceState(outState);
     outState.putInt("repeat_mode", player.getRepeatMode());
     outState.putBoolean("shuffle_enabled", player.getShuffleModeEnabled());
   }
   

3. 性能优化： 播放列表超过100项时，使用ConcatenatingMediaSource实现惰性加载：ConcatenatingMediaSource.java

通过本文介绍的方法，你可以在30分钟内为应用集成专业级音频播放控制功能。完整示例代码可参考官方Demo：demos/main/src，更多高级用法请查阅官方文档。

【免费下载链接】ExoPlayer 项目地址: https://gitcode.com/gh_mirrors/ex/ExoPlayer