Lpapi Module

/ Title: lpapiModule Description: 德佟系列标签打印机接口插件 /

来自于：德佟电子官网立即使用

getAllPrinters openPrinter closePrinter isPrinterOpened getPrinterInfo printImage startJob commitJob setItemHorizontalAlignment setItemVerticalAlignment setItemOrientation drawText draw1DBarcode draw2DQRCode drawImage

概述

注意

本模块仅支持德佟系列相关蓝牙打印机，以及大量合作厂家相关的蓝牙打印机，具体可咨询相关机器的售前或者售后相关人员；

德佟电子简介

德佟电子科技（上海）有限公司 是一家集研发、生产、销售和技术服务于一体的专业标签打印机生产厂家。 公司成立于2016年2月，注册资金为1000万人民币，主要生产和销售移动便携式标签打印机及配套耗材。

公司总部位于中国上海，主要负责产品研发和市场销售，同时在江苏常州和江苏张家港设立了生产基地。 公司成立时间虽然不长，但进入市场之后，凭借切合市场需求的产品、过硬的软硬件技术能力、良好的线上线下代理商合作模式，已经成为该市场领域事实上的标杆领头羊，在保持和客户多方共赢的同时，自身销售额每年也在以超过50%的速度高速增长。

公司在拓展市场的同时，也注重自身资质建设，已经取得了ISO9001、ISO14001证书、多个3C证书、两项发明专利、三项实用新型专利、七项外观专利。更多专利等资质也都在申请过程中。

随着智能手机的全面普及，市场对移动便携方式的标签打印需求呈井喷趋势。公司在维护和拓展国内市场的同时，也已经开展海外外贸业务。给更多的客户带来移动便携标签打印的优良使用体验，是本公司的责任和使命。本公司热忱期望和各界同仁携手一道，以过硬技术为服务根基，以客户需求为服务核心，用最专业的服务打造出让客户满意的产品和体验。

模块接口

getAllPrinters

getAllPrinters({params}, callback(ret))

params

name：

  • 类型：字符串
  • 描述：（可选项）打印机型号，不指定表示获取所有型号的打印机。

callback(printers)

printers：device[]

  • 类型：JSON 数组
  • 描述：打印机列表
device: {
    name: string            // 打印机名称；
    macAddress: string      // 打印机MAC地址；
    addressType: number     // 设备连接类型；
}

示例代码

var lpapi = api.require('lpapiModule');
lpapi.getAllPrinters({}, function(printers) {
    console.log(ret.info);
});

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

openPrinter

连接目标打印机

openPrinter({params}, callback(ret))

params

name：

  • 类型：字符串
  • 描述：要连接的目标打印机名称，打印机名称可以通过getAllPrinters来获取；

callback(ret)

ret：

  • 类型：bool
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.openPrinter({
    name: 'DT20-XXXXXXXX'
}, function(ret) {
    if (ret) {
        alert("打印机打开成功");
    } else {
        alert("打印机打开失败");
    }
});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

closePrinter

连接目标打印机

closePrinter(callback(ret))

callback(ret)

ret：

  • 类型：bool
  • 描述：打印机关闭成功与否；

示例代码

var lpapi = api.require('lpapiModule');
lpapi.closePrinter({}, function(ret) {
    if (ret) {
        alert("打印机关闭成功");
    }
});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

isPrinterOpened

连接目标打印机

isPrinterOpened(callback(ret))

callback(ret)

ret：bool

  • 类型：布尔型
  • 描述：打印机是否已经打开；

示例代码

var lpapi = api.require('lpapiModule');
lpapi.isPrinterOpened(function(ret) {
    if (ret) {
        alert("打印机已连接");
    } else {
        alert("打印机未连接");
    }
});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

getPrinterInfo

获取打印机相关信息（打印机连接后有效）

getPrinterInfo(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    deviceName: string; // 打印机名称
    deviceAddress: string;  // 打印机MAC地址
    deviceWidth: number;    // 打印头有效宽度；
    deviceType: number;     // 设备类型；
    deviceDPI: number;      // 打印头分辨率；
    deviceAddreType: number;// 打印机地址类型；
}

示例代码

var lpapi = api.require('lpapiModule');
lpapi.getPrinterInfo(function(ret) {
    console.log(JSON.stringfy(ret.info));
});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

printImage

打印图片url或者base64格式的图片；

printImage({params}, callback(ret))

params

image:

  • 类型：字符串
  • 描述：base64格式图片或者图片url路径；

callback(ret)

ret：bool

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.printImage({
    image: "base64:....."
}, function(ret) {
    if (ret) {
        alert("打印成功");
    } else {
        alert("打印失败");
    }
});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

startJob

打印图片url或者base64格式的图片；

startJob({params}, callback(ret))

params

width: number

  • 类型：浮点数
  • 描述：打印任务（标签纸）宽度；

height: number

  • 类型：浮点数
  • 描述：打印任务（标签纸）高度；

orientation?: 0 | 90 | 180 | 270

  • 类型：整数
  • 描述：打印任务（标签纸）的旋转角度，默认为0；

callback(ret)

ret.success：boolean

  • 类型：JSON 对象
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.startJob({
    width: 40,
    height: 30,
    orientation: 0
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

commitJob

打印图片url或者base64格式的图片；

commitJob({params}, callback(ret))

params

打印属性设置，暂时不做说明；

callback(ret)

ret.success：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.commitJob({}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

setItemHorizontalAlignment

设置打印项的水平对齐方式，0：居左对齐，1：水平居中对齐，2：居右对齐；

setItemHorizontalAlignment({params}, callback(ret))

params

alienment: number

-类型：整型 描述：后续打印选项的水平对齐方式；

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.setItemHorizontalAlignment({
    alienment: 0
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

setItemVerticalAlignment

设置打印项的垂直对齐方式，0：垂直居上，1：垂直居中对齐，2：垂直居下对齐；

setItemVerticalAlignment({params}, callback(ret))

params

alienment: number

-类型：整型 描述：后续打印选项的垂直对齐方式；

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.setItemVerticalAlignment({
    alienment: 0
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

setItemOrientation

设置后续打印项的旋转角度， 0：表示不旋转； 90：表示右转90度； 180：打印选项进行180反转； 270：左转90度；

setItemOrientation({params}, callback(ret))

params

orientation: 0 | 90 | 180 | 270

-类型：整型 描述：后续打印项的旋转角度；

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.setItemOrientation({
    orientation: 90
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

drawText

打印字符串

drawText({params}, callback(ret))

params

text: string

-类型：字符串类型 -描述：打印内容；

x: number

-类型：整型； -描述：打印对象的X轴坐标位置；

y: number

-类型：整型； -描述：打印对象的Y轴坐标位置；

width: number

-类型：整型； -描述：打印对象的宽度；

height: number

-类型：整型； -描述：打印对象显示区域的高度；

fontHeight: number

-类型：浮点型 -描述：文本信息字体高度；

fontStyle: 0 | 1 | 2

-类型：整型； -描述：字体样式，0表示常规字体，1表示粗体，2表示斜体，3表示粗斜体；

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.drwaText({
    text: "德佟电子科技（上海）有限公司",
    x: 0,
    y: 0,
    width: 40,
    height: 10,
    fontHeight: 5
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

draw1DBarcode

打印一维码

draw1DBarcode({params}, callback(ret))

params

text: string

-类型：字符串类型 -描述：一维码数据；

x: number

-类型：整型； -描述：打印对象的X轴坐标位置；

y: number

-类型：整型； -描述：打印对象的Y轴坐标位置；

width: number

-类型：整型； -描述：打印对象的宽度；

height: number

-类型：整型； -描述：打印对象显示区域的高度；

textHeight: number

-类型：浮点型 -描述：一维码中字符串的高度；

type?: number

-类型：整型； -描述：一维码类型；

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.draw1DBarcode({
    text: "123456789",
    x: 0,
    y: 0,
    width: 40,
    height: 30,
    fontHeight: 5
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

draw2DQRCode

打印二维码

draw2DQRCode({params}, callback(ret))

params

text: string

-类型：字符串类型 -描述：二维码数据；

x: number

-类型：整型； -描述：打印对象的X轴坐标位置；

y: number

-类型：整型； -描述：打印对象的Y轴坐标位置；

width: number

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.draw2DQRCode({
    text: "123456789",
    x: 0,
    y: 0,
    width: 30
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本

drawImage

打印图片url或者base64图片；

drawImage({params}, callback(ret))

params

image: string

-类型：字符串类型 -描述：图片资源的url路径或者base64图片；

x: number

-类型：整型； -描述：打印对象的X轴坐标位置；

y: number

-类型：整型； -描述：打印对象的Y轴坐标位置；

width: number

-类型：整型； -描述：打印对象的宽度；

height: number

-类型：整型； -描述：指定打印区域的高度；

threshold: number

-类型：整型； -描述：图片黑白转换的阈值，默认是192；

callback(ret)

ret：boolean

  • 类型：布尔型
  • 描述：成功与否

示例代码

var lpapi = api.require('lpapiModule');
lpapi.drawImage({
    text: "http://www.baidu.com.......",
    x: 0,
    y: 0,
    width: 30,
    height: 30
}, function(ret) {});

补充说明

可用性

Android系统， IOS系统

可提供的1.0.0及更高版本