Flutter打印机控制插件flutter_sunmi_printer的使用

插件简介

flutter_sunmi_printer 插件允许使用带有内置打印机的 Sunmi 设备打印热敏收据。该插件已在 Sunmi V2 上进行了测试。

特性

以下是插件支持的主要功能：

• <code>text</code>：打印带样式的文本（加粗、下划线、对齐方式、字体大小）。
• <code>row</code>：打印包含最多 12 列的行（总列宽必须等于 12）。
• <code>image</code>：打印带对齐方式的图像。
• <code>hr</code>：打印全宽分隔符。
• <code>emptyLines</code>：打印指定数量的空白行。
• <code>boldOn</code> 和 <code>boldOff</code>：开启或关闭加粗模式。
• <code>underlineOn</code> 和 <code>underlineOff</code>：开启或关闭下划线模式。

待办事项

以下功能尚待实现：

• 打印二维码。
• 打印条形码。

使用步骤

1. 引入插件

在 pubspec.yaml 文件中添加依赖项：

dependencies:
  flutter_sunmi_printer: ^latest_version

2. 初始化插件

确保设备已连接到打印机，并初始化插件。

3. 编写打印代码

示例代码

import 'dart:typed_data';
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_sunmi_printer/flutter_sunmi_printer.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  void _print() async {
    // 打印全宽分隔符
    SunmiPrinter.hr();

    // 打印居中的标题
    SunmiPrinter.text(
      'Test Sunmi Printer',
      styles: SunmiStyles(align: SunmiAlign.center),
    );

    // 打印全宽分隔符
    SunmiPrinter.hr();

    // 测试文本对齐方式
    SunmiPrinter.text(
      'left',
      styles: SunmiStyles(bold: true, underline: true),
    );
    SunmiPrinter.text(
      'center',
      styles: SunmiStyles(bold: true, underline: true, align: SunmiAlign.center),
    );
    SunmiPrinter.text(
      'right',
      styles: SunmiStyles(bold: true, underline: true, align: SunmiAlign.right),
    );

    // 测试文本大小
    SunmiPrinter.text('Extra small text', styles: SunmiStyles(size: SunmiSize.xs));
    SunmiPrinter.text('Medium text', styles: SunmiStyles(size: SunmiSize.md));
    SunmiPrinter.text('Large text', styles: SunmiStyles(size: SunmiSize.lg));
    SunmiPrinter.text('Extra large text', styles: SunmiStyles(size: SunmiSize.xl));

    // 测试表格布局
    SunmiPrinter.row(
      cols: [
        SunmiCol(text: 'col1', width: 4),
        SunmiCol(text: 'col2', width: 4, align: SunmiAlign.center),
        SunmiCol(text: 'col3', width: 4, align: SunmiAlign.right),
      ],
    );

    // 加载并打印图片
    ByteData bytes = await rootBundle.load('assets/rabbit_black.jpg');
    final buffer = bytes.buffer;
    final imgData = base64.encode(Uint8List.view(buffer));
    SunmiPrinter.image(imgData);

    // 打印 3 行空白行
    SunmiPrinter.emptyLines(3);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Test Sunmi Printer'),
        ),
        body: Column(
          children: <Widget>[
            SizedBox(height: 50),
            Center(
              child: RaisedButton(
                onPressed: _print,
                child: const Text('Print demo', style: TextStyle(fontSize: 20)),
              ),
            ),
          ],
        ),
      ),
    );
  }
}