當你網頁內嵌了一個 YouTube,通常的做法就是對那個影片點選分享 => 內嵌,就會跑出一條讓你複製貼上的 iframe,像是:

<iframe src="https://www.youtube.com/embed/PEr5agHOTcg" width="560" height="315" frameborder="0" allowfullscreen="allowfullscreen"></iframe>

但是假設你希望有人點選撥放這部內嵌影片時,網頁可以做點什麼時,如果我們可以自定義的暫停/播放選項控製播放器,那將會很有趣。所以現在這是一個非常酷的東西像是紀錄點擊,或是 CSS 在播放的時候有些變換,那該怎麼辦呢?那就是 YouTube IFrame Player API 可以辦得到。

YouTube IFrame Player API

YouTube其實有提供一個很好用的工具,叫做IFrame Player API,可以利用這東西來做一些簡單的觸發或是監聽

  1. 首先,我們必須創建具有特定 ID 的<div>(此處為"視頻"),其中腳本將創建嵌入式 <iframe> 視頻播放器。因此,我們無需從 YouTube 網站創建嵌入式 <iframe> 視頻播放器。

  2. onYouTubeIframeAPIReady():這是預定義的函數,通過該函數首次加載頁面時將調用 API。我們必須使用<div>中提到的'id'來調用它(這裡是"視頻")。

    player = new YT.Player('video',

調用 API 後,它會準備一個具有以下特定參數的對象:

  • "videoId":我們從 youtube 視頻頁面鏈接獲得的。例如 - "http://www.youtube.com/watch?v=zZpVlhehzVE" ; ,這裡'zZpVlhehzVE'是視頻 ID。
  • "height":視頻幀高度。
  • "width":視頻幀寬度。
  • "events":它定義了您要調用的事件,它具有以下方法:

    "onReady":此事件調用具有要實現的功能(無論您希望如何)的函數。第一次加載視頻播放器時會調用此方法。

    "onStateChange":這個事件對我們非常熟悉,而且我們經常這樣做。這只是暫停/播放/停止功能。當我們通過點擊視頻幀暫停/播放/停止視頻時,正在調用此事件。因此,調用一個函數,我們可以在調用此事件時執行任何操作。

下面簡單的程式範例,播放後跳出一個alert()訊息:

HTML

<div id="video"></div>

Javascript

var player;

var tag = document.createElement('script');
tag.src = "https://www.youtube.com/iframe_api"; // Take the API address.
var firstScriptTag = document.getElementsByTagName('script')[0];
firstScriptTag.parentNode.insertBefore(tag, firstScriptTag); // Include the API inside the page.

function onYouTubeIframeAPIReady() {
    player = new YT.Player("video", {
        videoId: "zZpVlhehzVE", //你的Youtube 影片ID
        events: {
            onStateChange: function(event) {
                if (event.data == YT.PlayerState.PLAYING) {
                    alert("hello!"); //這邊是當開始播放後,需要做的動作
                }
            }
        }
    });
}

Demo 1


Youtube iframe API 使用自訂按鈕 jQuery

在此之前,我們必須確保我們將在支持 HTML5 postMessage 功能的瀏覽器中使用和檢查反射。但幸運的是,除了 IE7 之外,所有現代瀏覽器目前都支持 HTML5 postMessage 功能。

HTML

<div id="video"></div>
<div>
    <button id="pause">Pause</button>
    <button id="play">Play</button>
    <button id="stop">Stop</button>
</div>

Javascript

var player;
var playerSatus;

var tag = document.createElement('script');
tag.src = "https://www.youtube.com/iframe_api"; // Take the API address.
var firstScriptTag = document.getElementsByTagName('script')[0];
firstScriptTag.parentNode.insertBefore(tag, firstScriptTag); // Include the API inside the page.

/**
* Integration of onYouTubeIframeAPIReady() functtion.
* - Called while the video is first time loaded.
* - Also place the iframe embaded youtube video in the div with the id 'video'.
*/
function onYouTubeIframeAPIReady() {
player = new YT.Player('video', {
    videoId: 'zZpVlhehzVE', // Providing the video ID.
    height: '284', // Video height.
    width: '486', // Video width.
    events: {
    'onReady': onPlayerReady, // Initializing the on load function.
    'onStateChange': onPlayerStateChange // Initializing the on change action function.
    }
});
}

/**
* Integration of onPlayerReady() functtion.
* - Called while the video is loaded and let the video automatically play.
*/
function onPlayerReady(event) {
    event.target.playVideo(); // Here we are auto playing the video on loading the page.
}

/**
* Integration of onPlayerReady() functtion.
* - Called while pause/replay/stop the video.
*/
function onPlayerStateChange(event){
    playerSatus = event.data;
}

jQuery 定制功能

  1. 暫停: 我們已經有了<button>(我們可以設計為暫停按鈕),ID 為"pause"。現在點擊這個,我們將發起一個事件,借助"pauseVideo()"函數(在 API 中預定義)暫停正在運行的視頻。

    還有一件事需要注意,我們可以通過全局變量(已定義)"playerSatus"輕鬆跟踪視頻是否正在播放或暫停或停止。在加載視頻作為playerSatus = event.dataonPlayerStateChange功能。所以讓我們看看這將如何發揮作用。

    /* We are doing the event call using jQuery */
    $('#pause').click( function(){
        // Checks for the video is playing or not.
        if (playerSatus == YT.PlayerState.PLAYING) {
            player.pauseVideo(); // 'player' variable we already defined and assigned.
        }
    });
  2. 播放: 現在播放視頻,我們將檢查視頻是否已停止,然後我們使用playVideo()函數(在 API 中預定義)。

    $('#play').click( function(){
        // Checks for the video is paused or not.
        if (playerSatus == YT.PlayerState.PAUSED) {
            player.playVideo();
        }
    });
  3. 停止: 現在停止視頻,我們將檢查視頻是否正在播放,然後我們使用stopVideo()函數(在 API 中預定義)。

    $('#stop').click( function(){
        // Checks for the video is playing or not.
        if (playerSatus == YT.PlayerState.PLAYING) {
            player.stopVideo();
        }
    });

Demo2


Youtube iframe API同時嵌入多個視頻

<div id="ytplayer1"></div>
<div id="ytplayer2"></div>

<script>
  var player;
  var player2;
  function onYouTubePlayerAPIReady() {
    player = new YT.Player('ytplayer1', {
      height: '390',
      width: '640',
      videoId: 'hdy78ehsjdi'
    });
    player2 = new YT.Player('ytplayer2', {
      height: '390',
      width: '640',
      videoId: '81hdjskilct'
    });
  }
</script>

文章引用:
Youtube 與網頁互動的好幫手
YouTube API Integration

您也可能喜歡這些文章