WebApp快捷打包
TSC 打印机
转到模块插件

敬告:此 DEMO 演示为开放测试页面,仅用于开发者快速测试体验应用功能,请严格遵守开发者协议,了解更多

JS-SDK 引用方式:

♦ 普通网页 script 方式加载:下载最新版 jsBridge-v20250217.zip,请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库;

♦ js module 方式引用:npm install ym-jsbridge 具体请参考 npm package

蓝牙状态及权限管理

蓝牙插件

转到

蓝牙 插件说明接口文档

请使用 ble 的 getState、requestEnable、requestPermission 等接口检测设备蓝牙状态并申请权限。

TSC 打印机

connect 连接蓝牙打印机

btMacAddress:

jsBridge.tscPrinter.connect({
  btMacAddress: "{{connect.btMacAddress}}"
}, function(success, res) {
  alert(success ? "连接成功" : "连接失败\n" + JSON.stringify(res));
});

connect 连接 WIFI 打印机

wifiIpAddress:

wifiPort:

jsBridge.tscPrinter.connect({
  //wifi ip 地址
  wifiIpAddress: "{{connectWifi.wifiIpAddress}}",
  //wifi 端口号
  wifiPort: {{connectWifi.wifiPort}}
}, function(success, res) {
  alert(success ? "连接成功" : "连接失败\n" + JSON.stringify(res));
});

write 写入打印指令

//3种指令方式必须且仅需选其一
//指令用法请参考设备提供商的官方文档
//str   指令字符串
//bytes 指令字节流
//bmp   打印图片
jsBridge.tscPrinter.write({
  //如打印 Hello World
  str: 'TEXT 10,10,"0",0,12,12,"Hello World"\nPRINT 1',
  //str 参数的字符集
  strCharset: 'UTF-8',
  //如重启打印机
  bytes: [27, 33, 82],
  //图片
  bmp: {
    //x 坐标
    x: 10,
    //y 坐标
    y: 10,
    //Base64编码的图片
    base64: '...........'
  }
}, function(success, res) {
  alert(success ? "成功" : "失败\n" + JSON.stringify(res));
});

write 写入字符指令

str:

strCharset:

//指令用法请参考设备提供商的官方文档
//注意使用 \r\n 回车换行,指令末尾加空行 \r\n
jsBridge.tscPrinter.write({
  //如打印 Hello World
  str: `{{write.str}}`,
  //str 参数的字符集
  strCharset: '{{write.strCharset}}'
}, function(success, res) {
  alert(success ? "成功" : "失败\n" + JSON.stringify(res));
});

write 写入字节流指令

//指令用法请参考设备提供商的官方文档
jsBridge.tscPrinter.write({
  //如重启打印机,即 <ESC>!R
  bytes: [27, 33, 82]
}, function(success, res) {
  alert(success ? "成功" : "失败\n" + JSON.stringify(res));
});

write 打印图片

jsBridge.tscPrinter.write({
  bmp: {
    //x 坐标
    x: 10,
    //y 坐标
    y: 10,
    //Base64编码的图片
    base64: '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'
  }
}, function(success, res) {
  alert(success ? "成功" : "失败\n" + JSON.stringify(res));
});

read 读取

jsBridge.tscPrinter.read(function(success, res) {
  if (success) {
    alert("数据:\n" + res.data);
  } else {
    alert("出错\n" + JSON.stringify(res));
  }
});

disconnect 断开连接

jsBridge.tscPrinter.disconnect(function(success, res) {
  alert(success);
});