关于YouTube iframe嵌入视频未显示在观看历史的技术咨询

是否为预期行为？ #

是的，这属于预期行为。默认情况下，用标准iframe嵌入的YouTube播放器，观看行为不会自动同步到你的YouTube账号观看历史里。这是因为嵌入式播放器的会话和YouTube主站的会话默认是隔离的，系统不会主动把嵌入页面的播放行为关联到账号历史中。

调整方法 #

要让嵌入播放器的观看记录同步到账号历史，需要按以下步骤操作：

1. 启用YouTube Player API
   在嵌入URL里添加enablejsapi=1参数，开启API支持，修改后的iframe代码如下：

   <iframe id="ytplayer" type="text/html" width="640" height="360"
     src="https://www.youtube.com/embed/M7lc1UVf-VE?autoplay=1&enablejsapi=1"
     frameborder="0">
   </iframe>
   

2. 添加播放事件监听逻辑
   仅开启API还不够，需要编写JavaScript代码监听视频播放状态，触发观看记录的同步：

   // 加载YouTube Player API脚本
   var tag = document.createElement('script');
   tag.src = "https://www.youtube.com/iframe_api";
   var firstScriptTag = document.getElementsByTagName('script')[0];
   firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);
   
   var player;
   function onYouTubeIframeAPIReady() {
     player = new YT.Player('ytplayer', {
       events: {
         'onStateChange': onPlayerStateChange
       }
     });
   }
   
   function onPlayerStateChange(event) {
     // 当视频开始播放（状态码为1）时，API会自动关联登录账号的观看历史
     if (event.data == YT.PlayerState.PLAYING) {
       // 无需额外手动上报，API会处理会话关联逻辑
     }
   }
   

3. 关键注意点

   • 用户必须保持YouTube账号登录状态，且浏览器允许第三方Cookie（用于关联嵌入播放器和主站的会话）。
   • 代码调用需遵循YouTube Player API的使用规范，避免违规操作。

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