使用 Flutter 列印 (商米 V2s (Sunmi)) 維吾爾語文字：解決字型和換行問題的方案與坑日記

nur01發表於2024-08-29
Flutter

使用 Flutter 列印維吾爾語文字：解決字型和換行問題的方案與坑日記

在使用商米 V2s (Sunmi) 印表機列印維吾爾語文字時，可能會遇到字型顯示不美觀和換行錯誤的問題。為了確保文字能夠按照預期顯示，我們可以採取將文字顯示在 Flutter 的 Widget 上，然後透過 screenshot 外掛將 Widget 轉換為影像進行列印的方法。這種方法能夠避免直接列印文字時可能出現的字型和換行問題。然而，在實際操作中，我們也發現了一些坑，特別是涉及列印快取的問題。下面我們詳細探討這些問題及其解決方案。

問題描述

直接使用 await SunmiPrinter.printText("ھەللە، بۈگۈن كۈندە بىر قانچە بەھسلىرنىڭ تۈرىنى ئويناشقا رۇخسەت بار."); 列印維吾爾語文字時，可能會遇到以下問題：

  1. 字型顯示不美觀：維吾爾語文字的字型效果可能不符合預期。
  2. 換行問題：直接列印文字可能導致換行不正確，文字顯示效果不如預期。

此外，列印過程中還可能出現以下問題：

  • 列印快取問題：在更換影像並再次列印時，列印出來的內容可能是舊的影像而不是新生成的影像。這種情況下，需要採取措施清除列印快取，以確保列印的是最新的影像。

解決方案

為了解決上述問題，可以採取以下步驟：

  1. 在 Flutter Widget 上顯示文字：將維吾爾語文字放置在 Flutter 的 Widget 中，按照我們期望的樣式進行顯示。
  2. 使用 screenshot 外掛捕獲 Widget：透過 screenshot 外掛將顯示文字的 Widget 捕獲為影像。
  3. 清除列印快取：在每次列印之前，確保清除列印快取，以避免出現舊影像的情況。可以透過呼叫 await SunmiPrinter.printText(""); 來清除快取。
  4. 列印影像：將捕獲的影像透過 SunmiPrinter.printImage 方法進行列印，以確保文字的顯示效果與 Widget 中的一致。

示例程式碼

以下是一個示例，展示瞭如何實現上述解決方案，並處理列印快取的問題：

import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:screenshot/screenshot.dart';
import 'package:sunmi_printer_plus/sunmi_printer_plus.dart';
import 'package:flutter_easyloading/flutter_easyloading.dart';

class PrintUyghurTextScreen extends StatefulWidget {
  @override
  _PrintUyghurTextScreenState createState() => _PrintUyghurTextScreenState();
}

class _PrintUyghurTextScreenState extends State<PrintUyghurTextScreen> {
  final ScreenshotController _screenshotController = ScreenshotController();

  Future<void> printUyghurText() async {
    EasyLoading.show(status: "正在列印...");

    // 捕獲 Widget 的截圖
    final Uint8List? image = await _screenshotController.capture();
    if (image == null) {
      EasyLoading.dismiss();
      EasyLoading.showError("截圖失敗");
      return;
    }

    // 啟動列印事務
    await SunmiPrinter.startTransactionPrint(true);

    // 清除列印快取
    await SunmiPrinter.printText("");

    // 列印影像
    await SunmiPrinter.printImage(image);
    await SunmiPrinter.printText(""); // 清除快取
    await SunmiPrinter.submitTransactionPrint();
    await SunmiPrinter.exitTransactionPrint(true);

    EasyLoading.dismiss();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('維吾爾語列印示例')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Screenshot(
              controller: _screenshotController,
              child: Container(
                padding: EdgeInsets.all(16.0),
                decoration: BoxDecoration(
                  border: Border.all(color: Colors.black),
                  borderRadius: BorderRadius.circular(8.0),
                ),
                child: Column(
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    Text(
                      "ھەللە، بۈگۈن كۈندە بىر قانچە بەھسلىرنىڭ تۈرىنى ئويناشقا رۇخسەت بار.",
                      style: TextStyle(fontSize: 18, fontFamily: 'YourCustomFont'), // 使用自定義字型
                    ),
                    // 可以在這裡新增更多的文字或其他元件
                  ],
                ),
              ),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: printUyghurText,
              child: Text('列印維吾爾語文字'),
            ),
          ],
        ),
      ),
    );
  }
}

總結

透過在 Flutter Widget 中顯示維吾爾語文字，並使用 screenshot 外掛將其捕獲為影像進行列印，我們可以有效解決直接列印文字時可能出現的字型和換行問題。在列印過程中，確保透過呼叫 await SunmiPrinter.printText(""); 清除列印快取，以避免列印出舊的影像。這樣可以確保每次列印時都能獲得最新的影像。

相關文章