概述

本模块封装了蓝牙打印机功能，可进行字符打印和本地html打印

注意：本模块 iOS 平台上最低适配系统版本为 iOS 8.0

注意：此版本为beta版本

注意：掉用printString接口之前需调用添加打印信息接口添加打印信息

模块接口

scan

扫描小票打印机蓝牙

scan(callback(ret))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    peripheral:{  //json类型；打印机信息
        name:     '',  //字符串；蓝牙设备名称
        id:       '',  // 字符串；蓝牙设备id
        state:    0   //数字，蓝牙设备状态，0：没有连接，1：正在连接，2：已经连接，3：正在断开连接
    }                
}

err：

• 类型：JSON 对象
• 内部字段：

{
  msg:'',                        //字符串类型；错误信息
}

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.scan(function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本

connect

连接小票打印机

connect({params}, callback(ret))

params

id：

• 类型：字符类型
• 描述：scan接口返回的id

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；连接状态，会多次返回，返回false时请查看err失败原因
}

err：

• 类型：JSON 对象
• 内部字段：

{
  msg:'',                        //字符串类型；错误信息
}

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.connect({
  id:''
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本

appendTitle

添加单行标题

appendTitle({params})

params

string：

• 类型：字符
• 描述：标题内容

alignment：

• 类型：数字
• 描述：文字对齐方式
• 默认值：1
• 取值范围： 0：左对齐 1：居中 2：右对齐

font：

• 类型：数字
• 描述：字号
• 默认值：0
• 取值范围： 0：小 1：中 2：大

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendTitle({
  string:''
})

可用性

iOS系统

可提供的1.0.0及更高版本

appendText

添加单行信息(左标题，右实际值)

appendText({params})

params

title：

• 类型：字符
• 描述：标题

value：

• 类型：字符
• 描述：实际值

offset：

• 类型：数字
• 描述：实际值偏移量
• 默认值：5

font：

• 类型：数字
• 描述：字号
• 默认值：0
• 取值范围： 0：小 1：中 2：大

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendText({
  title:'',
  value:''
})

可用性

iOS系统

可提供的1.0.0及更高版本

appendTextThree

添加单行信息(三列，例如：名称、数量、单价)

appendTextThree({params})

params

left：

• 类型：字符
• 描述：左标题

middle：

• 类型：字符
• 描述：中间标题

right：

• 类型：字符
• 描述：右标题

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendTextThree({
  left:'',  
  middle:'',
  right:''
})

可用性

iOS系统

可提供的1.0.0及更高版本

appendBarCode

添加条形码

appendBarCode({params})

params

string：

• 类型：字符
• 描述：条形码信息

alignment：

• 类型：数字
• 描述：文字对齐方式
• 默认值：1
• 取值范围： 0：左对齐 1：居中 2：右对齐

maxWidth：

• 类型：数字
• 描述：最大宽度
• 默认：200

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendBarCode({
  string:'',  
})

可用性

iOS系统

可提供的1.0.0及更高版本

appendQRCode

添加二维码

appendQRCode({params})

params

string：

• 类型：字符
• 描述：二维码信息

alignment：

• 类型：数字
• 描述：文字对齐方式
• 默认值：1
• 取值范围： 0：左对齐 1：居中 2：右对齐

size：

• 类型：数字
• 描述：二维码大小，取值范围 1 <= size <= 16
• 默认：10

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendBarCode({
  string:'',  
})

可用性

iOS系统

可提供的1.0.0及更高版本

appendFooter

添加底部信息

appendFooter({params})

params

string：

• 类型：字符
• 描述：底部信息

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendFooter({
  string:'',  
})

可用性

iOS系统

可提供的1.0.0及更高版本

appendSeperatorLine

添加一条分割线

appendSeperatorLine()

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendSeperatorLine()

可用性

iOS系统

可提供的1.0.0及更高版本

appendCleare

清除所有添加打印信息

appendCleare()

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.appendCleare()

可用性

iOS系统

可提供的1.0.0及更高版本

printString

以字符串形式打印小票

printString(callback(ret, err))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；是否连接成功              
}

err：

• 类型：JSON 对象
• 内部字段：

{
  msg:'',                        //字符串类型；错误信息
}

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.printString(function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本

printHtml

以html本地文件形式打印小票1.0.3版本（含）遗弃该接口

printHtml({params}, callback(ret, err))

params

path：

• 类型：字符串
• 描述：html本地地址（支持fs、widget）。

alignment：

• 类型：数字
• 描述：对齐方式
• 默认值：0
• 取值范围： 0（居中） 1（左对齐） 2（右对齐）

maxWidth：

• 类型：数字
• 描述：最大宽度
• 默认值：450

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；是否成功              
}

err：

• 类型：JSON 对象
• 内部字段：

{
  msg:'',                        //字符串类型；错误信息
}

示例代码

var bluePrinter = api.require('bluePrinter');
bluePrinter.printHtml({
   path:''
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统

可提供的1.0.0及更高版本