Flutter条码扫描与打印集成插件zebra_scan_print_datawedge的使用

该插件提供了与Zebra DataWedge交互的简单接口，用于条形码扫描和标签打印功能。它包括管理DataWedge配置文件的方法、控制扫描以及通过Zebra打印机打印标签的方法。

功能

• 创建和管理DataWedge配置文件
• 启动和停止条形码扫描
• 获取扫描数据流
• 连接到Zebra打印机（通过IP）
• 使用Zebra打印机打印标签
• 校准Zebra打印机

安装

要使用Zebra DataWedge插件，请将其添加到pubspec.yaml文件中：

dependencies:
  zebra_scan_print_datawedge: ^<latest_version>

然后运行flutter pub get以安装包。

设置

1. 确保在Zebra设备上安装了Zebra DataWedge应用。
2. 确保授予访问扫描器和打印机功能所需的权限。

使用

初始化DataWedge

在使用任何DataWedge功能之前，必须初始化插件。

ZebraDataWedge().initialized();

扫描方法

创建DataWedge配置文件

此方法使用给定的名称创建一个DataWedge配置文件。如果没有提供名称，默认为"TejasGProdInternal_2"。

ZebraDataWedge().createDataWedgeProfile(profileName: "MyProfile");

启动扫描

此方法将启动条形码扫描器。

ZebraDataWedge().startScan();

停止扫描

此方法将停止条形码扫描器。

ZebraDataWedge().stopScan();

获取扫描数据流

此方法提供一个流，该流将在扫描时发出扫描的条形码数据。

ZebraDataWedge().getStreamOfData.listen((scannedData) {
  print('Scanned Data: $scannedData');
});

启用DataWedge

启用DataWedge服务。

ZebraDataWedge().enableDataWedge();

禁用DataWedge

禁用DataWedge服务。

ZebraDataWedge().disableDataWedge();

打印机方法

连接到打印机

使用其IP地址和可选端口号（默认为9100）连接到Zebra打印机。

bool isConnected = await ZebraDataWedge().connectToPrinter("192.168.1.100");

断开连接到打印机

使用其IP地址断开连接到Zebra打印机。

bool isDisconnected = await ZebraDataWedge().disconnectToPrinter("192.168.1.100");

打印标签

发送ZPL（Zebra编程语言）命令到打印机以打印标签。确保传递的标签被前导斜杠和单引号包围。

bool printed = await ZebraDataWedge().printerLabel("192.168.1.100", "/'^XA^FO100,100^A0N,50,50^FDHello, World!^FS^XZ'/");

校准打印机

通过发送校准命令来校准Zebra打印机。命令必须被前导斜杠和单引号包围。

bool calibrated = await ZebraDataWedge().calibratePrinter("192.168.1.100", "/'^XA^MMT^XZ'/");

检查打印机是否可用

此方法会检查打印机是否在提供的IP地址处可用。

bool isAvailable = await ZebraDataWedge().isPrinterAvailable("192.168.1.100");

API 方法

扫描方法

• createDataWedgeProfile({String profileName = "TejasGProdInternal_2"}): 使用给定的配置文件名称创建DataWedge配置文件。
• startScan(): 开始条形码扫描过程。
• stopScan(): 停止条形码扫描过程。
• getStreamOfData: 提供扫描条形码的数据流。
• initialized(): 初始化插件以使用。
• enableDataWedge(): 启用DataWedge服务进行扫描。
• disableDataWedge(): 禁用DataWedge服务进行扫描。

打印机方法

• connectToPrinter(String ipAddress, {int portNumber = 9100}): 使用提供的IP地址和端口号连接到Zebra打印机。
• disconnectToPrinter(String ipAddress): 断开连接到Zebra打印机。
• printerLabel(String ipAddress, String label): 发送ZPL标签到打印机。
• calibratePrinter(String ipAddress, String command): 发送校准命令到打印机。
• isPrinterAvailable(String ipAddress): 检查打印机是否在提供的IP地址处可用。

示例

void main() async {
  ZebraDataWedge dataWedge = ZebraDataWedge();

  // 初始化DataWedge
  await dataWedge.initialized();

  // 创建DataWedge配置文件
  await dataWedge.createDataWedgeProfile(profileName: "MyProfile");

  // 开始扫描
  await dataWedge.startScan();

  // 监听扫描数据
  dataWedge.getStreamOfData.listen((scannedData) {
    print('Scanned Data: $scannedData');
  });

  // 连接到打印机
  bool connected = await dataWedge.connectToPrinter("192.168.1.100");

  // 打印标签
  bool printed = await dataWedge.printerLabel("192.168.1.100", "'^XA^FO100,100^A0N,50,50^FDHello, Zebra!^FS^XZ'");

  // 检查打印机是否可用
  bool isAvailable = await dataWedge.isPrinterAvailable("192.168.1.100");

  // 校准打印机
  bool calibrated = await dataWedge.calibratePrinter("192.168.1.100", "'^XA^MMT^XZ'");

  // 断开连接到打印机
  bool disconnected = await dataWedge.disconnectToPrinter("192.168.1.100");
}