更新记录

1.0.2（2026-03-19） 下载此版本

uni_modules JS插件

1.0.1（2026-03-18） 下载此版本

TSC标签打印机插件

1.0.0（2026-03-18） 下载此版本

TSC标签打印机插件

查看更多

平台兼容性

uni-app(4.87)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android Android插件版本 iOS 鸿蒙
- - - - - - 14.0 1.0.0 - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

TSC 标签打印机插件（tsc-printer）

封装 TSC 标签打印机官方 SDK，提供 uni-app 与 TSC 系列标签打印机的通信能力。
支持 USB 直连 / 蓝牙 / WiFi 三种连接方式，适用于门票打印、标签打印、条码/二维码打印等场景。

仅支持 Android APP 平台。调试必须使用 自定义调试基座（HBuilderX 菜单：运行 → 制作自定义调试基座）。

前置依赖

本插件为 JS 封装层，底层依赖 nativeplugins/tsc-printer 原生插件（Android AAR）。
使用前需将原生插件目录放入项目 nativeplugins/ 并在 manifest.json 中声明：

"app-plus": {
  "nativePlugins": {
    "tsc-printer": {}
  }
}

安装

从插件市场导入后，插件自动安装到 src/uni_modules/tsc-printer/。

使用

import tscPrinter from '@/uni_modules/tsc-printer/js_sdk/index.js'

// USB 直连打印示例
async function doPrint() {
  try {
    await tscPrinter.connectUSB()
    await tscPrinter.setup({ width: 75, height: 50, speed: 4, density: 12 })
    await tscPrinter.clearBuffer()
    await tscPrinter.printText({ x: 50, y: 50, text: '辽宁铁人足球俱乐部', size: 14 })
    await tscPrinter.printQRCode({ x: 400, y: 50, size: 6, data: 'TICKET-001' })
    await tscPrinter.printLabel(1, 1)
    await tscPrinter.disconnect()
  } catch (e) {
    uni.showToast({ title: e.message, icon: 'none' })
  }
}

API

连接管理

方法 说明 参数
connectUSB() USB 直连（自动检测） 无
getUSBDeviceList() 获取 USB 设备列表 无
connectBluetooth(macAddress) 蓝牙连接 macAddress: string
connectWifi(ip, port?) WiFi 连接，port 默认 9100 ip: string, port?: number
disconnect() 断开连接 无

打印设置

方法 说明 参数
setup(options) 设置纸张 { width, height, speed?, density? }
sendCommand(command) 发送 TSPL 原生命令 command: string
clearBuffer() 清空缓冲区 无

打印内容

方法 说明 参数
printText(options) 打印文本 { x, y, text, font?, size? }
printBarcode(options) 打印条码 { x, y, data, type?, height? }
printQRCode(options) 打印二维码 { x, y, data, size? }
printLabel(copies?, pages?) 执行打印出纸 copies 默认 1，pages 默认 1

门票打印

方法 说明
printTicket(data) 打印门票（内置 75mm×50mm 模板）
printFullTicket({ connection, ticket }) 一键完成：连接→打印→断开
printTickets(connection, tickets[]) 批量打印，返回每张结果数组

printTicket 支持的 data 字段：venueName / eventName / sessionTime / region / row / col / price / buyerName / qrcode

注意事项

  • 仅支持 Android 5.0（API 21）及以上
  • 使用蓝牙功能时，Android 6.0+ 需动态申请位置权限
  • 调试必须制作并使用自定义调试基座，标准基座无法加载原生插件
  • H5/非 APP 环境会自动使用 Mock 实现，不会报错，方便开发调试

隐私、权限声明

1. 本插件需要申请的系统权限列表：

USB权限、蓝牙权限（仅 Android APP）

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。