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