API iframe YouTube: как мне управлять плеером iframe, который уже находится в HTML? - PullRequest
141 голосов
/ 16 сентября 2011

Я хочу иметь возможность управлять плеерами YouTube на основе iframe. Эти игроки уже будут в 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. Затем я могу оперировать с «игроком» и звонить на него playVideo(), pauseVideo() и т. Д.

Но я хочу работать с игроками iframe, которые уже есть на этой странице.

Я мог бы сделать это очень легко с помощью старого метода встраивания, например:

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

Но это не работает с новыми фреймами. Как я могу назначить объект iframe уже на странице и затем использовать функции API на нем?

Ответы [ 4 ]

297 голосов
/ 22 сентября 2011

Ссылки Fiddle: Исходный код - Предварительный просмотр - Маленькая версия Обновление: эта маленькая функция будет выполнять код только в одном направлении.Если вам нужна полная поддержка (например, прослушиватели / получатели событий), посмотрите на Прослушивание событий Youtube в jQuery

В результате глубокого анализа кода,Я создал функцию: function callPlayer запрашивает вызов функции для любого видео на YouTube.См. Ссылку YouTube Api , чтобы получить полный список возможных вызовов функций.Прочитайте комментарии в исходном коде для объяснения.

17 мая 2012 года размер кода был удвоен, чтобы позаботиться о состоянии готовности игрока.Если вам нужна компактная функция, которая не связана с состоянием готовности игрока, см. 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");

Возможные вопросы (и ответы):

Q : Это не работает!
A : "Не работает" не является четким описанием.Вы получаете какие-либо сообщения об ошибках?Пожалуйста, покажите соответствующий код.

Q : playVideo не воспроизводит видео.
A : для воспроизведения требуется взаимодействие с пользователем, а также наличие allow="autoplay" на фрейме.См. https://developers.google.com/web/updates/2017/09/autoplay-policy-changes и https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide

Q : я встроил видео на YouTube с использованием <iframe src="http://www.youtube.com/embed/As2rZGPGKDY" />, но функция не выполняет никакой функции!
A : Вы должны добавить ?enablejsapi=1 в конце своего URL: /embed/vid_id?enablejsapi=1.

Q : я получаю сообщение об ошибке "Указана неверная или недопустимая строка».Почему?
A : API не работает должным образом на локальном хосте (file://).Разместите свою (тестовую) страницу в Интернете или используйте JSFiddle .Примеры: см. Ссылки в верхней части этого ответа.

Q : Как вы узнали об этом?
A : я потратил некоторое время на ручную работуинтерпретировать источник API.Я пришел к выводу, что мне нужно использовать метод postMessage.Чтобы узнать, какие аргументы передать, я создал расширение Chrome, которое перехватывает сообщения.Исходный код расширения можно загрузить здесь .

Q : какие браузеры поддерживаются?
A : каждый браузер, которыйподдерживает JSON и postMessage.

  • IE 8 +
  • Firefox 3.6+ (на самом деле 3.5, но document.readyState был реализован в 3.6)
  • Opera 10.50 +
  • Safari4 +
  • Chrome 3 +

Соответствующий ответ / реализация: Добавление видео в кадре с использованием jQuery
Полная поддержка API: Прослушиваниедля Youtube Event в jQuery
Официальный API: https://developers.google.com/youtube/iframe_api_reference

История изменений

  • 17 мая 2012
    Реализовано onYouTubePlayerReady: callPlayer('frame_id', function() { ... }).
    Функции автоматически ставятся в очередь, когда плеер еще не готов.
  • 24 июля 2012
    Обновлен и успешно протестирован в поддерживаемых браузерах (смотри вперед).
  • 10 октября2013 Когда функция передается в качестве аргумента, callPlayer вызывает проверку готовности.Это необходимо, потому что, когда callPlayer вызывается сразу после вставки iframe, когда документ готов, он не может точно знать, что iframe полностью готов.В Internet Explorer и Firefox этот сценарий привел к слишком раннему вызову postMessage, который был проигнорирован.
  • 12 декабря 2013 г., рекомендуется добавить &origin=* в URL.
  • 2В марте 2014 г. отозвана рекомендация удалить &origin=* в URL.
  • 9 апреля 2019 г. Исправлена ​​ошибка, приводившая к бесконечной рекурсии при загрузке YouTube до того, как страница была готова.Добавить заметку об автоигре.
31 голосов
/ 30 июля 2013

Похоже, YouTube обновил свой JS API, поэтому он доступен по умолчанию!Вы можете использовать существующий идентификатор iframe YouTube ...

<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заменить его на новый.Это также означает, что вам не нужно указывать videoId для конструктора.

См. Загрузка видеоплеера

16 голосов
/ 10 декабря 2014

Вы можете сделать это с гораздо меньшим кодом:

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/

4 голосов
/ 24 июля 2015

Моя собственная версия кода Ким Т, описанная выше, которая сочетается с некоторыми jQuery и позволяет нацеливать определенные фреймы.

$(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 || []
        } ), '*');
    }
}
...