本文使用WebRTC的功能,打开电脑上的摄像头,并且把摄像头预览到的图像显示出来。

纯网页实现,能支持除IE外的多数浏览器。手机浏览器也可用。

引入依赖

我们需要引入​​adapter-latest.js​

<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>

这个​​WebRTC adapter​​曾是WebRTC中的一部分,但现在被移出来了。

我们会用到它提供的功能。

html

我们在界面上先摆放一些控件。

<div id="container">
<video id="video-local" autoplay playsinline></video>
<button id="showVideo">打开摄像头</button>
<button id="stopVideo">关闭摄像头</button>
<p>显示摄像头预览的内容,网页上由元素video来呈现。</p>
<p>点击打开摄像头按钮后,浏览器会询问是否允许,请点击“允许”。</p>
<div id="errorMsg"></div>
<div id="tipMsg"></div>
</div>

  • video 用来显示预览的视频
  • 两个button用来控制开启和关闭
  • 再放几个显示信息的地方

js

先设置一下,我们只使用视频

const constraints = window.constraints = {
audio: false,
video: true
};

在网页上显示一些信息,便于调试。

function showErrMsg(msg, error) {
const errorElement = document.querySelector('#errorMsg');
errorElement.innerHTML += `<p>${msg}</p>`;
if (typeof error !== 'undefined') {
console.error(error);
}
}

function showMsg(msg) {
const msgEle = document.querySelector('#tipMsg');
msgEle.innerHTML += `<p>-> ${msg}</p>`;
console.log(msg);
}

完整代码在main.js中。css可自行定义。

打开摄像头

要打开摄像头,使用​​MediaDevices.getUserMedia()​​方法

async function openCamera(e) {
try {
showMsg('正在打开摄像头');
const stream = await navigator.mediaDevices.getUserMedia(constraints);
showMsg('获取到了stream');
gotStream(stream);
e.target.disabled = true;
} catch (err) {
onErr(err);
}

​MediaDevices.getUserMedia()​​方法在用户允许后,按照请求,拿到stream。

stream可以包含视频或音频。前面的设定里,我们只使用视频。

如果用户拒绝了使用摄像头申请,或者申请的媒体不可用,即表现为被拒绝。

用户拒绝会报NotAllowedError,找不到符合要求的设备会报NotFoundError DOMException

方法的文档​​MediaDevices.getUserMedia()​

显示视频

获取到stream后,让video显示视频

function gotStream(stream) {
const videoEle = document.querySelector('video');
const videoTracks = stream.getVideoTracks();
showMsg(`正在使用的设备: ${videoTracks[0].label}`);
window.stream = stream;
videoEle.srcObject = stream;
}

​document.querySelector('video')​​直接获取html上的video控件。

把stream直接交给​​videoEle.srcObject​​。

停止视频流

要停止视频,我们可以从video元素入手,拿到stream,然后把里面的track停掉。

function stopVideo(e) {
showMsg("停止视频");
const videoElem = document.querySelector('video');
const stream = videoElem.srcObject;

document.querySelector('#showVideo').disabled = false; // 允许开启

if(stream == null) {
return;
}
const tracks = stream.getTracks();

tracks.forEach(function(track) {
track.stop();
});
videoElem.srcObject = null;
}

​stream.getTracks()​​方法拿到所有的轨道(track),遍历一遍全部关掉。

最后,把​​videoElem.srcObject​​设置为null,它与前面的​​stream​​解除关联,方便将它释放。

参考 ​​MediaStreamTrack-stop​

小结

示例使用的WebRTC的功能。显示的是本地摄像头的视频,不涉及传输。拿到视频流后交给​​video​​来显示。

​getUserMedia​​是示例中最关键的方法。以后的示例都会用到它。

参考

效果预览

简易效果请参考 ​​open-camera | rustfisher​


一个软件工程师的记录