如何让嵌入的YouTube播放列表自动跳过私有/不可嵌入视频？

阿华AIGC实验室

2026-5-14

解决YouTube播放列表自动跳过私有/不可嵌入视频并自动播放的问题

我明白你的痛点——嵌入的播放列表遇到私有视频就卡壳，加了错误处理却没法自动播放下一个，确实让人头疼。咱们来一步步修复这个问题：

问题根源

你原来的onError逻辑里直接调用nextVideo()后马上playVideo()，但播放器切换视频需要一点时间加载元数据，这时候调用playVideo()往往因为视频还没准备好而失效。另外，咱们还得针对性处理YouTube的错误代码，确保只跳过真正不可用的视频。

修复后的完整代码

<div id="muteYouTubeVideoPlayer"></div>
<script async src="https://www.youtube.com/iframe_api"></script>
<script>
function onYouTubeIframeAPIReady() {
  var player;
  player = new YT.Player('muteYouTubeVideoPlayer', {
    width: 940, // Player width (in px)
    height: 530, // Player height (in px)
    playerVars: {
      listType:'playlist',
      list: '{{LIST_ID}}', // 替换为你的播放列表ID
      autoplay: 1, // Auto-play the video on load
      controls: 1, // Show pause/play buttons in player
      showinfo: 0, // Hide the video title
      modestbranding: 1, // Hide the Youtube Logo
      loop: 1, // Run the video in a loop
      fs: 0, // Hide the full screen button
      cc_load_policy: 0, // Hide closed captions
      iv_load_policy: 3, // Hide the Video Annotations
      autohide: 0 // Hide video controls when playing
    },
    events: {
      onReady: function(e) {
        e.target.mute();
      },
      onError: function(e) {
        // 针对私有/不可用/不可嵌入的错误代码处理
        const errorCodesToSkip = [100, 101, 150];
        if (errorCodesToSkip.includes(e.data)) {
          // 切换到下一个视频
          e.target.nextVideo();
          
          // 监听播放器状态，等视频准备就绪后自动播放
          const handleVideoReady = (stateEvent) => {
            // 当视频进入已加载就绪状态（CUED）时播放
            if (stateEvent.data === YT.PlayerState.CUED) {
              e.target.playVideo();
              // 移除监听，避免重复触发
              e.target.removeEventListener('onStateChange', handleVideoReady);
            }
          };
          
          e.target.addEventListener('onStateChange', handleVideoReady);
        }
      },
      // 额外处理循环播放到列表开头的情况（如果第一个视频不可用）
      onStateChange: function(e) {
        if (e.data === YT.PlayerState.ENDED && player.getLoop()) {
          // 循环到开头后如果遇到错误，onError会自动处理
          player.playVideo();
        }
      }
    }
  });
}
</script>

关键改进点

错误代码精准匹配：只处理100（视频不存在/私有）、101/150（视频不可嵌入）这三类错误，避免误跳过其他问题。
状态监听触发播放：通过onStateChange监听视频的CUED状态，确保视频完全加载就绪后再调用playVideo()，解决了直接调用不生效的问题。
循环边界处理：当播放列表循环到开头时，主动触发播放，确保即使第一个视频是好的也能继续循环。