最近由於業務的原因,需要在Web端頁面接入除錯各類的網路攝像頭,遇到了很多匪夷所思的問題(說的就是讀得出攝像頭的品牌,讀不出攝像頭的解析度)。於是整理了這篇文章作為備忘錄,也希望能幫到有類似的小夥伴們。
基礎程式碼
navigator.mediaDevices.getUserMedia({ audio: false, video: true }).then(async (stream) => {
let video = document.getElementById('#video')
// 相容性監測
if( 'srcObject' in video ) {
video.srcObject = stream
} else {
// 在支援srcObject的瀏覽器上,不再支援使用這種方式
video.src = URL.createObjectURL(stream)
}
await video.play()
})
相容性
從caniuse的相容性來看,整體相容性一般,IE系列瀏覽器完全不支援,iOS不僅需要iOS 11以上的版本,而且在APP的嵌入式頁面也無法通過api進行呼叫。
開發遇到的各種問題
-
瀏覽器控制檯提示
mediaDevices.getUserMedia is not a function
由於受瀏覽器的限制,
navigator.mediaDevices.getUserMedia
在https
協議下是可以正常使用的,而在http
協議下只允許localhost
/127.0.0.1
這兩個域名訪問,因此在開發時應做好容災處理,上線時則需要確認生產環境是否處於https
協議下。let mediaDevices = navigator.mediaDevices || null if( mediaDevices === null ) { console.warn(`請確定是否處於https協議環境下`) return } mediaDevices.getUserMedia({ audio: false, video: true }).then(async (stream) => {})
-
獲取攝像頭的硬體引數
我在專案開發中需要用到的硬體引數主要有兩種:品牌,解析度。獲取攝像頭的品牌名稱相對來說比較簡單,可直接通過
mediaDevices.enumerateDevices()
獲取電腦上可使用的外設列表,通過kind
欄位過濾出攝像頭。if (!navigator.mediaDevices || !navigator.mediaDevices.enumerateDevices) { console.log("瀏覽器不支援enumerateDevices屬性") return } navigator.mediaDevices.enumerateDevices().then((devices) => { let devicesList = devices.filter((device) => device.kind === 'videoinput') // devicesList -> [{ kind: 'videoinput', name: 'FaceTime HD Camera (Built-in)', deviceId: xxx }] // 在devicesList獲取到的deviceId可以用於切換攝像頭 // 具體方法:mediaDevices.getUserMedia({ audio: false, video: { deviceId } }) })
解析度則不能直接通過官方的api獲取到,從MDN上查到的理由是為了保護使用者的個人隱私,而解析度就在保護的範疇內。(個人非常好奇解析度為啥是隱私?)
MDN原文(連結):
由於隱私保護的原因,無法訪問使用者的攝像頭和麥克風資訊
但也並不是完全無法獲取到,由於可以通過
video
標籤在網頁上播放攝像頭中所錄取到的內容,而video
標籤會預設將大小設定為與攝像頭相同的大小,因此通過獲取video
的大小來獲取攝像頭的解析度。經過測試,獲取到的值不受樣式的影響,所以可以通過樣式控制
video
的大小,但是不會影響到解析度。let mediaDevices = navigator.mediaDevices || null if( mediaDevices === null ) { console.warn(`請確定是否處於https協議環境下`) return } mediaDevices.getUserMedia({ audio: false, video: true }).then(async (stream) => { let video = document.getElementById('#video') video.srcObject = stream await video.play() // 1280,720 console.log(video.videoWidth, video.videoHeight) })
-
無攝像頭/無使用許可權等錯誤的處理
getUserMedia
本身整合了幾個比較常見的錯誤提示,比如常見的無攝像頭、無使用許可權等,通過catch
能處理大部分類似的錯誤。let mediaDevices = navigator.mediaDevices || null if( mediaDevices === null ) { console.warn(`請確定是否處於https協議環境下`) return } mediaDevices.getUserMedia({ audio: false, video: true }).then(async (stream) => { let video = document.getElementById('#video') video.srcObject = stream await video.play() }).catch((error) => { let message = error.message || error, response = { 'permission denied': '瀏覽器禁止本頁面使用攝像頭,請開啟相關的許可權', 'requested device not found': '未檢測到攝像頭' } alert(response[ message.toLowerCase() ] || '未知錯誤') })
-
攝像頭拔出檢查
手機端由於攝像頭是手機自帶的,所以一般不需要對攝像頭是否拔出進行檢查。但在PC上有拔出攝像頭資料線的情況發生,這種時候就需要對攝像頭的狀態進行監控。
最開始想到的是,
getUserMedia
在攝像頭拔出時可能會通過catch
報錯。然而經過多次的實驗,getUserMedia
在攝像頭拔出時,不會響應找不到攝像頭的錯誤,想通過catch
直接監控這種方法並不可行。在幾乎沒有思路的時候,在
getUserMedia
文件上看到了這麼一句話:getUserMedia
返回一個Promise
, 這個Promise成功後的回撥函式帶一個MediaStream
物件作為其引數。MediaStream
是接收多媒體(包括音訊、視訊)內容流的一個物件,在谷歌瀏覽器(其他瀏覽器未測試)的控制檯上列印之後,其屬性值如下:id是
MediaStream
物件的唯一識別符號,active是當前內容流是否處於活動狀態,下面幾個欄位則是谷歌瀏覽器提供的鉤子。在攝像頭拔出的一瞬間,active會從true變更為false,同時觸發
oninactive
鉤子,有了狀態監聽之後事情就簡單了許多。程式碼經過測試後發現,對使用者變更攝像頭許可權也有效。// 判斷攝像頭是否線上 let cameraIsOnline = false const loadWebCamera = () => { let mediaDevices = navigator.mediaDevices || null if( mediaDevices === null ) { console.warn(`請確定是否處於https協議環境下`) return } mediaDevices.getUserMedia({ audio: false, video: true }).then(async (stream) => { let video = document.getElementById('#video') video.srcObject = stream // 相容性處理 if( stream.oninactive === null ) { // 監聽流中斷,流中斷後將重新進行呼叫自身進行狀態監測 stream.oninactive = () => loadWebCamera() } await video.play() cameraIsOnline = true }).catch((error) => { let message = error.message || error, response = { 'permission denied': '瀏覽器禁止本頁面使用攝像頭,請開啟相關的許可權', 'requested device not found': '未檢測到攝像頭', 'could not start video source': '無法訪問到攝像頭,請重新插拔後重試' } cameraIsOnline = false alert(response[ message.toLowerCase() ] || '未知錯誤') }) }
不過,相容性也非常地捉急,也有很多欄位都是提案階段,開發階段建議做好相容性處理,防止生產環境出現問題。