Android媒体开发 -（2）ExoPlayer高级功能：自定义播放列表与循环控制-平芜编程栈

1. ExoPlayer播放列表与循环控制概述

ExoPlayer作为Android平台上最强大的媒体播放库之一，其核心优势在于灵活的可扩展性。在实际项目中，我们经常需要实现复杂的播放逻辑，比如动态更新的播放列表、多种循环模式切换等。这些功能在音乐播放器、视频轮播等场景中尤为常见。

我曾在开发一个企业级视频点播应用时，遇到需要实时更新播放列表同时保持流畅播放的需求。传统MediaPlayer根本无法满足这种动态性，而ExoPlayer的媒体源(MediaSource)机制完美解决了这个问题。下面我们就深入探讨如何利用ExoPlayer实现这些高级功能。

2. 构建动态播放列表

2.1 ConcatenatingMediaSource的核心机制

ConcatenatingMediaSource是ExoPlayer处理播放列表的利器，它允许我们将多个媒体源无缝连接。与简单地将MediaItem放入List不同，ConcatenatingMediaSource提供了原子性操作保证线程安全。

// 创建基础媒体源 MediaSource firstVideo = new ProgressiveMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(firstVideoUri)); MediaSource secondVideo = new ProgressiveMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(secondVideoUri)); // 构建播放列表 ConcatenatingMediaSource playlistSource = new ConcatenatingMediaSource(firstVideo, secondVideo); player.setMediaSource(playlistSource); player.prepare();

2.2 动态修改播放列表

实际开发中，播放列表经常需要动态更新。ExoPlayer提供了线程安全的操作方法：

// 添加新项目到列表末尾 playlistSource.addMediaSource(newMediaSource); // 在指定位置插入 playlistSource.addMediaSource(insertPosition, newMediaSource); // 移除指定位置项目 playlistSource.removeMediaSource(itemPosition); // 移动项目位置 playlistSource.moveMediaSource(fromPosition, toPosition);

踩坑提醒：直接操作播放列表时，务必注意当前播放位置。我曾遇到移除当前播放项导致播放中断的问题，解决方案是先暂停播放，完成操作后再恢复。

2.3 处理列表变更事件

通过Player.Listener可以监听播放列表变化：

player.addListener(new Player.Listener() { @Override public void onTimelineChanged(Timeline timeline, int reason) { if (reason == Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED) { // 处理播放列表变更 updatePlaylistUI(); } } });

3. 循环播放模式深度解析

3.1 三种循环模式对比

ExoPlayer提供三种循环模式，通过player.setRepeatMode()设置：

REPEAT_MODE_OFF：不循环，播放到列表末尾停止
REPEAT_MODE_ONE：单曲循环
REPEAT_MODE_ALL：列表循环

// 设置列表循环 player.setRepeatMode(Player.REPEAT_MODE_ALL);

性能提示：在低端设备上，频繁切换循环模式可能导致轻微卡顿。建议在onPlayerStateChanged()回调中处理模式切换，避免在渲染关键帧时操作。

3.2 自定义循环逻辑

有时我们需要更复杂的循环逻辑，比如指定某几首歌循环。这时可以结合LoopingMediaSource：

// 创建需要循环的媒体源 MediaSource loopSource = new ProgressiveMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(loopVideoUri)); // 循环5次 LoopingMediaSource loopingSource = new LoopingMediaSource(loopSource, 5); // 加入播放列表 ConcatenatingMediaSource finalSource = new ConcatenatingMediaSource( loopingSource, normalSource );

4. 播放状态管理与恢复

4.1 保存和恢复播放位置

在配置变更或应用退到后台时，需要保存当前播放状态：

// 保存状态 Bundle playbackState = new Bundle(); playbackState.putInt("CURRENT_WINDOW", player.getCurrentWindowIndex()); playbackState.putLong("PLAYBACK_POSITION", player.getContentPosition()); // 恢复状态 player.seekTo( playbackState.getInt("CURRENT_WINDOW"), playbackState.getLong("PLAYBACK_POSITION") );

4.2 处理播放错误与自动跳过

通过监听播放错误实现自动跳过故障项目：

player.addListener(new Player.Listener() { @Override public void onPlayerError(PlaybackException error) { int currentIndex = player.getCurrentMediaItemIndex(); if (currentIndex < mediaItems.size() - 1) { player.seekToNext(); // 自动跳转到下一项 } } });

5. 高级功能实战：可编辑播放列表

5.1 完整播放列表管理类实现

下面是一个经过生产环境验证的播放列表管理器：

public class PlaylistManager { private final ExoPlayer player; private final ConcatenatingMediaSource concatenatingSource; public PlaylistManager(ExoPlayer player) { this.player = player; this.concatenatingSource = new ConcatenatingMediaSource(); player.setMediaSource(concatenatingSource); } public void addMediaItem(Uri uri) { MediaSource source = new ProgressiveMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(uri)); concatenatingSource.addMediaSource(source); } public void removeMediaItem(int position) { if (position >= 0 && position < concatenatingSource.getSize()) { // 处理当前正在播放项被移除的情况 if (player.getCurrentMediaItemIndex() == position) { boolean wasPlaying = player.isPlaying(); player.pause(); concatenatingSource.removeMediaSource(position); if (wasPlaying) player.play(); } else { concatenatingSource.removeMediaSource(position); } } } public void moveItem(int from, int to) { if (from != to && from >= 0 && to >= 0 && from < concatenatingSource.getSize() && to < concatenatingSource.getSize()) { concatenatingSource.moveMediaSource(from, to); } } }

5.2 与UI的交互优化

为提升用户体验，建议：

使用DiffUtil计算列表差异，实现平滑动画
在列表更新时显示加载状态
提供撤销操作功能

// 使用DiffUtil优化列表更新 DiffUtil.DiffResult diffResult = DiffUtil.calculateDiff( new MediaItemDiffCallback(oldList, newList)); diffResult.dispatchUpdatesTo(adapter);

6. 性能优化与调试技巧

6.1 内存优化策略

使用SimpleCache实现媒体缓存
限制同时加载的媒体项数量
及时释放不用的资源

// 初始化缓存 SimpleCache cache = new SimpleCache( cacheDir, new LeastRecentlyUsedCacheEvictor(100 * 1024 * 1024) // 100MB ); // 使用缓存的DataSource CacheDataSource.Factory cacheDataSourceFactory = new CacheDataSource.Factory() .setCache(cache) .setUpstreamDataSourceFactory(new DefaultDataSource.Factory(context));

6.2 调试日志分析

启用ExoPlayer的EventLogger可以获取详细播放信息：

player.addAnalyticsListener(new EventLogger());

典型日志分析：

缓冲不足：NETWORK_BUFFERING
解码错误：DECODER_ERROR
渲染延迟：RENDERER_DISABLED

7. 兼容性处理与最佳实践

7.1 多版本兼容方案

针对不同Android版本需要注意：

Android 10+的存储权限变化
后台播放限制
省电模式下的限制

// 检查后台播放权限 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); if (!notificationManager.isNotificationPolicyAccessGranted()) { // 请求权限 Intent intent = new Intent( Settings.ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS); startActivity(intent); } }