行動裝置與桌面電腦的客戶端 API 起初往往不同步:某項功能通常先在手機上出現,過一陣子才會進到桌面瀏覽器。其中一項關鍵技術就是 getUserMedia API,它讓網頁應用得以存取使用者的攝影機或內建相機。本文示範如何透過瀏覽器取得攝影機畫面,並把當前畫面擷取成圖片。
<!--
理想情況下我們應該先用 JavaScript 判斷裝置上是否真的有攝影機或相機,
但為了簡化,這裡直接寫出 HTML 標記,而不是動態生成。
-->
<video id="video" width="640" height="480" autoplay></video>
<button id="snap">拍張照</button>
<canvas id="canvas" width="640" height="480"></canvas>
這裡的長寬都採用 640 × 480。實務上建議加上 playsinline 屬性,避免 iOS Safari 自動把影片切到全螢幕播放;並在 video 上加上 muted,因為我們只取畫面,不需要聲音,加 muted 也能避免自動播放被瀏覽器阻擋。
因為 HTML 是手寫的,這裡的 JS 會比想像中簡單很多:
// 頁面就緒後掛上事件監聽
window.addEventListener("DOMContentLoaded", function() {
// 取得元素、建立設定
var canvas = document.getElementById("canvas"),
context = canvas.getContext("2d"),
video = document.getElementById("video"),
videoObj = { "video": true },
errBack = function(error) {
console.log("Video capture error: ", error.code);
};
// 依瀏覽器使用對應的 getUserMedia 變體
if (navigator.getUserMedia) { // 標準寫法
navigator.getUserMedia(videoObj, function(stream) {
video.src = stream;
video.play();
}, errBack);
} else if (navigator.webkitGetUserMedia) { // WebKit 前綴
navigator.webkitGetUserMedia(videoObj, function(stream) {
video.src = window.webkitURL.createObjectURL(stream);
video.play();
}, errBack);
} else if (navigator.mozGetUserMedia) { // Firefox 前綴
navigator.mozGetUserMedia(videoObj, function(stream) {
video.src = window.URL.createObjectURL(stream);
video.play();
}, errBack);
}
}, false);
一旦確認瀏覽器支援 getUserMedia,剩下的就很好懂了:把那個 video 元素的 src 指向使用者攝影機的串流,畫面就出來了。用瀏覽器存取攝影機,核心就是這麼點事。
拍照只比播放稍微複雜一點。我們在按鈕上掛一個監聽器,把 video 的當前畫面用 drawImage 描到畫布上:
// 觸發拍照動作
document.getElementById("snap")
.addEventListener("click", function() {
context.drawImage(video, 0, 0, 640, 480);
});
畫上去之後,這個 canvas 就是一張靜態圖了。你當然還可以在上面疊加濾鏡效果、加字、蓋浮水印,再用 canvas.toDataURL() 或 toBlob() 輸出存檔。
這個範例反映的是較早期的寫法,有幾處務必注意:
API 已統一。各家前綴版本早已被標準的 navigator.mediaDevices.getUserMedia() 取代,現在只需寫一種形式,並用 Promise 處理:
navigator.mediaDevices.getUserMedia({ video: true })
.then(function(stream){
video.srcObject = stream; // 現在應指派給 srcObject,而非 src
video.play();
})
.catch(function(err){
console.error("無法取得攝影機:", err);
});
必須在安全環境下執行。瀏覽器只允許在 HTTPS 或 localhost 中呼叫攝影機,HTTP 頁面會直接被拒。
錯誤要分辨清楚。NotAllowedError 是使用者拒絕授權,NotFoundError 是找不到裝置,NotReadableError 代表裝置被其他程式佔用。這三種該給的提示完全不同,全部丟同一個訊息會讓使用者無所適從。
記得關掉串流。頁面離開或功能結束時要呼叫 stream.getTracks().forEach(t => t.stop()) 釋放攝影機,否則指示燈會一直亮著,隱私上也說不過去。
以前我們得靠 Flash 或第三方插件才能從瀏覽器存取攝影機,步驟繁瑣又不安全。現在只要 HTML5 加上幾行 JavaScript,就能完成存取、預覽、拍照、加工、輸出的整套流程——這大概是「原生網頁能力」這幾年最直觀的一次躍進。