Flutter蓝牙打印机插件bx_btprinter的使用

bx_btprinter

此插件支持在Bixolon蓝牙打印机上进行收据打印。它已在Bixolon SPP-R310打印机上进行了测试，并支持Bixolon的蓝牙移动打印机。此外，它仅支持韩语字符集进行打印。

开始使用

要在您的Flutter项目中使用btPrinter，请将其添加到您的pubspec.yaml文件中：

dependencies:
  bx_btprinter: ^0.0.8 # 请替换为最新版本

使用方法

1. 请求蓝牙权限

Future<void> requestBluetoothPermissions() async {
  final _btprinterPlugin = Btprinter();
  String? result;
  try {
    result = await _btprinterPlugin.getBtPermission();
  } on PlatformException catch (e) {
    result = 'Error: ${e.message}';
  }
  print(result); // 如果权限被授予，将打印 "success"
}

2. 获取已配对设备

Future<void> getPairedDevices() async {
  final _btprinterPlugin = Btprinter();
  List<String?> devices = [];
  try {
    List<Object?> result = await _btprinterPlugin.getPairedDevices();
    devices = result.cast<String>().where((device) => device.startsWith('SPP')).toList();
  } on PlatformException catch (e) {
    print('Error: ${e.message}');
  }
  print(devices); // 打印已配对设备列表
}

3. 打印文本

Future<void> printText(String device) async {
  final _btprinterPlugin = Btprinter();

  List<String> deviceInfo = device.split('(');
  String logicalName = deviceInfo[0].split("_")[0].trim();
  String address = deviceInfo[1].replaceAll(')', '').trim();

  List<Map<String, dynamic>> textRequests = [
    {
      'text': '打印标题测试\n',
      'textAlignment': Btprinter.ALIGNMENT_CENTER,
      'textAttribute': Btprinter.ATTRIBUTE_BOLD,
      'textSize': 2,
    },
    {
      'text': '打印内容测试\n\n',
      'textAlignment': Btprinter.ALIGNMENT_LEFT,
      'textAttribute': Btprinter.ATTRIBUTE_NORMAL,
      'textSize': 1,
    },
  ];

  String? result;
  try {
    result = await _btprinterPlugin.printText(textRequests, logicalName, address);
  } on PlatformException catch (e) {
    result = 'Error: ${e.message}';
  }
  print(result); // 如果打印成功，将打印 "Success"。如果失败，会抛出包含 "connectingFailed" 的异常。
}

4. 打印条形码

Future<void> printBarcode(String device) async {
  final _btprinterPlugin = Btprinter();

  List<String> deviceInfo = device.split('(');
  String logicalName = deviceInfo[0].split("_")[0].trim();
  String address = deviceInfo[1].replaceAll(')', '').trim();

  List<Map<String, dynamic>> barcodeRequests = [
    {
      'data': '123456789012\n',
      'symbology': Btprinter.BARCODE_TYPE_ITF, // 可选，默认值
      'width': 3, // 可选，默认值
      'height': 100, // 可选，默认值
      'alignment': Btprinter.ALIGNMENT_LEFT, // 可选，默认值
      'hri': Btprinter.BARCODE_HRI_BELOW, // 可选，默认值
    },
  ];

  String? result;
  try {
    result = await _btprinterPlugin.printBarcode(barcodeRequests, logicalName, address);
  } on PlatformException catch (e) {
    result = 'Error: ${e.message}';
  }
  print(result); // 如果打印成功，将打印 "success"
}

完整示例

以下是一个完整的示例，展示了如何使用bx_btprinter插件来请求蓝牙权限、获取已配对设备并打印文本和条形码。

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'webview.dart';
import 'package:bx_btprinter/btprinter.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

Future<void> main() async {
  await dotenv.load(fileName: '.env');
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _btprinterPlugin = Btprinter(); // 调用插件

  @override
  void initState() {
    super.initState();

    initBle(); // 初始化蓝牙连接
  }

  void initBle() async {
    // 请求BLE权限
    await _getBle();
  }

  Future<void> _getBle() async {
    String? value;
    try {
      // value = await platform.invokeMethod('getBle');
      value = await _btprinterPlugin.getBtPermission();
    } on PlatformException catch (e) {
      value = 'native code error: ${e.message}';
    }
    // print(value);
  }

  @override
  Widget build(BuildContext context) {
    SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersive); // 设置为全屏模式，无导航栏

    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        backgroundColor: Colors.white, // 设置背景颜色为白色
        body: WebViewContainer(),
      ),
    );
  }
}