Flutter RFID读取插件 zebra_rfid_reader_sdk 的使用

概述

Zebra RFID Reader SDK 是一个用于Flutter的插件，它允许开发者连接并配置Zebra RFID读卡器。该插件支持设置天线功率、蜂鸣器音量以及动态功率等功能。

功能特性

• 连接到配对的Zebra RFID读卡器。
• 配置天线功率、蜂鸣器音量和动态功率功能。

使用方法

导入及创建实例

首先，在你的Dart文件中导入zebra_rfid_reader_sdk包，并创建一个插件实例：

import 'package:zebra_rfid_reader_sdk/zebra_rfid_reader_sdk.dart';

final _zebraRfidReaderSdkPlugin = ZebraRfidReaderSdk();

连接设备

要连接到RFID读卡器，可以使用connect函数。此函数接受两个参数：tagName（设备名称）和可选的readerConfig（用于配置天线功率、蜂鸣器音量等）。

注意：

1. 天线功率值应在120至300之间。
2. 在调用连接函数前，请确保已请求蓝牙扫描和连接权限。

Future<void> requestAccess() async {
  await Permission.bluetoothScan.request().isGranted;
  await Permission.bluetoothConnect.request().isGranted;
}

_zebraRfidReaderSdkPlugin.connect(
  tagName,
  readerConfig: ReaderConfig(
    antennaPower: 300,
    beeperVolume: BeeperVolume.high,
    isDynamicPowerEnable: true,
  ),
);

断开连接

断开与RFID读卡器的连接非常简单：

_zebraRfidReaderSdkPlugin.disconnect();

获取可用读卡器列表

获取所有已配对设备的列表：

_zebraRfidReaderSdkPlugin.getAvailableReaderList();

设置天线功率

设置RFID读卡器的天线功率：

_zebraRfidReaderSdkPlugin.setAntennaPower(value); // value between 120 and 300

设置蜂鸣器音量

调整RFID读卡器的蜂鸣器音量：

_zebraRfidReaderSdkPlugin.setBeeperVolume(value); // integer value representing volume level

设置动态功率

配置RFID读卡器的动态功率：

_zebraRfidReaderSdkPlugin.setDynamicPower(value); // boolean value

监听事件

监听RFID读卡器的状态变化：

_zebraRfidReaderSdkPlugin.connectedReaderDevice.listen((event) {
  final result = jsonDecode(event.toString());
  log(result.toString());
});

示例Demo

下面是一个完整的示例代码，展示了如何在Flutter应用中集成zebra_rfid_reader_sdk插件：

import 'dart:async';
import 'dart:convert';
import 'dart:developer';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:zebra_rfid_reader_sdk/zebra_rfid_reader_sdk.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  final _zebraRfidReaderSdkPlugin = ZebraRfidReaderSdk();
  List<ReaderDevice> availableReaderList = [];
  ReaderDevice connectedReader = ReaderDevice.initial();
  double antennaPower = 270;
  double beeperVolume = 3;
  bool isDynamicPowerEnable = true;

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

  // ... 其他方法如 connectToZebra, disconnectToZebra, setAntennaPower 等...

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Plugin example app')),
        body: Padding(
          padding: const EdgeInsets.all(16),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              const Text('DEVICES'),
              Text('Handheld Readers (${availableReaderList.length})', style: const TextStyle(fontSize: 24, fontWeight: FontWeight.bold)),
              Expanded(child: ListView.builder(itemBuilder: (context, index) => /* 列表项构建逻辑 */)),
              // 其他UI组件...
            ],
          ),
        ),
      ),
    );
  }
}