使用YouTube Player API检测视频播放结束功能无法正常生效
YouTube Player API指定起止时间后ENDED事件偶发不触发问题解决方案
问题描述
我通过YouTube Player API成功加载了多个YouTube视频,希望检测到任意视频播放结束后执行对应操作,现阶段测试仅弹出alert提示,相关代码如下:
// Loads the IFrame Player API code asynchronously. var tag = document.createElement('script'); tag.src = "https://www.youtube.com/iframe_api"; var firstScriptTag = document.getElementsByTagName('script')[0]; firstScriptTag.parentNode.insertBefore(tag, firstScriptTag); // Creates an <iframe> (and YouTube player) // after the API code downloads. var players = new Array(); var playerInfoList = [{"video_id":"SMKPKGW083c","start_seconds":"130","end_seconds":"140","autoplay":"1","mute":"1"},{"video_id":"ianb7qAGd9I","start_seconds":"1","end_seconds":"5","autoplay":"0","mute":"0"}]; function onYouTubeIframeAPIReady() { for (var i = 0; i < playerInfoList.length; i++) { var curplayer = createPlayer(playerInfoList[i]); players[playerInfoList[i].video_id] = new Array(); players[playerInfoList[i].video_id]['player'] = curplayer; players[playerInfoList[i].video_id]['data'] = playerInfoList[i]; } } function createPlayer(playerInfo) { return new YT.Player(playerInfo.video_id, { height: '100%', width: '100%', videoId: playerInfo.video_id, host: window.location.protocol+'//www.youtube.com', playerVars: { autoplay: playerInfo.autoplay,mute: playerInfo.mute}, events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange } }); } // 4. The API will call this function when the video player is ready. function onPlayerReady(event) { var videoId = event.target.getIframe().id; event.target.playVideo(); if(players[videoId]['player']){ var player = players[videoId]['player']; var data = players[videoId]['data']; player.loadVideoById({'videoId': videoId, 'startSeconds': data.start_seconds, 'endSeconds': data.end_seconds}); } } // when video ends function onPlayerStateChange(event) { var videoId = event.target.getIframe().id; if(event.data == YT.PlayerState.ENDED) { alert('done') } else{ } } function stopVideo() { player.stopVideo(); }
我为YouTube播放器API设置了起止秒数,预期播放到设定的结束时间时会触发alert函数,但绝大多数情况下alert都不会弹出。我尝试过删除浏览器Cookie后刷新页面,偶尔可以生效,但运行一段时间后又会失效。
补充:在浏览器无痕模式下可以稳定触发alert函数。
根因说明
这个现象的核心原因是普通浏览模式下YouTube播放器的本地缓存机制,重复加载同一段视频时播放器会复用缓存的播放状态,导致指定endSeconds后的结束事件流没有正常触发;无痕模式没有持久化缓存,所以运行逻辑完全正常。此外原有代码还存在参数类型不匹配、播放状态调用冲突的问题,也会加剧事件触发不稳定的情况。
修复方案
具体修改点:
- 修正
loadVideoById参数类型:API要求startSeconds、endSeconds传入数字类型,原代码传入的是字符串类型,会导致部分场景下结束时间参数不生效 - 移除
onPlayerReady中重复的playVideo调用:loadVideoById在设置autoplay=1时会自动触发播放,重复调用会导致状态冲突 - 新增播放进度轮询逻辑:补全API事件漏触发的场景,主动校验当前播放时间和结束时间的差值,手动触发结束逻辑
- 新增播放器配置参数:增加
version=3强制使用最新版API,减少缓存兼容问题,增加rel=0、disablekb=1避免用户操作、推荐视频干扰播放状态 - 新增事件触发标记:避免同一次播放重复触发结束逻辑
修正后核心代码:
// 修正后的createPlayer函数,增加必要的playerVars参数 function createPlayer(playerInfo) { return new YT.Player(playerInfo.video_id, { height: '100%', width: '100%', videoId: playerInfo.video_id, host: window.location.protocol+'//www.youtube.com', playerVars: { autoplay: playerInfo.autoplay, mute: playerInfo.mute, rel: 0, disablekb: 1, version: 3 }, events: { 'onReady': onPlayerReady, 'onStateChange': onPlayerStateChange } }); } // 修正后的onPlayerReady函数 function onPlayerReady(event) { var videoId = event.target.getIframe().id; if(players[videoId]['player']){ var player = players[videoId]['player']; var data = players[videoId]['data']; // 把字符串参数转为数字类型 const startSec = parseInt(data.start_seconds); const endSec = parseInt(data.end_seconds); player.loadVideoById({ 'videoId': videoId, 'startSeconds': startSec, 'endSeconds': endSec }); // 新增轮询逻辑补全漏触发场景,200ms校验一次播放进度 players[videoId]['checkTimer'] = setInterval(() => { const currentTime = player.getCurrentTime(); // 预留0.5秒误差空间,避免网络波动导致判断不准 if(currentTime >= endSec - 0.5) { clearInterval(players[videoId]['checkTimer']); if(!players[videoId]['endedFired']) { players[videoId]['endedFired'] = true; alert('done'); // 其他结束后要执行的逻辑写在这里 } } }, 200); } } // 修正后的状态监听函数,避免重复触发 function onPlayerStateChange(event) { var videoId = event.target.getIframe().id; if(event.data == YT.PlayerState.ENDED) { if(players[videoId]['checkTimer']) clearInterval(players[videoId]['checkTimer']); if(!players[videoId]['endedFired']) { players[videoId]['endedFired'] = true; alert('done') } } else if(event.data == YT.PlayerState.PLAYING) { // 播放时重置触发标记,方便循环播放等场景复用 players[videoId]['endedFired'] = false; } }
内容的提问来源于stack exchange,提问作者Padawan
相关产品推荐
相关产品推荐

