bluePrinter
来自于:AC模块工作室立即使用
scan connect appendTitle appendText appendTextThree appendBarCode appendQRCode appendFooter appendSeperatorLine appendCleare printString printHtml
概述
本模块封装了蓝牙打印机功能,可进行字符打印和本地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本地文件形式打印小票
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及更高版本