Flutter设备通信插件telpo_m8的使用

概述

telpo_m8 Flutter插件无缝集成到Telpo M8设备中，为开发者提供了访问诸如QR码扫描器、子LCD和热敏打印机等关键功能的能力。此插件使Flutter应用程序能够充分利用Telpo M8硬件的所有功能。

特性

1. QR码扫描器：利用Telpo M8设备轻松实现二维码扫描功能。
2. 子LCD集成：利用Telpo M8的子LCD功能显示额外信息或创建定制用户界面。
3. 热敏打印机支持：使用Telpo M8的热敏打印机打印收据或其他重要文档。

开始使用

安装

要使用此插件，在您的pubspec.yaml文件中添加telpo_m8作为依赖项：

dependencies:
  telpo_m8: ^1.0.0

然后运行：

$ flutter packages get

使用

在Dart代码中导入telpo_m8包：

import 'package:telpo_m8/telpo_m8.dart';

初始化Telpo M8设备：

await TelpoM8.initialize();

QR码扫描器

要使用QR码扫描器，调用以下方法：

String result = await TelpoM8.scanQRCode();
print("Scanned QR Code: $result");

子LCD

在子LCD屏幕上显示文本：

TelpoM8.showOnSubLCD("Hello, Telpo M8!");

热敏打印机

使用热敏打印机打印文档：

String content = "Your receipt details go here.";
await TelpoM8.printThermal(content);

额外功能

有关更多详细信息和额外功能，请参阅在线文档。

支持

遇到问题或有疑问？请在GitHub上创建一个issue。

贡献

欢迎贡献！请fork仓库并提交pull请求。

许可证

该插件根据MIT许可证发布。

示例代码

import 'dart:io';
import 'package:http/http.dart' as http;

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:telpo_m8/telpo_m8.dart';

void main() {
  runApp(const MaterialApp(home: MyApp()));
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  String _versionNumber = 'Unknown';
  String _qrCodeResult = 'Unknown';

  final _telpoM8Plugin = TelpoM8();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    String platformVersion;
    String versionNumber = "";
    // 平台消息可能会失败，所以我们使用try/catch PlatformException。
    // 我们还处理了消息可能返回null的情况。
    try {
      // platformVersion = await _telpoM8Plugin.getPlatformVersion() ??
      'Unknown platform version';
      // int versionNumber = await _telpoM8Plugin.getVersionNumber() ?? 0;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果在异步平台消息飞行时小部件从树中移除，我们希望丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      // _platformVersion = platformVersion;
      // _versionNumber = versionNumber;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Telpo M8 Plugin example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              TextButton(
                child: const Text('Display Image on LCD...'),
                onPressed: () async {
                  // 替换为实际的图像URL
                  final response = await http.get(Uri.parse(
                      'https://learnafricaplc.com/wp-content/uploads/2024/03/logo.jpg'));

                  // 将图像转换为字节数组
                  final Uint8List imageBytes = response.bodyBytes;

                  // 在LCD上显示图像
                  TelpoM8().displayImageOnLCD(imageBytes);
                },
              ),
              TextButton(
                child: const Text('Print Text with Thermal Printer...'),
                onPressed: () async {
                  // 替换为实际要打印的文本
                  TelpoM8().printWithThermalPrinter('=== Hello, world! ====', 7);
                },
              ),
              TextButton(
                child: const Text('Print Receipt with Thermal Printer...'),
                onPressed: () async {
                  // 替换为实际要打印的文本
                  String receiptText = 'LOGO and paystrait\n'
                      'Name of Vendor\n' // 这将是粗体和大号字体
                      'Amount: \n' // 这将是粗体和大号字体
                      'Transaction status: \n' // 这将是粗体和大号字体
                      'Transaction Id: \n'
                      'Date/Time of transaction: \n'
                      'In case of reprint, it should be stated as Reprint in the header';

                  TelpoM8().printWithThermalPrinter(receiptText, 7);
                },
              ),
              TextButton(
                child: const Text('Print QR Code with Thermal Printer...'),
                onPressed: () async {
                  // 替换为实际要打印的文本
                  String qrCodeText = 'LOGO and Paystrait\n'
                      'Name of the account holder\n'
                      'QR code\n'
                      'Expiration of the code';

                  TelpoM8().printWithThermalPrinter(qrCodeText, 7);
                },
              ),
              TextButton(
                child: const Text('Print Image with Thermal Printer...'),
                onPressed: () async {
                  // 替换为实际的图像URL
                  final response = await http.get(Uri.parse(
                      'https://api.learnafrica.ng/storage/images/y0q3Euv8nv5iCY5ODrrZP1aOqtBsdg0oe0NVTqpw.png'));

                  // 将图像转换为字节数组
                  final Uint8List imageBytes = response.bodyBytes;

                  // 使用热敏打印机打印图像
                  TelpoM8().printImageWithThermalPrinter(imageBytes, 7);
                },
              ),
            ],
          ),
        ),
      ),
    );
  }
}