lpapi-ble-dd 是一款基于钉钉小程序本身提供的BLE接口和canvas所封装的标签编辑及蓝牙打印接口，接口通过canvas来按照用户需要进行2D绘图，绘制完毕后将图片内容转换为打印机所支持的指令，然后通过BLE将数据发送到打印机，然后开始打印图片。

注意：本接口包仅针对德佟系列标签打印机

1. 通过 npm/yarn 直接下载安装；

npm install lpapi-ble-dd
// 或者
yarn add lpapi-ble-dd

2. 打开德佟电子官方网站，点击软件下载, 选择SDK开发包下载，然后点击下载蓝牙打印钉钉小程序SDK（含API文档）;

1. 引入接口实例

1.1 导入接口包

将下载后的接口包解压缩，然后将解压缩后的 lib 目录下的文件复制到路径合适的目录下，eg: "/js_sdk/lpapi-ble-dd/".

1.2 打开 index.axml 文件，创建一个隐藏的画布，用于进行标签的绘制，canvas 的宽高需要在创建打印任务后动态设置。

<canvas id="{{canvasId}}" width="{{labelWidth}}px" height="{{labelHeight}}px" style="position: fixed;left: -999999rpx;top: -999999rpx;" />

1.3 在目标js文件（eg: index.js）中引入接口包，然后创建接口实例。

import { LPAPIFactory } from "/js_sdk/lpapi-ble-dd/index.js";

export default {
    data() {
        return {
            canvasId: "dothan-lpapi-ble",
        };
    },
    onLoad() {
        this.lpapi = LPAPIFactory.getInstance({
            // 如果需要查看打印日志的话，可以在此配置日志显示状态，0表示不显示，4表示显示所有日志信息。
            // showLog: 4,	// 【可选】
            // 设置画布ID，第一步中创建的画布ID，全局唯一
            canvasId: this.canvasId, // 【必须】
        });
        // 搜索蓝牙设备
        this.lpapi.startBleDiscovery({
            // timeout = 0 表示搜索到匹配的打印机后自动停止搜索，不指定表示会一直搜索下去
            timeout: 0,
            deviceFound: (devices) => {
                // 更新打印机列表
            },
        });
    },
};

3. 根据实际需要创建指定大小的打印任务，开始打印或者预览；

function printQrcode(data, callback) {
    // 标签宽度，单位毫米
    const labelWidth = 30;
    // 标签高度，单位毫米；
    const labelHeight = 30;
    // 标签转转方向，值为：0，90，180，270，默认为0，表示不做任何的旋转处理；
    const orientation = 0;
    // 二维码外边可以适当的留一点边距；
    const margin = 2;
    // 二维码大小

    const api = this.lpapi;
    // 创建指定大小的打印任务，单位毫米
    const jobInfo = api.startJob({
        width: labelWidth, // 【必填】标签宽度
        height: labelHeight, // 【必填】标签高度
        orientation: orientation, // 【可选】旋转方向
        jobName: "#!#preview#!#", // 【可选】 "#!#preview#!#" 和 "#!#transparent#!#" 是两个特殊的打印任务名称，主要供生成预览图片或者调试使用，不会打印，其他任何字符串都会直接打印；
    });
    // 更新画布大小，单位像素
    this.labelWidth = jobInfo.canvas.width;
    this.labelHeight = jobInfo.canvas.height;
    // 注意，在uni模式下更新canvas画布大小后，画布大小不会立即生效，需要等待画布尺寸更新之后在进行后续操作才可以；
    // 此处可以使用 nextTick或者直接启用定时器
    this.$nextTick(() => {
        // 绘制二维码
        api.draw2DQRCode({
            text: "测试测试测试测试测试测试",
            x: margin,
            y: margin,
            width: labelWidth - margin * 2,
            height: labelHeight - margin * 2,
        });
        //
        api.commitJob({
            complete: (resp) => {
                // 执行打印完毕回调函数
                if(resp.statusCode === 0) {
                    console.log("打印成功！");
                } else {
                    console.log("打印失败！");
                }
            },
        });
    });
}

interface InitOptions {
	/** 用于标签绘制的 canvas ID */
    canvasId: string;
	/** 是否显示相关日志信息 */
    showLog?: number|boolean;
}

export interface LPAPIFactory {
	/**
	 * 通过配置信息获取接口实例对象。
	 */
    static getInstance(context: InitOptions): LPAPI;
}

设置搜索、连接的打印机的型号限定。

models: 待搜索的打印机型号列表。 多个打印机型号可以通过字符串数组来指定，也可以通过";"将多个型号拼接成一个字符串来指定。 在 startBleDiscovery 或者 openPrinter 之前执行此方法，可以限定指定的打印机型号。

获取搜索到的打印机列表。

• deviceFound: (devices: LPA_BleDevice[]) => void 回调参数

LPA_BleDevice

• adapterStateChange: (res: Object) => void 回调参数

object res

• 回调参数 LPA_Response

• 回调结果状态码

打开指定名称或型号的打印机。

• LPA_Result 状态码：

• complete 回调函数: (result: Object) => void

• success 回调函数：(result: Object) => void 回调参数参考 complete 回调，当打印机链接成功的时候，属性 statusCode 为0；

• fail 回调函数：(result: Object) => void 回调参数参考 complete 回调，当打印机链接失败的时候，属性 statusCode 不为0，具体可参考 LPA_Result。

Promise<LPA_Response<string|Object>> 返回值类型可参考 complete 回调参数。

关闭已连接打印机。

创建指定大小的打印任务。

• jobName参数描述

• orientation参数描述

• 如果返回值为空: 表示任务创建失败；
• 如果返回值非空：表示任务创建成功，成功时返回值内容的具体信息如下：

创建用于打印的打印任务，返回值为 Promise，值为0表示打印任务创建成功，同时打印机也链接成功，在绘制完毕后可直接进行打印。

0 ：表示成功； 其他：表示对应的错误代码，具体可参考 LPA_Result 枚举值详情；

结束绘制，开始打印绘制内容，如果打印任务是预览任务，则返回预览图片。

• 打印浓度：darkness

• 打印速度：speed

• 纸张类型：gapType

• LPA_PagePrintResult 属性

• complete 回调函数：(result: LPA_JobPrintResult) => void 回调参数 statusCode 为 0 表示打印成功，否则表示打印失败，具体参数描述如下：

• success 回调函数：(result: LPA_JobPrintResult) => void 打印成功，具体参数描述参考 complete回调。

• fail 失败回调函数：(result: LPA_JobPrintResult) => void 打印失败，statusCode 表示对应的错误代码，具体可参考 LPA_Result.

Promise<LPA_JobPrintResult>

返回值内容可参考回调函数 complete。

设置后续绘制对象的默认旋转方向。

orientation: number

设置后续绘制对象的水平对齐方向。

alignment: number

设置后续绘制对象的垂直对齐方向。

alignment: number

绘制字符串对象。

• 字体样式：fontStyle

绘制一维码。

• 一维码类型：barcodeType

绘制二维码。

opts: object

• QRCode二维码纠错级别：eccLevel

绘制PDF417二维码。

options: object

绘制 DataMatrix 二维码。

options: object

绘制直线。

绘制矩形。

绘制矩形。

绘制正圆形。

绘制图片资源。

如果指定的图片内容为图片的 url 字符串，则需要等待图片异步加载完毕之后才可以进行绘制，否则在结束打印任务的时候，如果图片还未加载完毕，则无法正常显示图片内容。

绘制图片资源。

• TableCell参数详情：

备注：TableCell可为字符串，如果为字符串，则表示当前单元格内容为字符串。

• MergeGroup 参数详情：

备注：在实际使用中单元格的合并信息也可以通过具体某个单元格的 rowSpan和columnSpan来指定单元格的合并信息，效果等同于通过 group 来指定单元格合并信息。

直接打印图片

• success 回调参数： 参考 commitJob 的回调参数。
• fail 回调参数： 参考 commitJob 的回调参数。
• complete 回调参数： 参考 commitJob 的回调参数。

返回值参考 commitJob 的返回值。

直接打印图片的二进制数据

• printAlignment 参数详情：

• success 回调：() => void; 打印成功回调函数。

• fail回调: (result: LPA_Result) => void; 打印失败回调函数，参数result表示错误代码，具体可参考 LPA_Result。

• complete回调：(result: LPA_Result) => void; 打印完毕回调函数，参数result表示打印结果状态吗，0表示成功，其他表示失败，具体可参考 LPA_Result 详情。

• 返回值：Promise<LPA_Result> 0: 表示成功， 其他：参考LPA_Result详情。

通过JSON方式配置所有打印任务相关信息

• IJobInfo：打印任务参数详情

• IPrinterInfo：打印机参数详情

• DrawItemOptions：页面绘制内容参数详情

• DrawType: 绘制类型参数详情

• onJobCreated回调函数：(result: Object) => Promise 打印任务创建成功时的回调函数。

• onPageComplete回调函数: (result: LPA_PagePrintResult) => void 在进行多页打印的时候，每打印完一张标签，就会触发该回调函数的调用，用户可以在该回调函数中展示打印进度，或者提前进行标签的预览处理。

返回值可参考 commitJob 的返回值。

解析并打印wdfx格式的字符串

• onPageComplete回调函数: (result: LPA_PagePrintResult) => void 参考 print接口的 onPageComplete 回调函数的描述。

返回值可参考 commitJob 的返回值描述。