Android音乐播放器歌曲重叠播放问题解决方案咨询

问题核心 #

每次从RecyclerView点击新歌曲时，会启动新的AudioPlayer实例，每个实例都创建独立的MediaPlayer，导致旧实例的音乐持续播放、新实例同时启动播放，出现重叠。同时需要保持后台播放（屏幕熄灭/返回主界面时不停止），仅在切换歌曲时停止当前播放。

解决方案：全局单例MediaPlayer管理 #

通过全局单例类统一管理MediaPlayer实例，确保整个应用只有一个播放载体，切歌时复用该实例，先停止旧播放再加载新歌曲。

步骤1：创建全局单例播放管理类 #

替换现有TMediaPlayer类，实现包含单例MediaPlayer的管理逻辑：

public class AudioPlayerManager {
    private static AudioPlayerManager instance;
    private MediaPlayer mediaPlayer;
    public int currentIndex = 0; // 全局维护当前歌曲索引

    private AudioPlayerManager() {
        mediaPlayer = new MediaPlayer();
    }

    public static synchronized AudioPlayerManager getInstance() {
        if (instance == null) {
            instance = new AudioPlayerManager();
        }
        return instance;
    }

    public MediaPlayer getMediaPlayer() {
        return mediaPlayer;
    }

    // 仅在应用彻底退出时释放资源（比如MainActivity的onDestroy）
    public void releasePlayer() {
        if (mediaPlayer != null) {
            mediaPlayer.stop();
            mediaPlayer.release();
            mediaPlayer = null;
            instance = null;
        }
    }
}

步骤2：修改AudioPlayer类适配单例 #

1. 移除本地MediaPlayer声明，替换为单例实例：

// 原代码：MediaPlayer mediaPlayer = new MediaPlayer();
// 替换为：
private AudioPlayerManager playerManager;
private MediaPlayer mediaPlayer;

2. 在onCreate中初始化单例：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.audioplayer);
    // ... 其他控件初始化代码 ...
    playerManager = AudioPlayerManager.getInstance();
    mediaPlayer = playerManager.getMediaPlayer();
    // ... 剩余初始化代码 ...
}

3. 修改playMusic方法，确保切歌时停止旧播放：

void playMusic() {
    try {
        // 先停止当前播放（如果正在播放）
        if (mediaPlayer.isPlaying()) {
            mediaPlayer.stop();
        }
        mediaPlayer.reset(); // 重置播放器状态
        mediaPlayer.setDataSource(currentSong.getPath());
        mediaPlayer.prepare();
        mediaPlayer.start();
    } catch (IOException e) {
        e.printStackTrace();
    }
    seekBar.setProgress(0);
    seekBar.setMax(mediaPlayer.getDuration());
    mediaPlayer.setOnCompletionListener(mp -> nextMusic());
}

4. 更新索引相关逻辑，使用单例的全局索引：

void nextMusic() {
    if (playerManager.currentIndex == songArray.size() - 1) {
        playerManager.currentIndex = 0;
    } else {
        if (shuffle) {
            playRandom();
        } else if (repeat) {
            // 重复播放当前歌曲，无需修改索引
            mediaPlayer.reset();
            setCurrentSong();
            return;
        }
        playerManager.currentIndex += 1;
    }
    mediaPlayer.reset();
    setCurrentSong();
}

void previousMusic() {
    if (playerManager.currentIndex == 0) {
        playerManager.currentIndex = songArray.size() - 1;
    } else {
        playerManager.currentIndex -= 1;
    }
    mediaPlayer.reset();
    setCurrentSong();
}

public void setCurrentSong() {
    this.currentSong = songArray.get(playerManager.currentIndex);
    // ... 剩余UI更新代码 ...
}

void playRandom() {
    Random r = new Random();
    playerManager.currentIndex = r.nextInt(songArray.size());
}

步骤3：优化Activity启动模式 #

在AndroidManifest.xml中设置AudioPlayer的启动模式为singleTop，避免重复创建实例：

<activity
    android:name=".AudioPlayer"
    android:launchMode="singleTop">
    <!-- 其他配置项 -->
</activity>

同时添加onNewIntent方法处理新歌曲请求：

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    songArray = (ArrayList<AudioModel>) intent.getSerializableExtra("List");
    // 获取RecyclerView点击的歌曲索引（需要在点击事件中传递该参数）
    int newIndex = intent.getIntExtra("songIndex", 0);
    playerManager.currentIndex = newIndex;
    mediaPlayer.reset();
    setCurrentSong();
}

修改RecyclerView点击事件，传递歌曲索引：

// RecyclerView条目点击逻辑
Intent intent = new Intent(context, AudioPlayer.class);
intent.putExtra("List", songArray);
intent.putExtra("songIndex", position); // 传递当前点击的位置
context.startActivity(intent);

关键说明 #

• 单例模式确保唯一播放实例：整个应用仅存在一个MediaPlayer，切歌时停止旧播放、重置后加载新歌曲，彻底解决重叠问题。
• 保留后台播放能力：未在onDestroy中释放播放器，因此返回主界面或屏幕熄灭时，音乐可继续播放。
• 启动模式优化：singleTop避免重复创建AudioPlayer实例，减少资源消耗，切歌流程更流畅。

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