更新记录

1.2（2023-07-03）

增加Android高版本蓝牙权限授权接口。

1.1（2022-09-06）

优化部分打印相关接口。

1.0（2022-05-27）

首发版本

平台兼容性

原生插件通用使用流程：

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);