如何通过YouTube API实现播放列表完整随机播放？

嘿，我太懂你折腾YouTube API随机播放脚本的痛苦了——那些半吊子示例真的让人头大，要么首曲死死固定，要么乱序逻辑根本不彻底。刚好我之前也踩过类似的坑，给你一套能实现**完全随机（首曲+后续全乱序）**的方案，你可以直接参考：

核心思路 #

要实现你要的效果，关键是手动打乱整个播放列表的视频顺序，再把乱序后的列表作为播放源，而不是依赖YouTube播放器自带的随机模式（自带模式大概率存在首曲固定或乱序不彻底的问题）。

具体代码实现 #

// 初始化YouTube播放器实例
let player;
function onYouTubeIframeAPIReady() {
  player = new YT.Player('player', {
    height: '360',
    width: '640',
    events: {
      'onReady': onPlayerReady,
      'onStateChange': onPlayerStateChange
    }
  });
}

// 播放器就绪后，获取播放列表并完成全乱序
async function onPlayerReady(event) {
  const playlistId = '你的播放列表ID'; // 替换成你自己的播放列表ID
  const videoIds = await getAllPlaylistVideos(playlistId);
  const shuffledIds = shuffleArray(videoIds);
  
  // 加载第一个随机视频并启动播放
  player.loadVideoById(shuffledIds[0]);
  // 将剩余乱序视频依次加入播放队列
  for(let i = 1; i < shuffledIds.length; i++) {
    player.cueVideoById(shuffledIds[i]);
  }
}

// 分页获取播放列表所有视频ID（处理API单次返回上限）
async function getAllPlaylistVideos(playlistId) {
  let videoIds = [];
  let nextPageToken = '';
  
  do {
    const response = await fetch(`https://www.googleapis.com/youtube/v3/playlistItems?part=contentDetails&playlistId=${playlistId}&maxResults=50&key=你的API密钥`); // 替换成你的API密钥
    const data = await response.json();
    
    videoIds = videoIds.concat(data.items.map(item => item.contentDetails.videoId));
    nextPageToken = data.nextPageToken;
  } while(nextPageToken);
  
  return videoIds;
}

// Fisher-Yates洗牌算法（最公平的全乱序实现）
function shuffleArray(array) {
  const newArray = [...array];
  for (let i = newArray.length - 1; i > 0; i--) {
    const j = Math.floor(Math.random() * (i + 1));
    [newArray[i], newArray[j]] = [newArray[j], newArray[i]];
  }
  return newArray;
}

// 监听播放结束状态，自动播放下一个乱序视频
function onPlayerStateChange(event) {
  if(event.data === YT.PlayerState.ENDED) {
    player.nextVideo();
  }
}

关键细节说明 #

• Fisher-Yates洗牌算法：这是目前最公平的数组乱序方法，能保证每个视频的位置都是真正随机的，避免了简单乱序方法的概率偏倚问题。
• 手动构建播放队列：先加载第一个随机视频，再把剩下的乱序视频依次加入队列，播放器会严格按照我们打乱的顺序播放，完全符合你“首曲随机+后续全随机”的需求。
• 分页处理播放列表：因为YouTube API单次最多返回50条数据，所以用循环处理分页，确保能获取到播放列表的所有视频。

你只需要把代码里的你的播放列表ID和你的API密钥替换成自己的信息，就能直接用啦。如果遇到跨域问题，可以把获取播放列表的逻辑放到后端，或者利用YouTube API的CORS支持（公开API一般允许前端请求）。

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