159

我希望能够控制基于 iframe 的 YouTube 播放器。这个播放器已经在 HTML 中,但我想通过 JavaScript API 控制它们。

我一直在阅读iframe API 的文档,其中解释了如何使用 API 向页面添加新视频,然后使用 YouTube 播放器功能控制它:

var player;
function onYouTubePlayerAPIReady() {
    player = new YT.Player('container', {
        height: '390',
        width: '640',
        videoId: 'u1zgFlCw8Aw',
        events: {
            'onReady': onPlayerReady,
            'onStateChange': onPlayerStateChange
        }
    });
}

该代码创建一个新的播放器对象并将其分配给“播放器”,然后将其插入到#container div 中。然后我可以对“播放器”进行操作并在其上调用playVideo(),pauseVideo()等。

但我希望能够在页面上已经存在的 iframe 播放器上进行操作。

我可以用旧的嵌入方法很容易地做到这一点,比如:

player = getElementById('whateverID');
player.playVideo();

但这不适用于新的 iframe。如何分配页面上已有的 iframe 对象,然后在其上使用 API 函数?

4

7 回答 7

330

小提琴链接:源代码-预览-小版本
更新:这个小功能只会在一个方向上执行代码。如果您想要完全支持(例如事件侦听器/获取器),请查看Listening for Youtube Event in jQuery

作为深入代码分析的结果,我创建了一个函数:function callPlayer请求对任何带框的 YouTube 视频进行函数调用。请参阅YouTube Api 参考以获取可能的函数调用的完整列表。阅读源代码中的注释以获得解释。

2012 年 5 月 17 日,代码大小翻了一番,以照顾玩家的就绪状态。如果您需要一个不处理播放器就绪状态的紧凑函数,请参阅http://jsfiddle.net/8R5y6/

/**
 * @author       Rob W <gwnRob@gmail.com>
 * @website      https://stackoverflow.com/a/7513356/938089
 * @version      20190409
 * @description  Executes function on a framed YouTube video (see website link)
 *               For a full list of possible functions, see:
 *               https://developers.google.com/youtube/js_api_reference
 * @param String frame_id The id of (the div containing) the frame
 * @param String func     Desired function to call, eg. "playVideo"
 *        (Function)      Function to call when the player is ready.
 * @param Array  args     (optional) List of arguments to pass to function func*/
function callPlayer(frame_id, func, args) {
    if (window.jQuery && frame_id instanceof jQuery) frame_id = frame_id.get(0).id;
    var iframe = document.getElementById(frame_id);
    if (iframe && iframe.tagName.toUpperCase() != 'IFRAME') {
        iframe = iframe.getElementsByTagName('iframe')[0];
    }

    // When the player is not ready yet, add the event to a queue
    // Each frame_id is associated with an own queue.
    // Each queue has three possible states:
    //  undefined = uninitialised / array = queue / .ready=true = ready
    if (!callPlayer.queue) callPlayer.queue = {};
    var queue = callPlayer.queue[frame_id],
        domReady = document.readyState == 'complete';

    if (domReady && !iframe) {
        // DOM is ready and iframe does not exist. Log a message
        window.console && console.log('callPlayer: Frame not found; id=' + frame_id);
        if (queue) clearInterval(queue.poller);
    } else if (func === 'listening') {
        // Sending the "listener" message to the frame, to request status updates
        if (iframe && iframe.contentWindow) {
            func = '{"event":"listening","id":' + JSON.stringify(''+frame_id) + '}';
            iframe.contentWindow.postMessage(func, '*');
        }
    } else if ((!queue || !queue.ready) && (
               !domReady ||
               iframe && !iframe.contentWindow ||
               typeof func === 'function')) {
        if (!queue) queue = callPlayer.queue[frame_id] = [];
        queue.push([func, args]);
        if (!('poller' in queue)) {
            // keep polling until the document and frame is ready
            queue.poller = setInterval(function() {
                callPlayer(frame_id, 'listening');
            }, 250);
            // Add a global "message" event listener, to catch status updates:
            messageEvent(1, function runOnceReady(e) {
                if (!iframe) {
                    iframe = document.getElementById(frame_id);
                    if (!iframe) return;
                    if (iframe.tagName.toUpperCase() != 'IFRAME') {
                        iframe = iframe.getElementsByTagName('iframe')[0];
                        if (!iframe) return;
                    }
                }
                if (e.source === iframe.contentWindow) {
                    // Assume that the player is ready if we receive a
                    // message from the iframe
                    clearInterval(queue.poller);
                    queue.ready = true;
                    messageEvent(0, runOnceReady);
                    // .. and release the queue:
                    while (tmp = queue.shift()) {
                        callPlayer(frame_id, tmp[0], tmp[1]);
                    }
                }
            }, false);
        }
    } else if (iframe && iframe.contentWindow) {
        // When a function is supplied, just call it (like "onYouTubePlayerReady")
        if (func.call) return func();
        // Frame exists, send message
        iframe.contentWindow.postMessage(JSON.stringify({
            "event": "command",
            "func": func,
            "args": args || [],
            "id": frame_id
        }), "*");
    }
    /* IE8 does not support addEventListener... */
    function messageEvent(add, listener) {
        var w3 = add ? window.addEventListener : window.removeEventListener;
        w3 ?
            w3('message', listener, !1)
        :
            (add ? window.attachEvent : window.detachEvent)('onmessage', listener);
    }
}

用法:

callPlayer("whateverID", function() {
    // This function runs once the player is ready ("onYouTubePlayerReady")
    callPlayer("whateverID", "playVideo");
});
// When the player is not ready yet, the function will be queued.
// When the iframe cannot be found, a message is logged in the console.
callPlayer("whateverID", "playVideo");

可能的问题(和答案):

:不行!
:“不起作用”不是一个明确的描述。您收到任何错误消息吗?请出示相关代码。

playVideo不播放视频。
A : 播放需要用户交互,并且在allow="autoplay"iframe 上存在。请参阅https://developers.google.com/web/updates/2017/09/autoplay-policy-changeshttps://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide

Q : 我嵌入了一个 YouTube 视频使用<iframe src="http://www.youtube.com/embed/As2rZGPGKDY" />,但该功能没有执行任何功能!
:您必须?enablejsapi=1在 URL 的末尾添加:/embed/vid_id?enablejsapi=1.

:我收到错误消息“指定了无效或非法的字符串”。为什么?
Afile:// : API 在本地主机 ( )上无法正常运行。在线托管您的(测试)页面,或使用JSFiddle。示例:请参阅此答案顶部的链接。

:你是怎么知道的?
A : 我花了一些时间来手动解释 API 的源代码。我得出结论,我必须使用该postMessage方法。为了知道要传递哪些参数,我创建了一个拦截消息的 Chrome 扩展程序。扩展的源代码可以在这里下载。

:支持哪些浏览器?
:所有支持JSONpostMessage.

  • 浏览器 8+
  • Firefox 3.6+(实际上是 3.5,但document.readyState在 3.6 中实现)
  • 歌剧 10.50+
  • 野生动物园 4+
  • 铬 3+

相关答案/实现:使用 jQuery 完全 API 支持淡入带框视频:在 jQuery 官方 API中侦听 Youtube 事件: https ://developers.google.com/youtube/iframe_api_reference

修订记录

  • 2012 年 5 月 17 日
    实施onYouTubePlayerReadycallPlayer('frame_id', function() { ... }).
    当播放器尚未准备好时,函数会自动排队。
  • 2012 年 7 月 24 日
    更新并在支持的浏览器中成功测试(向前看)。
  • 2013 年 10 月 10 日 当函数作为参数传递时,会callPlayer强制检查就绪情况。这是必需的,因为当callPlayer文档准备好时,在插入 iframe 之后立即调用 when ,它不能确定 iframe 是否完全准备好。在 Internet Explorer 和 Firefox 中,这种情况会导致过早调用postMessage,而被忽略。
  • 2013 年 12 月 12 日,建议添加&origin=*URL。
  • 2014 年 3 月 2 日,撤回了删除&origin=*到 URL 的建议。
  • 2019 年 4 月 9 日,修复了在页面准备好之前加载 YouTube 时导致无限递归的错误。添加有关自动播放的注释。
于 2011-09-22T10:30:52.903 回答
37

看起来 YouTube 已经更新了他们的 JS API,所以这是默认可用的!您可以使用现有 YouTube iframe 的 ID...

<iframe id="player" src="http://www.youtube.com/embed/M7lc1UVf-VE?enablejsapi=1&origin=http://example.com" frameborder="0"></iframe>

...在您的 JS 中...

var player;
function onYouTubeIframeAPIReady() {
  player = new YT.Player('player', {
    events: {
      'onStateChange': onPlayerStateChange
    }
  });
}

function onPlayerStateChange() {
  //...
}

...并且构造函数将使用您现有的 iframe 而不是用新的 iframe 替换它。这也意味着您不必将 videoId 指定给构造函数。

请参阅加载视频播放器

于 2013-07-29T21:38:59.957 回答
21

你可以用更少的代码做到这一点:

function callPlayer(func, args) {
    var i = 0,
        iframes = document.getElementsByTagName('iframe'),
        src = '';
    for (i = 0; i < iframes.length; i += 1) {
        src = iframes[i].getAttribute('src');
        if (src && src.indexOf('youtube.com/embed') !== -1) {
            iframes[i].contentWindow.postMessage(JSON.stringify({
                'event': 'command',
                'func': func,
                'args': args || []
            }), '*');
        }
    }
}

工作示例:http: //jsfiddle.net/kmturley/g6P5H/296/

于 2014-12-10T20:42:33.800 回答
5

我自己的 Kim T 上面的代码版本结合了一些 jQuery 并允许定位特定的 iframe。

$(function() {
    callPlayer($('#iframe')[0], 'unMute');
});

function callPlayer(iframe, func, args) {
    if ( iframe.src.indexOf('youtube.com/embed') !== -1) {
        iframe.contentWindow.postMessage( JSON.stringify({
            'event': 'command',
            'func': func,
            'args': args || []
        } ), '*');
    }
}
于 2015-07-24T12:45:55.263 回答
1

我在上面的例子中遇到了问题,所以相反,我只是在源代码中使用带有自动播放的 JS 插入 iframe,它对我来说很好。我也有可能使用 Vimeo 或 YouTube,所以我需要能够处理它。

这个解决方案并不令人惊奇,可以清理,但这对我有用。我也不喜欢 jQuery,但项目已经在使用它,我只是重构现有代码,随时清理或转换为 vanilla JS :)

<!-- HTML -->
<div class="iframe" data-player="viemo" data-src="$PageComponentVideo.VideoId"></div>


<!-- jQuery -->
$(".btnVideoPlay").on("click", function (e) {
        var iframe = $(this).parents(".video-play").siblings(".iframe");
        iframe.show();

        if (iframe.data("player") === "youtube") {
            autoPlayVideo(iframe, iframe.data("src"), "100%", "100%");
        } else {
            autoPlayVideo(iframe, iframe.data("src"), "100%", "100%", true);
        }
    });

    function autoPlayVideo(iframe, vcode, width, height, isVimeo) {
        if (isVimeo) {
            iframe.html(
                '<iframe width="' +
                    width +
                    '" height="' +
                    height +
                    '" src="https://player.vimeo.com/video/' +
                    vcode +
                    '?color=ff9933&portrait=0&autoplay=1" frameborder="0" allowfullscreen wmode="Opaque"></iframe>'
            );
        } else {
            iframe.html(
                '<iframe width="' +
                    width +
                    '" height="' +
                    height +
                    '" src="https://www.youtube.com/embed/' +
                    vcode +
                    '?autoplay=1&loop=1&rel=0&wmode=transparent" frameborder="0" allowfullscreen wmode="Opaque"></iframe>'
            );
        }
    }
于 2021-05-16T23:35:17.357 回答
0

谢谢 Rob W 的回答。

我一直在 Cordova 应用程序中使用它来避免加载 API,这样我就可以轻松控制动态加载的 iframe。

我一直希望能够从 iframe 中提取信息,例如状态 (getPlayerState) 和时间 (getCurrentTime)。

Rob W 帮助强调了 API 是如何使用 postMessage 工作的,但当然这只会向一个方向发送信息,从我们的网页到 iframe。访问 getter 需要我们监听从 iframe 发回给我们的消息。

我花了一些时间来弄清楚如何调整 Rob W 的答案以激活和收听 iframe 返回的消息。我基本上搜索了 YouTube iframe 中的源代码,直到找到负责发送和接收消息的代码。

关键是将“事件”更改为“侦听”,这基本上可以访问所有旨在返回值的方法。

以下是我的解决方案,请注意,我仅在请求 getter 时才切换到“侦听”,您可以调整条件以包含额外的方法。

进一步注意,您可以通过将 console.log(e) 添加到 window.onmessage 来查看从 iframe 发送的所有消息。您会注意到,一旦激活收听,您将收到持续更新,其中包括视频的当前时间。调用 getPlayerState 等 getter 将激活这些持续更新,但只会在状态发生变化时发送涉及视频状态的消息。

function callPlayer(iframe, func, args) {
    iframe=document.getElementById(iframe);
    var event = "command";
    if(func.indexOf('get')>-1){
        event = "listening";
    }

    if ( iframe&&iframe.src.indexOf('youtube.com/embed') !== -1) {
      iframe.contentWindow.postMessage( JSON.stringify({
          'event': event,
          'func': func,
          'args': args || []
      }), '*');
    }
}
window.onmessage = function(e){
    var data = JSON.parse(e.data);
    data = data.info;
    if(data.currentTime){
        console.log("The current time is "+data.currentTime);
    }
    if(data.playerState){
        console.log("The player state is "+data.playerState);
    }
}
于 2020-05-04T11:57:48.330 回答
0

如果请求不是问题,并且您希望这种行为用于显示/隐藏视频之类的东西,一个快速的解决方案是删除/添加 iframe,或清理和填充src.

const stopPlayerHack = (iframe) => {
    let src = iframe.getAttribute('src');
    iframe.setAttribute('src', '');
    iframe.setAttribute('src', src);
}

iframe 将被删除、停止播放并在此之后立即加载。在我的情况下,我改进了代码,只在灯箱打开时再次设置 src,因此只有在用户要求观看视频时才会发生负载。

于 2021-06-30T22:11:53.023 回答