更新记录

1.0.0（2023-11-20）

1.初始版本

平台兼容性

Android Android CPU类型 iOS
适用版本区间：4.4 - 12.0 armeabi-v7a：未测试，arm64-v8a：未测试，x86：未测试 ×

原生插件通用使用流程：

  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原生插件配置”->”云端插件“列表中删除该插件重新选择

zq-print-serialport——串口插件使用说明（v1.0.0）

1、引入包

// 串口打印插件
var printModule = uni.requireNativePlugin("zq-print-serialport-module")

2、调用方法

printModule.printData({
    "data": "! 8 200 200 640 1\r\nPAGE-WIDTH 560\r\nGAP - SENSE\r\nSETBOLD 2\r\nCENTER\r\nSETMAG 2 2\r\nT 55 3 0 5 测试标题 \r\nSETMAG 0 0\r\nSETBOLD 0\r\nRIGHT\r\nT 8 0 0 50 123456\r\nSETBOLD 2\r\nLEFT\r\nT 8 0 0 80 测试标题：\r\nSETBOLD 0\r\nT 8 0 0 115 内容1\r\nT 8 0 0 150 内容2\r\nT 8 0 0 185 内容3\r\nSETBOLD 2\r\nT 8 0 0 225 内容33322223：\r\nSETBOLD 0\r\nT 8 0 0 260 内容3333333\r\nCENTER\r\nT 8 0 0 290-- -- -- -- -- -- -- -- -- - -- -- -- -- -- -- -- -- -- --\r\nLEFT\r\nT 8 0 0 320 商品名称：\r\nT 8 0 0 360 数量：\r\nT 8 0 0 400 电话：\r\nT 8 0 0 440 生产日期: \r\ nT 8 0 0 480 保质期：\r\nT 8 0 0 520 购买人\r\nT 8 0 0 560\r\nB QR 400 400 M 2 U 4\r\nMA,https://www.baidu.com/\r\nENDQR\r\n",
    "image": {
        "x": 300,
        "y": 500,
        "image":        "iVBORw0KGgoAAAANSUhEUgAAAE0AAAAhCAYAAACcPyaRAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAJASURBVGhD7ZUBcsQgCEVzQ4/lUTxKjpJjWBGIhKC7sc1O2vJnmJ0oIjzRXbLrshzahBzahBzahBzahBzahBzahBzahL4NbY1LXpYlx5UG/oEuQltzLIAA0m4h5e00F3KMQfjFMosCyA3wllNgn4Hteyitsc6HZM6W8CkHHQtMxdsS5BpyL4zW5U6DDWqSkDBsTokdQYgE6jxD2/K2or8stCZtgsGDsLtYAm+HchDldoRKhyv2ux0aaNtK9B1aAUHjqBE0Uh07JlmvuaRjFizE82UvAGeC7cWgDuU1t0LD4Hy6ykLMsdjK0KCjICsLWkf4PpY4b7yTmAvvV/wt5x40Gv8ItF20qb5S+F5xp8FvKWqHRsXBOgMI/6E0G4GmK0ZBukX3oNVOa/4fgIYJ87U4FAfJxETQEERMDI2F8KBeCercKPKPpZh0UEWzb6+jDuN84CLevdDkhvym0fvQEuNO488+NFMclz4tVdgqQB3T6zhfZRrujdCw2H3DQ3Fw0ghGJ4DdNIBG0Mcm16sOVHZgaXWaoZuvJxZsJQuJYQfw9cTiRtfT1ItOwwJlPBblJgM/BxoFh4SoONg0xEjf5JPKNzj+6PU0wAidiv8NndZ8dOI9aP14JwOQBKELXEN6DjQKDgnJTmuU3oRWrq/VUYNOO7+PWnQIvP450MTpC2uJwVs2giYecqtlXrxpT9B8pwlhp60NKBQt/xUlnDo+6Ja/B80FcmgTcmgTcmgTcmgTcmgTcmgTcmgTcmgTcmiXlfMXI3OhPEaZnxgAAAAASUVORK5CYII="
    },
    "filePath": "/dev/ttyS3",
    "baudRate": 115200,
    "autoCut":true
},
    (ret) => {
    modal.toast({
    message: ret,
    duration: 1.5
    });
});

3、说明

3.1、优势：

  • 1、排版灵活

  • 2、图片打印机简单

  • 3、支持小票和标签打印机

3.2、printData方法的参数：

  • 第一个参数：json对象，根据实际情况传递，第二个参数会回传回来
参数名 类型 默认值 说明
data String 打印内容，根据需求根据标准CPCL指令模板，具体格式参考格式说明
image String 打印图片json对象
autoCut Boolean false 是否自动切纸，需要打印机支持
filePath String /dev/ttyS3 串口路径
baudRate String 115200 串口波特率
  • image对象参数说明
参数名 类型 默认值 说明
image String 图片地址 base64字符串，需注意不包含前面的标识( data:image/png;base64,)
x Number 横坐标
y Number 纵坐标
  • 第二个参数：扫码结果回调，返回json字符串，回调参数说明：
参数名 说明
code 状态码：200成功
msg 提示信息，比如：扫码成功
data 打印结果
extend 第一个参数回传

4、完整示例代码

<template>
    <div>
        <button type="primary" @click="printData">打印</button> 
    </div>
</template>

<script>
    var printModule = uni.requireNativePlugin("zq-print-serialport-module")
    export default {
        methods: {
            // 打印
            printData() {
                printModule.printData({
                        "data": "! 8 200 200 640 1\r\nPAGE-WIDTH 560\r\nGAP - SENSE\r\nSETBOLD 2\r\nCENTER\r\nSETMAG 2 2\r\nT 55 3 0 5 测试标题 \r\nSETMAG 0 0\r\nSETBOLD 0\r\nRIGHT\r\nT 8 0 0 50 123456\r\nSETBOLD 2\r\nLEFT\r\nT 8 0 0 80 测试标题：\r\nSETBOLD 0\r\nT 8 0 0 115 内容1\r\nT 8 0 0 150 内容2\r\nT 8 0 0 185 内容3\r\nSETBOLD 2\r\nT 8 0 0 225 内容33322223：\r\nSETBOLD 0\r\nT 8 0 0 260 内容3333333\r\nCENTER\r\nT 8 0 0 290-- -- -- -- -- -- -- -- -- - -- -- -- -- -- -- -- -- -- --\r\nLEFT\r\nT 8 0 0 320 商品名称：\r\nT 8 0 0 360 数量：\r\nT 8 0 0 400 电话：\r\nT 8 0 0 440 生产日期: \r\ nT 8 0 0 480 保质期：\r\nT 8 0 0 520 购买人\r\nT 8 0 0 560\r\nB QR 400 400 M 2 U 4\r\nMA,https://www.baidu.com/\r\nENDQR\r\n",
                        "image": {
                            "x": 300,
                            "y": 500,
                            "image": "iVBORw0KGgoAAAANSUhEUgAAAE0AAAAhCAYAAACcPyaRAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAJASURBVGhD7ZUBcsQgCEVzQ4/lUTxKjpJjWBGIhKC7sc1O2vJnmJ0oIjzRXbLrshzahBzahBzahBzahBzahBzahBzahL4NbY1LXpYlx5UG/oEuQltzLIAA0m4h5e00F3KMQfjFMosCyA3wllNgn4Hteyitsc6HZM6W8CkHHQtMxdsS5BpyL4zW5U6DDWqSkDBsTokdQYgE6jxD2/K2or8stCZtgsGDsLtYAm+HchDldoRKhyv2ux0aaNtK9B1aAUHjqBE0Uh07JlmvuaRjFizE82UvAGeC7cWgDuU1t0LD4Hy6ykLMsdjK0KCjICsLWkf4PpY4b7yTmAvvV/wt5x40Gv8ItF20qb5S+F5xp8FvKWqHRsXBOgMI/6E0G4GmK0ZBukX3oNVOa/4fgIYJ87U4FAfJxETQEERMDI2F8KBeCercKPKPpZh0UEWzb6+jDuN84CLevdDkhvym0fvQEuNO488+NFMclz4tVdgqQB3T6zhfZRrujdCw2H3DQ3Fw0ghGJ4DdNIBG0Mcm16sOVHZgaXWaoZuvJxZsJQuJYQfw9cTiRtfT1ItOwwJlPBblJgM/BxoFh4SoONg0xEjf5JPKNzj+6PU0wAidiv8NndZ8dOI9aP14JwOQBKELXEN6DjQKDgnJTmuU3oRWrq/VUYNOO7+PWnQIvP450MTpC2uJwVs2giYecqtlXrxpT9B8pwlhp60NKBQt/xUlnDo+6Ja/B80FcmgTcmgTcmgTcmgTcmgTcmgTcmgTcmgTcmiXlfMXI3OhPEaZnxgAAAAASUVORK5CYII="
                        },
                        "filePath": "/dev/ttyS3",
                        "baudRate": 115200,
                        "autoCut":true
                    },
                    (ret) => {
                            console.log("打印结果：" + ret)
                    });
            }

        }
    }
</script>

5、参照模板（CPCL）

! 8 200 200 640 1
PAGE-WIDTH 560
GAP-SENSE
SETBOLD 2
CENTER
SETMAG 2 2
T 55 3 0 5 测试标题
SETMAG 0 0
SETBOLD 0
RIGHT
T 8 0 0 50 123456
SETBOLD 2
LEFT
T 8 0 0 80 测试标题：
SETBOLD 0
T 8 0 0 115 内容1
T 8 0 0 150 内容2
T 8 0 0 185 内容3
SETBOLD 2
T 8 0 0 225 内容3333333
SETBOLD 0
T 8 0 0 260 测试11111
CENTER
T 8 0 0 290 ----------------------------------------------
LEFT
T 8 0 0 320 商品名称：
T 8 0 0 360 数量：
T 8 0 0 400 电话：
T 8 0 0 440 生产日期：
T 8 0 0 480 保质期：
T 8 0 0 520 购买人:
T 8 0 0 560
B QR 400 400 M 2 U 4
MA,https://www.baidu.com/
ENDQR

6、补充说明

  • 串口打印，通过连接蓝牙或USB线连接设备就可以使用，不需要申请系统权限

7、联系我

  • qq：1144533851
  • wx：mike_0863

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

评论列表 撰写评论

暂无用户评论。

插件问答 我要提问

使用中有什么不明白的地方，就向插件作者提问吧~ 我要提问

加载更多...