只需要 video、canvas 和一個按鈕,就能在瀏覽器裡完成拍照。HTML5 把這件事變得意外簡單,本文把整個流程拆開來說明。
實務上,這段 DOM 最好在使用者授權使用攝影機之后才動態建立,而不是一進頁面就寫死在標記裡。這裡為了示範,直接寫在 HTML 中。範例採用 640×480 的解析度,若改用 JavaScript 動態產生,解析度就能完全交由程式控制。
<!--
理想情況:確認瀏覽器支援 video/camera 之後,才用 JavaScript 動態建立這些元素
寬高:640 × 480,也可以動態決定
-->
<video id="video" width="640" height="480" autoplay></video>
<button id="snap">拍照</button>
<canvas id="canvas" width="640" height="480"></canvas>
HTML 準備好之後,腳本部分單純得超乎想像:向瀏覽器索取串流、把串流餵給 video 播放,然後在按下按鈕的那一刻,把 video 畫面「蓋」到 canvas 上。
window.addEventListener("DOMContentLoaded", function() {
var canvas = document.getElementById("canvas"),
context = canvas.getContext("2d"),
// video 負責接收並播放攝影機的串流
video = document.getElementById("video"),
videoObj = { "video": true },
// 錯誤回呼,把訊息打到主控台
errBack = function(error) {
if ("object" === typeof window.console) {
console.log("Video capture error: ", error.code);
}
};
// 標準寫法
if (navigator.getUserMedia) {
navigator.getUserMedia(videoObj, function(stream) {
video.src = stream;
video.play();
}, errBack);
}
// WebKit 前綴寫法
else if (navigator.webkitGetUserMedia) {
navigator.webkitGetUserMedia(videoObj, function(stream) {
video.src = window.webkitURL.createObjectURL(stream);
video.play();
}, errBack);
}
// 按下拍照鈕,把目前畫面畫到 canvas
document.getElementById("snap").addEventListener("click", function() {
context.drawImage(video, 0, 0, 640, 480);
});
}, false);
<!DOCTYPE html>
<html>
<head>
<title>瀏覽器 webcamera</title>
<meta name="Generator" content="EditPlus" />
<meta name="Author" content="renfufei@QQ.com" />
<meta name="Description" content="改寫自 https://davidwalsh.name/browser-camera" />
<script>
window.addEventListener("DOMContentLoaded", function() {
var canvas = document.getElementById("canvas"),
context = canvas.getContext("2d"),
video = document.getElementById("video"),
videoObj = { "video": true },
errBack = function(error) {
if ("object" === typeof window.console) {
console.log("Video capture error: ", error.code);
}
};
if (navigator.getUserMedia) {
navigator.getUserMedia(videoObj, function(stream) {
video.src = stream;
video.play();
}, errBack);
} else if (navigator.webkitGetUserMedia) {
navigator.webkitGetUserMedia(videoObj, function(stream) {
video.src = window.webkitURL.createObjectURL(stream);
video.play();
}, errBack);
}
document.getElementById("snap").addEventListener("click", function() {
context.drawImage(video, 0, 0, 640, 480);
});
}, false);
</script>
</head>
<body>
<div>
<video id="video" width="640" height="480" autoplay></video>
<button id="snap">拍照</button>
<canvas id="canvas" width="640" height="480"></canvas>
</div>
</body>
</html>
第一,頁面一定要掛在 Web 伺服器下,透過 http(或 https)存取,直接用 file:// 開啟是拿不到串流的。第二,瀏覽器必須夠新且支援相關特性。
這份範例寫於 getUserMedia 的年代,之後標準已經演進為 navigator.mediaDevices.getUserMedia() 搭配 Promise,且明文 http 頁面會被瀏覽器直接拒絕,必須走 https 或 localhost。概念完全相同——取得串流、餵給 video、按下按鈕時 drawImage 到 canvas——但實際上線時請採用新版的 API 寫法。