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 对象
  • 内部字段:
  1. {
  2. peripheral:{ //json类型;打印机信息
  3. name: '', //字符串;蓝牙设备名称
  4. id: '', // 字符串;蓝牙设备id
  5. state: 0 //数字,蓝牙设备状态,0:没有连接,1:正在连接,2:已经连接,3:正在断开连接
  6. }
  7. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //字符串类型;错误信息
  3. }

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

connect

连接小票打印机

connect({params}, callback(ret))

params

id:

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

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //布尔类型;连接状态,会多次返回,返回false时请查看err失败原因
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //字符串类型;错误信息
  3. }

示例代码

  1. var bluePrinter = api.require('bluePrinter');
  2. bluePrinter.connect({
  3. id:''
  4. }, function(ret, err) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

appendTitle

添加单行标题

appendTitle({params})

params

string:

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

alignment:

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

font:

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

示例代码

  1. var bluePrinter = api.require('bluePrinter');
  2. bluePrinter.appendTitle({
  3. string:''
  4. })

可用性

iOS系统

可提供的1.0.0及更高版本

appendText

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

appendText({params})

params

title:

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

value:

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

offset:

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

font:

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

示例代码

  1. var bluePrinter = api.require('bluePrinter');
  2. bluePrinter.appendText({
  3. title:'',
  4. value:''
  5. })

可用性

iOS系统

可提供的1.0.0及更高版本

appendTextThree

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

appendTextThree({params})

params

left:

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

middle:

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

right:

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

示例代码

  1. var bluePrinter = api.require('bluePrinter');
  2. bluePrinter.appendTextThree({
  3. left:'',
  4. middle:'',
  5. right:''
  6. })

可用性

iOS系统

可提供的1.0.0及更高版本

appendBarCode

添加条形码

appendBarCode({params})

params

string:

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

alignment:

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

maxWidth:

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

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

appendQRCode

添加二维码

appendQRCode({params})

params

string:

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

alignment:

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

size:

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

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

appendFooter

添加底部信息

appendFooter({params})

params

string:

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

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

appendSeperatorLine

添加一条分割线

appendSeperatorLine()

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

appendCleare

清除所有添加打印信息

appendCleare()

示例代码

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

可用性

iOS系统

可提供的1.0.0及更高版本

printString

以字符串形式打印小票

printString(callback(ret, err))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //布尔类型;是否连接成功
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //字符串类型;错误信息
  3. }

示例代码

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

可用性

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 对象
  • 内部字段:
  1. {
  2. status:true, //布尔类型;是否成功
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //字符串类型;错误信息
  3. }

示例代码

  1. var bluePrinter = api.require('bluePrinter');
  2. bluePrinter.printHtml({
  3. path:''
  4. }, function(ret, err) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本