You need to enable JavaScript to run this app. 使用YouTube Player API检测视频播放结束功能无法正常生效
优惠活动
大模型
产品
解决方案
定价
更多

使用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后的结束事件流没有正常触发;无痕模式没有持久化缓存,所以运行逻辑完全正常。此外原有代码还存在参数类型不匹配、播放状态调用冲突的问题,也会加剧事件触发不稳定的情况。

修复方案

具体修改点:

  1. 修正loadVideoById参数类型:API要求startSeconds、endSeconds传入数字类型,原代码传入的是字符串类型,会导致部分场景下结束时间参数不生效
  2. 移除onPlayerReady中重复的playVideo调用:loadVideoById在设置autoplay=1时会自动触发播放,重复调用会导致状态冲突
  3. 新增播放进度轮询逻辑:补全API事件漏触发的场景,主动校验当前播放时间和结束时间的差值,手动触发结束逻辑
  4. 新增播放器配置参数:增加version=3强制使用最新版API,减少缓存兼容问题,增加rel=0、disablekb=1避免用户操作、推荐视频干扰播放状态
  5. 新增事件触发标记:避免同一次播放重复触发结束逻辑

修正后核心代码:

// 修正后的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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 19:15:02