Android应用集成YouTube：视频播放队列实现技术咨询

嘿，我来帮你梳理下基于现有代码的播放队列实现方案，一步步来完善这个功能～

1. 先保存YouTubePlayer实例 #

你在初始化成功回调里已经拿到了youTubePlayer对象，首先要把它存为Activity/Fragment的成员变量，这样后续操作队列时能直接调用：

private var youtubePlayer: YouTubePlayer? = null

override fun onInitializationSuccess(provider: YouTubePlayer.Provider, player: YouTubePlayer, wasRestored: Boolean) {
    this.youtubePlayer = player
    // 如果不是恢复状态，设置播放相关监听
    if (!wasRestored) {
        player.setPlaybackEventListener(playbackEventListener)
        player.setPlayerStateChangeListener(playerStateChangeListener)
    }
}

2. 定义播放队列的数据结构 #

用一个MutableList来存放视频ID就很合适，再写个方法添加视频到队列：

private val videoQueue = mutableListOf<String>()

// 添加视频到队列的方法
fun addVideoToQueue(videoId: String) {
    videoQueue.add(videoId)
    // 如果当前没有正在播放的视频，直接启动播放
    if (youtubePlayer?.isPlaying != true && youtubePlayer?.currentVideoId == null) {
        playNextVideo()
    }
}

3. 实现自动切换下一个视频 #

通过PlaybackEventListener监听视频播放结束的事件，自动触发下一个视频的播放：

private val playbackEventListener = object : YouTubePlayer.PlaybackEventListener {
    override fun onPlaying() {}
    override fun onPaused() {}
    override fun onStopped() {}
    override fun onBuffering(isBuffering: Boolean) {}
    override fun onSeekTo(seconds: Int) {}

    override fun onVideoEnded() {
        // 播放结束后移除当前视频，播放队列里的下一个
        if (videoQueue.isNotEmpty()) {
            videoQueue.removeAt(0)
            playNextVideo()
        }
    }
}

private fun playNextVideo() {
    if (videoQueue.isNotEmpty() && youtubePlayer != null) {
        val nextVideoId = videoQueue.first()
        // cueVideo是加载视频但不自动播放，loadVideo会直接播放，按需选择
        youtubePlayer?.cueVideo(nextVideoId)
        // youtubePlayer?.loadVideo(nextVideoId)
    }
}

4. 实用的队列管理扩展功能 #

你还可以给队列加这些常用功能：

• 移除指定位置的视频：videoQueue.removeAt(index)
• 清空整个队列：videoQueue.clear()，记得同时暂停/停止播放器
• 手动切换到下一个：直接调用playNextVideo()即可

5. 关键注意事项 #

• 确保你的YouTube API Key在Google Cloud Console已经启用了YouTube Android Player API和YouTube Data API v3权限
• 处理播放器销毁：在页面销毁时释放资源，避免内存泄漏：

override fun onDestroy() {
    super.onDestroy()
    youtubePlayer?.release()
}

• 如果是在Fragment中使用，建议用childFragmentManager替代fragmentManager，适配AndroidX
• 处理播放错误：通过PlayerStateChangeListener的onError回调，比如播放失败时跳过当前视频或者重试

内容的提问来源于stack exchange，提问作者nick.tdr