bluePrinter

概述

本插件封装了蓝牙打印机功能,可进行字符打印和本地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) {
   api.alert({msg: 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) {
   api.alert({msg: 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) {
   api.alert({msg: 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) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

iOS系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/07/31