DIV CSS 佈局教程網

用 JavaScript + HTML5 Canvas 擷取影片畫面幀
編輯:關於JavaScript     

影音播放頁面常有「把這一刻存成圖片」的需求,例如影片標註、證據留存或社群分享。HTML5 的 <video> 搭配 <canvas> 就能在瀏覽器端完成這件事,不需要後端轉檔,也不必安裝任何外掛。

一、頁面結構

先擺一個原生 video 元素、一顆觸發用的按鈕,以及一個用來承接結果的容器:

<video id="video" controls="controls">
  <source src="movie.mp4" type="video/mp4" />
</video>
<button id="capture">擷取畫面</button>
<div id="output"></div>

二、原理拆解

整個流程只有三個動作:

  1. 建立一塊 canvas,尺寸依需求縮放(這裡取原始解析度的 0.25 倍)。
  2. 用 drawImage() 把 video 目前顯示的那一格畫面「畫」進 canvas。
  3. 用 canvas.toDataURL() 轉成 base64 資料 URL,塞進 <img> 的 src 就能顯示或提供下載。

三、實作程式碼

(function () {
  "use strict";

  var video, $output;
  var scale = 0.25; // 縮圖比例,1 代表原始尺寸

  var initialize = function () {
    $output = $("#output");
    video = $("#video").get(0);
    $("#capture").click(captureImage);
  };

  var captureImage = function () {
    var canvas = document.createElement("canvas");
    canvas.width = video.videoWidth * scale;
    canvas.height = video.videoHeight * scale;

    canvas.getContext("2d")
      .drawImage(video, 0, 0, canvas.width, canvas.height);

    var img = document.createElement("img");
    img.src = canvas.toDataURL();
    $output.prepend(img);
  };

  $(initialize);
}());

四、實務上容易踩到的坑

  • videoWidth 為 0:影片中繼資料(metadata)還沒載入完成時,寬高會是 0。建議監聽 loadedmetadata 或 loadeddata 事件後再開放擷取按鈕。
  • 跨來源影片:若影片來自其他網域且未帶 CORS 標頭,canvas 會進入「污染」狀態,呼叫 toDataURL() 會丟出 SecurityError。解法是伺服器送出 Access-Control-Allow-Origin,並在 video 上加上 crossorigin="anonymous"。
  • 輸出格式:toDataURL("image/jpeg", 0.9) 可以指定 MIME 型別與壓縮品質,比預設的 PNG 省下不少流量。
  • 手機 Safari:記得加 playsinline,避免點擊後強制全螢幕播放而中斷腳本流程。

掌握這三步,後續要擴充成「連續擷取多幀」、「加上浮水印」或「直接觸發下載」都很直接。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved