zq-scancode插件使用说明（v1.0.3）
1、引入包
// 扫码插件
var scanCodeModule = uni.requireNativePlugin("zq-scancode-module")
2、调用方法
2.1、开启扫码
scanCodeModule.startScan({
'name': '扫码',
'showTip': true,
'showLoading': true,
'tip': "自定义扫码",
'tipSize': 20,
'tipColor': "#FF0000",
'transparentBg': true,
'onceScan': false
},
(ret) => {
console.log("扫码内容：" + ret)
});
2.2、关闭扫码
scanCodeModule.stopScan({
'name': '停止扫码'
},
(ret) => {
console.log("返回内容：" + ret)
});
3、说明
3.1、startScan方法的参数：
第一个参数：json对象，根据实际情况传递，第二个参数会回传回来
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| name | String | 扫码 | 组件名称 |
| showTip | Boolean | true | 是否展示提示文字 |
| tip | String | 扫码中... | 提示文字 |
| tipSize | Number | 12 | 提示文字大小 |
| tipColor | String | #3B3B3C | 提示文字颜色 |
| showLoading | Boolean | true | 是否展示 loading |
| transparentBg | Boolean | false | 是否全透明背景 |
| onceScan | Boolean | true | true 扫码一次，false 持续扫码，持续扫码不会关闭监听器 |
第二个参数：扫码结果回调，返回json字符串，回调参数说明：
| 参数名 | 说明 |
|---|---|
| code | 状态码：200成功 |
| msg | 提示信息，比如：扫码成功 |
| data | 扫码结果 |
| extend | 第一个参数回传 |
3.2、stopScan方法说明
当前onceScan=true时，为单次扫码，不需要调用此方法，扫码成功后会自动关闭扫码监听器
当前onceScan=false时，为连续扫码，当不需要扫码时需要调用此方法关闭扫码监听器
4、完整示例代码
<template>
<div>
<button type="primary" @click="scanCode">开始扫码</button>
<button type="primary" @click="stopScanCode">停止扫码</button>
</div>
</template>
<script>
// 获取 module
var scanCodeModule = uni.requireNativePlugin("zq-scancode-module")
export default {
onLoad() {
plus.globalEvent.addEventListener('TestEvent', function(e) {
console.log("TestEvent收到：" + e.msg)
});
},
methods: {
// 扫码
scanCode() {
scanCodeModule.startScan({
'name': '扫码',
'showTip': true,
'showLoading': true,
'tip': "自定义扫码",
'tipSize': 20,
'tipColor': "#FF0000",
'transparentBg': false,
'onceScan': true
},
(ret) => {
console.log("扫码内容：" + ret)
});
}
// 结束扫码
stopScanCode() {
scanCodeModule.stopScan({
'name': '停止扫码'
},
(ret) => {
modal.toast({
message: ret,
duration: 1.5
});
});
}
}
}
</script>
5、<font color="#f00">补充说明</font>
- 扫码枪的原理是外接输入法（类似：外接键盘），通过连接蓝牙或USB线连接设备就可以使用，不需要申请系统权限
6、插件地址
https://ext.dcloud.net.cn/plugin?id=10110
