更新记录

0.1.0（2022-06-01）

1、初版提交； 2、更新了多个接口：打印文字、打印图片等；

0.0.0（2022-03-31）

1、初版提交

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

目前仅支持安卓平台使用该插件

插件说明

本插件提供安卓手机通过USB接口连接热敏小票打印机进行打印的相关功能。通过USB连接相比使用蓝牙连接更稳定。

Android USB热敏小票打印机测试Demo 下载链接 密码:7bib

安装包下载至手机安装，使用OTG转接头与USB数据线连接手机充电口和热敏小票打印机后开始测试，需要在确保USB已连接后先点击初始化连接打印机，之后即可进行测试打印。插件内提供的接口都在测试Demo中有所展示。插件觉得好用的话不妨点个赞赏买个插件请作者喝杯奶茶吧~~

如果需要其他连接方式的打印接口，可参考下列连接：
Android 蓝牙热敏小票打印机功能插件bluetoothManager
Android 热敏小票打印机功能综合插件syntheticalPrinter(支持蓝牙与USB)

初始化

const usbPrinterModule = uni.requireNativePlugin("singplugin-usbPrinter");

返回码说明

{
    "code": "ok",//或error，表示执行结果成功或失败
    "result": "打印机已连接",//执行结果返回内容
}

初始化打印插件模块（调用其他接口前需要先初始化插件）

usbPrinterModule.initUSBPrinter(e => {//初始化打印模块，初始化之后才能开始使用其他接口
    uni.showToast({
        title: JSON.stringify(e),
        icon: 'none'
    })
})

连接USB设备

usbPrinterModule.connectUSBPrinter(e => {
    uni.showToast({
        title: JSON.stringify(e),
        icon: 'none'
    })
})

断开USB连接

usbPrinterModule.disconnectUSBPrinter(e => {
    uni.showToast({
        title: JSON.stringify(e),
        icon: 'none'
    })
})

打印文字

usbPrinterModule.printText({//打印字符串
    text: _self.textPrint,//需要打印的字符串
    encoding: _self.encodingList[_self.encodingIndex],//打印字符串使用的编码格式，不填默认GBK
    printCount: 1,//打印次数，不填默认1
}, e => {
    uni.showToast({
        title: e,
        icon: 'none'
    })
});

可选打印字符串使用的编码格式

encodingList: ["GBK", "UTF-8", "BIG5", "GB2312", "Shift-JIS", "EUC-KR"], //可选编码格式

打印图片

usbPrinterModule.printImage({
    imagePath: _self.selectedImagePath,//传入图片在手机内的绝对本地路径，注意必须是绝对本地路径
    printCount: 1,//打印次数，默认为1
}, e => {
    uni.showToast({
        title: e,
        icon: 'none'
    })
});

如何获取图片的本地路径

handleSelectImage: function() {
    uni.chooseImage({
        count: 1, //  上传图片数量的控制为1
        sizeType: ["original"],//原图
        sourceType: ["album"],
        success(res) {
            let tempFilePath = res.tempFilePaths[0];
            _self.selectedImagePath = plus.io.convertLocalFileSystemURL(tempFilePath);//需要获取图片的绝对本地路径
        }
    })
}

打印条形码（该功能与部分打印机机型不兼容，请谨慎使用）

usbPrinterModule.printBarcode({
    barcodeContent: _self.textBarcode,//条形码内容，数字组成的字符串
    barcodeWidth: _self.barcodeWidthIndex, //条码宽度（1-5）：默认单位1
    barcodeHeight: _self.barcodeHeightIndex,//条码高度（1-8）：默认单位1
    barcodeFontPosition: _self.barcodeTextPositionIndex, //字体打印位置（0-3），默认不打印文字
    printCount: 1,//打印次数，默认1
}, e => {
    uni.showToast({
        title: e,
        icon: 'none'
    })
});

字体打印位置对应序号

0 => 不打印条码文本，
1 => 条码上方打印,
2 => 条码下方打印,
3 => 条码上、下方打印

打印二维码（该功能与部分打印机机型不兼容，请谨慎使用）

usbPrinterModule.printQrcode({
    qrcodeContent: _self.textQrcode,//二维码内容字符串
    qrcodeSize: _self.qrcodeSize, //二维码大小（1-15），默认1（某些机型上不能正确调整大小）
    errorCorrectionLevel: _self.qrcodeErrorCorrectionLevel, //二维码纠错等级（0-3），默认1
    printCount: 1, // 打印次数：默认1
}, e => {
    uni.showToast({
        title: e,
        icon: 'none'
    })
});

可绑定监听事件

const globalEvent = uni.requireNativePlugin('globalEvent');
bindPluginEvent() { //绑定插件内部事件监听
    globalEvent.addEventListener('OnUSBDisconnected', function(e) { //监听USB连接断开事件
        uni.showToast({
            title: "globalEvent" + JSON.stringify(e),
            icon: 'none'
        })
    });
}