sunmi_flutter_helper 0.0.7

Flutter plugin for Sunmi V2s Plus printers and scanners.

Sunmi Flutter Helper Plugin

A Flutter plugin to print rich receipts via Sunmi printers. Supports text, QR, barcode, image, table columns, divider lines, and NFC/Scanner streams.

---

🚀 Getting Started

1. Add dependency

dependencies:
  sunmi_flutter_helper: ^0.0.2

2. Android Permissions (Optional)

<uses-permission android:name="android.permission.BLUETOOTH" />

---

✅ Printer Connection Check

bool isConnected = await SunmiFlutterHelper.isPrinterConnected();

---

🖨 Print Text

await SunmiFlutterHelper.printText(
  text: "Welcome",
  align: "center",
  bold: true,
  underline: true,
  size: 18,
);

Parameter	Type	Required	Description
text	String	✅	The text to print
align	String	❌	"left", "center", or "right"
bold	bool	❌	Bold style
underline	bool	❌	Underline text
size	int	❌	Font size (default is 16)

---

📦 Print QR Code

await SunmiFlutterHelper.printQrCode(
  qrText: "https://4brains.in",
  align: "center",
  width: 200,
  height: 200,
);

Parameter	Type	Required	Description
qrText	String	✅	Data to encode in the QR code
align	String	❌	"left", "center", or "right"
width	int	❌	Width in pixels
height	int	❌	Height in pixels

---

🧾 Print Barcode

await SunmiFlutterHelper.printBarcode(
  data: "123456789012",
  align: "center",
  width: 300,
  height: 100,
  readable: "TWO",
);

Parameter	Type	Required	Description
data	String	✅	Barcode data
align	String	❌	"left", "center", or "right"
width	int	❌	Width in pixels
height	int	❌	Height in pixels
readable	String	❌	Human-readable: "ONE", "TWO", "THREE"

---

🖼 Print Image

final bytes = await loadImageAsset("assets/logo.jpg");
await SunmiFlutterHelper.printImage(
  image: bytes,
  align: "center",
  width: 384,
  threshold: 200,
);

Parameter	Type	Required	Description
image	Uint8List	✅	Image byte data
align	String	❌	"left", "center", or "right"
width	int	❌	Target width
height	int	❌	Target height
threshold	int	❌	Binarization threshold (default 200)

---

📊 Print Table Columns

await SunmiFlutterHelper.printColumns(
  texts: ['Item', 'Qty', 'Price'],
  weights: [3, 1, 2],
  align: "right",
);

Parameter	Type	Required	Description
texts	List	✅	List of column texts
weights	List	✅	Width weight for each column
align	String	❌	"left", "center", or "right"

---

➖ Print Divider Line

await SunmiFlutterHelper.printLine(
  type: 'solid',
  height: 4,
);

Parameter	Type	Required	Description
type	String	✅	"solid", "dotted", or "empty"
height	int	❌	Height of the line (default 24 px)

---

🔍 Barcode/QR Scanner Stream

SunmiFlutterHelper.scanStream.listen((code) {
  print("Scanned Code: $code");
});

---

📶 NFC Reader Stream

SunmiFlutterHelper.nfcStream.listen((data) {
  print("NFC Data: $data");
});

---

🛠 Requirements

• Flutter 3.0+
• Android 11+
• Only for Sunmi Android devices

---

👨‍💻 Maintainer

4Brains Technologies
🔗 https://www.4brains.in
📧 [e-mail]