更新记录

1.1(2022-09-06)

优化部分打印相关接口。

1.0(2022-05-27)

首发版本

查看更多

平台兼容性

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


芯烨打印机SDK原生插件使用文档

一、插件对象

//打印机插件对象
var XPrinter = uni.requireNativePlugin('X-Printer');

//蓝牙插件对象
var Bt = uni.requireNativePlugin('XPrinter-Bt');

//票据POS58插件对象
var Pos58 = uni.requireNativePlugin('XPrinter-Pos58');

//票据POS80插件对象
var Pos80 = uni.requireNativePlugin('XPrinter-Pos80');

//76针式插件对象
var Pos76 = uni.requireNativePlugin('XPrinter-Pos76');

//标签插件对象
var Tsc = uni.requireNativePlugin('XPrinter-Tsc');

二、打印机插件接口

蓝牙方式连接打印机

//蓝牙方式连接打印机
var address = "";//蓝牙地址
XPrinter.ConnectBtPort(address, function(res){
    console.log(res);
    if (res.type == "OnSucceed") {
        //连接成功
    } else if (res.type == "OnFailed") {
        //连接失败
    }
});

获取打印机usb设备列表

//获取打印机usb设备列表
var usbDevices = XPrinter.GetUsbPathNames();
console.log(usbDevices);

usb方式连接打印机

//usb方式连接打印机
var usbDevice = "";//usb设备
XPrinter.ConnectUsbPort(usbDevice, function(res){
    console.log(res);
    if (res.type == "OnSucceed") {
        //连接成功
    } else if (res.type == "OnFailed") {
        //连接失败
    }
});

断开当前打印机连接

//断开当前打印机连接
XPrinter.DisconnectCurrentPort(function(res){
    console.log(res);
    if (res.type == "OnSucceed") {
        //成功
    } else if (res.type == "OnFailed") {
        //失败
    }
});

检测app与打印机的连接状态

//检测app与打印机的连接状态
XPrinter.CheckLinkedState(function(res){
    console.log(res);
    if (res.type == "OnSucceed") {
        //成功
    } else if (res.type == "OnFailed") {
        //失败
    }
});

处理好的数据发送给打印机

//处理好的数据发送给打印机
var data = [0x00, 0x01];
XPrinter.Write(data, function(res){
    console.log(res);
    if (res.type == "OnSucceed") {
        //成功
    } else if (res.type == "OnFailed") {
        //失败
    }
});

发送自定义的指令集合

//发送自定义的指令集合
var processData = [
    [0x00, 0x01],
    [0x00, 0x01, 0x02]
];
XPrinter.WriteSendData(function(res){
    console.log(res);
    if (res.type == "OnSucceed") {
        //成功
    } else if (res.type == "OnFailed") {
        //失败
    }
}, processData);

隐私、权限声明

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

蓝牙权限 定位权限

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

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

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