Flutter中如何通过蓝牙热敏打印机打印HTML及阿拉伯文本？

方案1：HTML转图片打印（适配RTL排版） #

这种方式能利用HTML轻松实现阿拉伯文的RTL排版，再将渲染后的内容转成图片发送给打印机，兼容性强。

步骤： #

• 依赖包准备：添加以下包到pubspec.yaml

  dependencies:
    flutter_html: ^3.0.0-beta.2
    esc_pos_bluetooth: ^0.2.4
    flutter:
      sdk: flutter
  

• HTML内容处理：确保HTML包含RTL方向属性，指定阿拉伯字体（需提前引入字体文件到项目）

  <div dir="rtl" style="font-family: 'Noto Naskh Arabic', sans-serif; font-size: 16px;">
    السلام عليكم، هذا نص عربي لاختبار الطباعة
  </div>
  

• 渲染HTML并转图片：用RepaintBoundary捕获渲染后的Widget为图片

  final GlobalKey repaintKey = GlobalKey();
  
  // 构建HTML渲染Widget
  Widget buildHtmlContent() {
    return RepaintBoundary(
      key: repaintKey,
      child: Html(
        data: '<div dir="rtl" style="font-family: \'Noto Naskh Arabic\', sans-serif; font-size: 16px;">السلام عليكم، هذا نص عربي لاختبار الطباعة</div>',
      ),
    );
  }
  
  // 捕获图片
  Future<Uint8List?> captureHtmlImage() async {
    final renderObject = repaintKey.currentContext?.findRenderObject() as RenderRepaintBoundary?;
    if (renderObject == null) return null;
    final image = await renderObject.toImage(pixelRatio: 2.0);
    final byteData = await image.toByteData(format: ImageByteFormat.png);
    return byteData?.buffer.asUint8List();
  }
  

• 蓝牙打印图片：用esc_pos_bluetooth发送图片到打印机

  Future<void> printImageToPrinter(BluetoothDevice device, Uint8List imageBytes) async {
    final printer = BluetoothPrinter(device);
    await printer.connect();
    final ticket = Ticket(PaperSize.mm80);
    // 将图片适配打印机宽度
    final img = Image.fromBytes(imageBytes);
    ticket.image(img);
    await printer.printTicket(ticket);
    await printer.disconnect();
  }
  

方案2：直接生成ESC/POS指令（原生支持RTL的打印机） #

如果你的打印机支持ESC/POS的RTL控制指令，可以直接构造打印指令，无需转图片，效率更高。

示例代码： #

import 'package:esc_pos_utils/esc_pos_utils.dart';
import 'package:esc_pos_bluetooth/esc_pos_bluetooth.dart';

Future<void> printArabicText(BluetoothDevice device) async {
  final printer = BluetoothPrinter(device);
  await printer.connect();
  final ticket = Ticket(PaperSize.mm80);

  // 开启RTL文本模式（部分打印机支持ESC R 1指令）
  ticket.raw([0x1B, 0x52, 0x01]);
  // 打印阿拉伯文本，设置右对齐
  ticket.text("السلام عليكم", styles: PosStyles(align: PosAlign.right));
  ticket.text("هذا نص عربي مُحسن التنسيق", styles: PosStyles(align: PosAlign.right, fontType: PosFontType.fontB));
  // 关闭RTL模式
  ticket.raw([0x1B, 0x52, 0x00]);

  await printer.printTicket(ticket);
  await printer.disconnect();
}

关键注意事项 #

• 字体支持：无论是HTML转图片还是直接打印，都要确保打印机或应用内有阿拉伯字体，避免乱码。
• 打印机兼容性：低端热敏打印机可能不支持原生RTL指令，此时图片打印是更可靠的选择。
• 尺寸适配：HTML转图片时，要将Widget宽度设置为打印机的有效打印宽度（比如80mm对应约384像素），避免内容被截断。

内容的提问来源于stack exchange，提问作者Mary