项目说明
- 本项目是uniApp插件工程集合
- UniPlugin-Android Android插件工程，插件源码。包括陀螺仪、扫码枪、标签打印机、身份证识别、售货机等插件
- uniplugin_Demo uniapp demo示例
- 参考资料：https://nativesupport.dcloud.net.cn/NativePlugin/course/android
项目结构
uni-app_plug-in
├─uniplugin_Demo uniApp插件实例工程
│ └─nativeplugins 插件存放路径
│ ├─Huiy-Card 身份证插件
│ ├─Huiy-Office Office文件预览插件
│ ├─Huiy-Printer 打印机插件
│ ├─Huiy-Sale 售货机插件
│ ├─Huiy-Scanner 扫码枪插件
│ └─Huiy-Sensor 陀螺仪插件
│
├─UniPlugin-Android Android插件工程，插件源码
│ ├─app App程序，可运行
│ ├─huiy_card 身份证组件module
│ ├─huiy_office Office文件预览组件module
│ ├─huiy_printer 打印机组件module
│ ├─huiy_sale 售货机组件module
│ ├─huiy_scaner 扫码枪组件module
│ └─huiy_sensor 陀螺仪组件module
│
陀螺仪插件使用说明
- 将uniplugin_Demo\nativeplugins\Huiy-Sensor文件夹copy到 自己工程的 nativeplugins 下面
- 在manifest.json中，选择APP原生插件配置，引入插件
- 在项目中使用如下方法，引入module
var testModule = uni.requireNativePlugin("Huiy-SensorModule")
- 使用registerSensorAFunc方法，注册陀螺仪监听，通过ret回调陀螺仪数据，并实时刷新
testModule.registerSensorAFunc(
(ret) => {
this.degree = ret.degree;
this.x = ret.x;
this.y = ret.y;
this.z = ret.z;
})
返回参数包括 degree,x,y,z
degree 当前方向角度，取值范围0~360, 0-北 90-东 180-南 270-西
x,y,z 陀螺仪传感器返回的 x,y,z三轴的原始数据，取值范围为 -PI~PI
- 使用unRegisterSensorFunc方法，取消陀螺仪监听注册
var ret = testModule.unRegisterSensorFunc(); `
- 使用getSensorInfoFunc方法，获取陀螺仪当前数据，返回结果和registerSensorAFunc相同
var ret = testModule.getSensorInfoFunc();`
- 使用toDegree180Func方法，将陀螺仪原始坐标转换成角度，入参为value，通过ret.degree返回数据 取值范围 -180~180
var ret = testModule.toDegree180Func({
'value': -1
});
modal.toast({
message: "toDegree360："+ret.degree,
duration: 1.5
});
- 使用toDegree360Func方法，将陀螺仪原始坐标转换成角度，入参为value，通过ret.degree返回数据 取值范围 0~360
var ret = testModule.toDegree360Func({
'value': -1
});
modal.toast({
message: "toDegree360："+ret.degree,
duration: 1.5
});
扫码枪插件使用说明
- 本插件适配ZEBRA 斑马品牌扫码枪，只支持USB连接，适配具体型号为ZEBRA DS2208 条码扫描器
- 将uniplugin_Demo\nativeplugins\Huiy-Scanner文件夹copy到 自己工程的 nativeplugins 下面
- 在manifest.json中，选择APP原生插件配置，引入插件
- 在项目中使用如下方法，引入module
var testModule = uni.requireNativePlugin("Huiy-ScannerModule")
- 在项目中使用如下方法，注册一个通知回调，用于接收扫码枪返回的消息
var globalEvent = uni.requireNativePlugin('globalEvent');
globalEvent.addEventListener('scannerEvent', function(e) {
console.log("scannerEvent:" + that);
that.i = e.barcode;
modal.toast({
message: "globalEvent收到：" + e.scannerId + " " + e.type + " " + e.msg + " " + e.barcode + " " + e.barType,
duration: 1.5
});
});
其中 scannerId扫码枪id，type 消息类型，msg 消息内容，barcode 扫码内容，barType二维码类型
- 使用initScannerAFunc方法，初始化组件
testModule.initScannerAFunc(
(ret) => {
modal.toast({
message: "init：" + JSON.stringify(ret),
duration: 1.5
});
});`
- 使用connectScannerAFunc方法，连接扫码枪
testModule.connectScannerAFunc(
(ret) => {
modal.toast({
message: "init：" + JSON.stringify(ret),
duration: 1.5
});
});`
此时使用扫码枪扫描二维码或条形码，扫描结果会通过上面注册的回调返回数据
- 使用disconnectScannerAFunc方法，断开连接
testModule.disconnectScannerAFunc(
(ret) => {
modal.toast({
message: "init：" + JSON.stringify(ret),
duration: 1.5
});
});`
条码打印机插件使用说明
- 本插件适配佳博 Gainscha品牌条码打印机，只支持USB连接，适配具体型号为佳博 GP-1324D 热敏条码打印机
- 将uniplugin_Demo\nativeplugins\Huiy-Printer文件夹copy到 自己工程的 nativeplugins 下面
- 在manifest.json中，选择APP原生插件配置，引入插件
- 在项目中使用如下方法，引入module
var testModule = uni.requireNativePlugin("Huiy-PrinterModule")
- 在项目中使用如下方法，注册一个通知回调，用于接收打印机是否连接成功的消息
globalEvent.addEventListener('myEvent', function(e) {
console.log("globalEvent:" + that);
that.i = e.degree;
modal.toast({
message: "myEvent收到：" + e.type + " " + e.msg,
duration: 1.5
});
});
其中 type 消息类型，msg 消息内容
- 使用getUsbDevListFunc方法，获取设备列表
var ret = testModule.getUsbDevListFunc();
- 使用connectUsbDev方法，连接设备，其中name为设备列表中获取的设备名称
var ret = testModule.connectUsbDevFunc({
'name': this.conDev
});
- 使用printerLabel方法，打印标签
var ret = testModule.printerLabel(json);
其中json为json报文，用于描述打印标签的内容，具体举例如下：
{
"direction": 0,
"gap": 20,
"height": 30,
"mirror": 0,
"width": 40,
"x": 0,
"y": 0,
"printInfoList": [{
"cellWidth": 5,
"font": "TSS24.BF2",
"height": 100,
"readable": 0,
"rotation": 0,
"scaleX": 2,
"scaleY": 2,
"text": "悠悠奶茶",
"type": 1,
"x": 60,
"y": 10
}, {
"cellWidth": 3,
"height": 100,
"level": "L",
"readable": 0,
"rotation": 0,
"scaleX": 0,
"scaleY": 0,
"text": "barcode1234567",
"type": 2,
"x": 200,
"y": 75
}, {
"barType": "128",
"cellWidth": 5,
"height": 50,
"readable": 1,
"rotation": 0,
"scaleX": 0,
"scaleY": 0,
"text": "7654321",
"type": 3,
"x": 30,
"y": 160
}]
}
最上方direction、gap、width、height、mirror、x、y 用于描述标签信息，具体参数说明如下：
public int width = 40; // 标签尺寸（宽）
public int height = 30; // 标签尺寸（高）
public int gap = 20; // 标签之间的间距
public int x; // 打印起始坐标（x）
public int y; // 打印起始坐标（y）
public int direction; // 打印方向类型：正向打印(0),反方向打印，从下往上(1);
public int mirror; // 是否镜像类型：正常(0), 开启镜像(1);
printInfoList中的内容用于描述打印内容，具体参数说明如下：
// 公共参数
public int type; // 打印内容的类型： 打印文字(1),打印二维码(2),打印条形码(3)
public int x; // 打印起始坐标x
public int y; // 打印起始坐标y
public int rotation; // 旋转角度：0 90 150 270
public String text; // 打印文字的内容
// 打印文字相关
public String font; // 字体类型：1-10、简体中文("TSS24.BF2"),繁体中文("TST24.BF2"), 韩语("K");
public int scaleX; // x轴放大系数： 1-10
public int scaleY; // y轴放大系数： 1-10
// 打印二维码相关
public String level; // 纠错级别：L M Q H
public int cellWidth = 5;
// 打印条形码相关
public int readable; //是否打印可识别字符 DISABLE(0),EANBEL(1);
public int height = 100; // 条形码高度
public String barType; // 条形码编码类型： CODE128 ..
- 具体参数说明也可参考：\TscCommand说明_Android.pdf
Office文件预览插件使用说明
- 本插件使用TBS腾讯浏览服务实现office文档预览功能，使用时需要联网，会自动下载安装腾讯浏览器内核。具体参考：https://x5.tencent.com/
- 将uniplugin_Demo\nativeplugins\Huiy-Office文件夹copy到 自己工程的 nativeplugins 下面
- 在manifest.json中，选择APP原生插件配置，引入插件
- 在项目中使用如下方法，使用控件
<officeFrame ref="officeView" officeUrl="/storage/emulated/0/excel001.xlsx" style="width:1260;height:700" @onInit="onInit" @click="officeClick"></officeFrame>
可以通过width、height 属性控制控件大小
- 在项目中使用如下方法，获取腾讯浏览器内核加载情况
onInit(e) {
this.name = "onInit --> "+e.detail.type + " "+ e.detail.msg+ " "+ e.detail.progress+ " "+ e.detail.isSuccess;
},
其中
type 回调类型 1.内核下载中 2. 内核下载完成 3.内核安装完成 4.控件初始化完成（需根据isSuccess判断是否成功），
msg 当前状态描述
progress 下载进度
isSuccess 控件是否加载成功
- 使用loadFile方法，加载Android本地文件
officeClick(e) {
this.name = "loadFile"
this.$refs.officeView.loadFile("/sdcard/ppt001.pptx");
}，
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent