uniapp——安卓扫码枪插件

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、补充说明

• 扫码枪的原理是外接输入法（类似：外接键盘），通过连接蓝牙或USB线连接设备就可以使用，不需要申请系统权限
  ##6、插件地址

https://ext.dcloud.net.cn/plugin?id=10110