QuaggaJS是条形码扫描器完全用JavaScript编写支持实时的本地化和各种类型的条形码,如
EAN, CODE 128,CODE 39,EAN 8,UPC-A ,UPC-C ,I2of5, 2of5,CODE 93和CODABAR.该类库还能够 getUserMedia直接访问用户的相机流,使得我们的开发变得更加简单。
注意:
getUserMedia在绝大多数浏览器中都需要使用安全站点进行访问也就是https的模式,如果你想使用http协议进行访问,那么你就需要使用本地连接localhost(127.0.0.1)来进行访问测试,所有其他的主机访问协议必须都是https的方式。当然通过个人在开发中的测试发现火狐浏览器,无论是手机端还是电脑端,对这种协议的约束完全降低,完全可以直接访问,所以说个人建议在开发过程中可以尝试火狐,方便调试。
当然其他的浏览器对getUSerMedia对象是支持的,以下是常见浏览器的支持情况
浏览器 |
结果 |
Edge |
true |
Chrome |
true |
Firefox |
true |
IE 11 |
false |
Safari iOS |
false |
以下为项目的地址,我们可以下载项目在此基础上进项部署开发
项目地址: https://github.com/serratus/quaggaJS#browser-support
以下介绍开发过程中常用的API
Quagga.init(config,callback)
该方法初始化给定配置的库config(见下文),并调用callback(err)Quagga完成引导阶段之后。如果配置了实时检测,则初始化过程还要求摄像机访问。如果发生错误,err 则设置参数并包含有关原因的信息。可能的原因可能inputStream.type是设置LiveStream,但浏览器不支持此API,或者简单地说,如果用户拒绝使用相机的权限。
如果没有指定目标,QuaggaJS会查找与CSS选择器匹配的元素#interactive.viewport(为了向后兼容)。 target可以是一个字符串(与CSS元素匹配的DOM节点)或DOM节点。
例子: |
Quagga.init({
|
Quagga.start()
当库被初始化时,该start()方法启动视频流并开始定位和解码图像。
Quagga.stop()
如果解码器当前正在运行,则在调用stop()解码器之后不再处理任何图像。另外,如果在初始化时请求相机流,则此操作也会断开相机的连接。
Quagga.onProcessed(callback)
该方法注册callback(data)处理完成后为每个帧调用的函数。该data对象包含有关操作成功/失败的详细信息。取决于检测和/或解码是否成功,输出会有所不同
Quagga.onDetected(callback)
注册一个callback(data)功能,每当条形码图案被定位和解码成功时触发。传递的data对象包含关于解码处理的信息,包括可以通过调用获得的检测到的代码data.codeResult.code。
Quagga.offProcessed(handler)
如果onDetected事件不再是相关的,请从事件队列中offProcessed删除给定handler的事件
Quagga.offDetected(handler)
如果onDetected事件不再相关,请从事件队列中offDetected删除给定handler的事件。
结果对象:
回调通入onProcessed,onDetected并decodeSingle