sunmi_printer_plus 包可实现与 Android 上 Sunmi V2 Pro 标签打印机的无缝集成,支持空安全和自定义 Esc/Pos 命令。它允许开发者直接从 Flutter 应用打印文本、图像、二维码和条形码。该包设计可靠且易于使用,提供简洁的 API 将打印任务发送到 Sunmi 硬件,非常适合需要标签或收据打印的零售、物流和销售点应用。
适合场景
零售收据打印
物流标签打印
销售点系统
库存管理
自定义 Esc/Pos 命令执行
主要特点
支持Sunmi V2 Pro标签打印机
空安全兼容
打印文本、图像、二维码、条形码
自定义 Esc/Pos 命令支持
仅限 Android 平台的兼容性
适合对象
面向 Sunmi 打印机的 Flutter 开发人员
需要标签打印的业务应用
POS系统集成
移动库存解决方案
使用建议
仅限 Android
需要兼容的Sunmi硬件
仅限基于 Esc/Pos 的打印
不支持 iOS 或桌面端
需要正确的设备权限
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
sunmi_printer_plus
This is a fork from sunmi_printer , but i implemented a lot of other features described below
Important:
THIS PACKAGE WILL WORK ONLY IN ANDROID!
Support Sunmi and Null Safety.
I build this flutter plugin based on this:
Official Sunmi Inner Printer Doc. But not all method from doc was included in this package, beacuse i don't have equipment. If you have and can help me, just contact me on github!
Installation
flutter pub add sunmi_printer_plus
What this package do
[x] Print in label mode (when avaliable!)
[x] Write some text (with style or not!)
[x] Change font size
[x] Jump (n) lines
[x] Draw a divisor line
[x] Bold mode on/off
[x] Print all types of Barcodes (see enum below)
[x] Print Qrcodes with custom width and error-level
[x] Print image from asset or from web (example show how to print both)
[x] Print rows like recepit with custom width and alignment
[x] Able to combine with some esc/pos code that you already have!
[x] Cut paper - Dedicated method just to cut the line
[x] Printer serial no - Get the serial number of the printer
[x] Printer version - Get the printer's version
[x] Printer paper size - Get the paper size ( 0: 80mm 1: 58mm)
[x] Get how many times the cash drawer was oppened
Tested Devices
Sunmi V2 Pro
Sunmi T2 mini
Sunmi V2S
You can also combine this package with the package esc_pos_utils
With this package you can create a custom escpos and than you don't need to use any other command.
This is good if you already have a code that another printers use, and u can reuse this code as well
#Just see the example folder!
// import packagesimport'package:sunmi_printer_plus/sunmi_printer_plus.dart';
// all method from sunmi printer need to async awaitawaitSunmiPrinter.bindingPrinter(); // must bind the printer first. for more exmaple.. pls refer to example tab.
Example code when use for transaction printing
awaitSunmiPrinter.startTransactionPrint(true);
awaitSunmiPrinter.setAlignment(SunmiPrintAlign.RIGHT); // Right alignawaitSunmiPrinter.printText('Align right');
awaitSunmiPrinter.setAlignment(SunmiPrintAlign.LEFT);// Left alignawaitSunmiPrinter.printText('Align left');
awaitSunmiPrinter.setAlignment(SunmiPrintAlign.CENTER);// Center alignawaitSunmiPrinter.printText('Align center');
awaitSunmiPrinter.lineWrap(2); // Jump 2 linesawaitSunmiPrinter.setFontSize(SunmiFontSize.XL); // Set font to very largeawaitSunmiPrinter.printText('Very Large font!');
awaitSunmiPrinter.resetFontSize(); // Reset font to medium sizeawaitSunmiPrinter.setCustomFontSize(12); // SET CUSTOM FONT 12awaitSunmiPrinter.printText('Custom font size!!!');
awaitSunmiPrinter.resetFontSize(); // Reset font to medium sizeawaitSunmiPrinter.printQRCode('https://github.com/brasizza/sunmi_printer'); // PRINT A QRCODEawaitSunmiPrinter.submitTransactionPrint(); // SUBMIT and cut paperawaitSunmiPrinter.exitTransactionPrint(true); // Close the transaction
awaitSunmiPrinter.lcdInitialize(); //Initialize the LCD awaitSunmiPrinter.lcdWakeup(); //Turn the LCD ONawaitSunmiPrinter.lcdSleep(); //Turn the LCD OFFawaitSunmiPrinter.lcdClear(); //Clear LCD screenawaitSunmiPrinter.lcdString('Hello'); //Write a simple line awaitSunmiPrinter.lcdString('Hello'); //Write a simple line awaitSunmiPrinter.lcdDoubleString('Hello', 'World'); //Write two linesUint8List byte = awaitreadFileBytes('assets/images/128x40.png');
awaitSunmiPrinter.lcdImage(byte); // Put an image in LCDawaitSunmiPrinter.lcdFillString('abcDEFgj0123\$&=+', size: 16, fill: true); // Print a string and fill with zeros until the size is reachedawaitSunmiPrinter.lcdMultiString([ 'Welcome to flutter.', 'Align 2.',], [ 1, 2,]); // Write multiple lines with alignent
boolawaitSunmiPrinter.drawerStatus(); //check if the cash drawer is connect or disconnectawaitSunmiPrinter.openDrawer(); //open de cash drawerintawaitSunmiPrinter.drawerTimesOpen(); //How many times de cash drawer was oppened