更新记录
1.08.02(2020-09-28) 下载此版本
1、更新官方1.08版本SDK 2、更新使用文档
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
√ | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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)
})