影音播放頁面常有「把這一刻存成圖片」的需求,例如影片標註、證據留存或社群分享。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>
整個流程只有三個動作:
drawImage() 把 video 目前顯示的那一格畫面「畫」進 canvas。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);
}());
loadedmetadata 或 loadeddata 事件後再開放擷取按鈕。toDataURL() 會丟出 SecurityError。解法是伺服器送出 Access-Control-Allow-Origin,並在 video 上加上 crossorigin="anonymous"。toDataURL("image/jpeg", 0.9) 可以指定 MIME 型別與壓縮品質,比預設的 PNG 省下不少流量。playsinline,避免點擊後強制全螢幕播放而中斷腳本流程。掌握這三步,後續要擴充成「連續擷取多幀」、「加上浮水印」或「直接觸發下載」都很直接。