更新记录

1.08.02（2020-09-28）

1、更新官方1.08版本SDK 2、更新使用文档

平台兼容性

原生插件通用使用流程：

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

插件使用说明

    本插件基于汉印官方1.08版本SDK进行封装，包含了官方SDK中主要的API接口，API具体说明可见官方SDK文档

使用方法：

一、注册插件

const PrinterHelper = uni.requireNativePlugin('Hanyin-PrinterHelper')

一、基础接口

1、页面配置

PrinterHelper.PrintAreaSize({
    // 整体偏移量
    offset: 0,
    // 打印机DPI
    Horizontal: '200',
    Vertical: '200',
    // 页面高度
    Height: '',
    Qty: 1
}, result => {
    console.log('页面设置回调：', result)
})

2、打印宽度设置

PrinterHelper.PageWidth({
    // 宽度pageWidth
    pw: ''
}, result => {
    console.log('打印宽度设置回调：', result)
})

3、打印浓度设置

PrinterHelper.Contrast({
    // 取值范围1-5
    contrast: '3'
}, result => {
    console.log('打印浓度设置回调：', result)
})

4、打印标签定位，连续纸不可用

PrinterHelper.Form({}, result => {
    console.log('启动打印回调：', result)
})

5、开始打印

PrinterHelper.Print({}, result => {})

三、内容接口

1、画线

/**
 * 参数说明
 * x0: X轴开始坐标（单位：PX）
 * y0: Y轴开始坐标（单位：PX）
 * x1: X轴结束坐标（单位：PX）
 * y1: Y轴结束坐标（单位：PX）
 * width: 线的粗细度（单位：PX）
 */

PrinterHelper.Line({x0, y0, x1, y1, width}, result => {
    console.log('Line：', result)
})

2、文字

/**
 * 参数说明
 * command: 文字方向
 *   0：水平，
 *   1：逆时针旋转90度
 *   2：逆时针旋转180度
 *   3：逆时针旋转270度
 * font: 字体点阵大小
 * size: 字体大小
 * x: 起始点的横坐标（单位：PX）
 * y: 起始点的纵坐标（单位：PX）
 * data: 文本内容
 */

PrinterHelper.Text({command, font, size, x, y, data}, result => {
    console.log('Text：', result)
})

3、二维码

/**
 * 参数说明
 * command: 打印方向
 *   0：水平，
 *   1：垂直
 * x: 二维码起始横坐标（单位：PX）
 * y: 二维码起始纵坐标（单位：PX）
 * m: QR的类型（1、2，默认用2）
 * u: 二维码宽度参数，范围是1到32默认为6
 * data: 二维码文本信息
 */

PrinterHelper.PrintQR({command: 0, x, y, m, u, data}, result => {
    console.log('二维码：', result)
})