商米打印机uniapp插件

概述

SunmiPrinterUTS封装商米打印模块支持商米旗下的所有商用硬件的打印服务，设备应用于包括外卖接单，打印小票，扫描，收款，团购核销，点餐预约等一系列商业场景。 详解如何连接并使用 “商米机型设备” 进行收据小票、收银票据(支持多种纸张类型)、标签打印、开钱箱、获取商品条码(收银机usb外接扫码枪)、切刀控制功能(看设备是否支持)、台式机主副屏通信等常见功能，支持连接商米自助终端（K1、H1等）、商米一体机（V1、V2、T1、T2等）、58热敏票据打印机（小黑盒）、云打印机等常见类型，全过程详细的讲解。

下载插件

功能说明

1. 商米打印服务介绍
   商米打印服务是系统预置的功能，用于管理商米打印机设置和外接打印机的添加。开发者可以通过本服务配置内置打印机，以及添加外接打印机无需额外适配。该插件完整实现了Android原生库PrinterSDK（com.sunmi:printerx）的所有功能，方便开发者直接通过Uniapp和UniappX平台调用打印服务，实现跨平台需求。
   官网打印服务介绍

2. 商米新printx打印说明

   为了更方便开发者调用商米品牌的打印机，也为了简化开发者打印相关开发难度，商米官方于2024年3月底对商米打印SDK做了重构，通过本次升级，扩展了SDK功能，提高了SDK使用的上手速度，统一并简化了所有设备打印业务的SDK封装

3. 新旧功能对比示

   对比项	旧版SDK	新版SDK
   支持打印类型	仅支持热敏小票打印机按行打印	支持热敏小票、热敏标签、文件打印等多种方式
   适配范围	仅针对商米内置打印机	支持所有商米设备，且可扩展连接云打印机
   指令支持	仅支持ESC标准指令	支持ESC、TSPL以及将来扩展更多指令
   友好度	构建复杂样式内容困难	构建复杂样式简单易上手

4. 注意事项

   从应用市场下载插件导入自己项目后，要先制作自定义插件后，才可以运行使用(示例程序已经打好基座，可以直接运行)

   SunmiPrinterUTS插件需在 Android 5.0 版本及以上方可正常使用​

   尽量使用 HBuilderX 4.0+ 以上版本，以便更好在uni-app和uni-app x中使用uts插件

   使用前要先调用initPrinter()方法初始化打印机，才可以正常打印，打印结束要及时调用closePrinter关闭打印服务

完整代码示例

<template>
	<view style="display: flex;">
		<view style="padding: 10px;">
			<button @click="initPrinter()" style="margin-top: 10px;">初始化打印服务</button>
			<button @click="getPrinterInfo()" style="margin-top: 10px;">获取打印机信息</button>
			<button @click="cashOpen()" style="margin-top: 10px;">打开钱箱</button>
			<button @click="closePrinter()" style="margin-top: 10px;">关闭打印服务</button>
		</view>
		<view style="padding: 10px;">
			<button @click="printText()" style="margin-top: 10px;">打印文本内容</button>
			<button @click="printTexts()" style="margin-top: 10px;">按列排列打印内容</button>
			<button @click="printBarCode()" style="margin-top: 10px;">打印条形码</button>
			<button @click="printQrCode()" style="margin-top: 10px;">打印二维码</button>
			<button @click="printDividingLine()" style="margin-top: 10px;">打印分割线</button>
			<button @click="printBitmap()" style="margin-top: 10px;">打印图片</button>
			<button @click="autoOut()" style="margin-top: 10px;">切刀</button>
			<button @click="printTestTicket()" style="margin-top: 10px;">打印测试小票</button>
		</view>
	</view>