Flutter电子书阅读插件tianbo_reader_plugin的使用

Flutter电子书阅读插件tianbo_reader_plugin的使用

天波身份证读卡插件

天波身份证读卡插件，测试设备为天波台式终端 D2，USB 读卡器。使用天波通用 SDK，理论上支持所有天波 USB 读卡设备。

使用说明

1. 引入插件

   在 pubspec.yaml 文件中添加插件依赖：

   dependencies:
     tianbo_reader_plugin: ^0.0.4
   

2. 添加 USB 权限

   在 Android 项目的 AndroidManifest.xml 文件中添加 USB 权限：

   <uses-feature android:name="android.hardware.usb.host" android:required="true"/>
   

3. 修改最低 SDK 版本到 26，Flutter 默认为 21

   在 build.gradle 文件中修改默认配置：

   defaultConfig {
       applicationId = "com.henghe.tianbo_plugin_example"
       minSdk = 26
       targetSdk = flutter.targetSdkVersion
       versionCode = flutter.versionCode
       versionName = flutter.versionName
   }
   

4. 调用读卡器

   引入插件并调用相关方法：

   import 'package:tianbo_reader_plugin/tianbo_plugin.dart';
   
   final _tianboPlugin = TianboPlugin();
   // 打开读卡器
   _tianboPlugin.openReader();
   // 关闭读卡器
   _tianboPlugin.closeReader();
   // 读卡器状态
   _tianboPlugin.isOpen();
   // 读卡
   _tianboPlugin.readCard();
   

完整示例代码

以下是完整的示例代码，展示了如何在 Flutter 应用中使用 tianbo_reader_plugin 插件。

import 'dart:convert';

import 'package:flutter/material.dart';

import 'package:tianbo_reader_plugin/tianbo_plugin.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  final _tianboPlugin = TianboPlugin();

  String text = '读卡器未打开';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('身份证读卡器插件示例应用'),
        ),
        body: SingleChildScrollView(
          child: Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Text('结果: $text'),
                ElevatedButton(
                  onPressed: () async {
                    var result = await _tianboPlugin.openReader();
                    if (result) {
                      text = '读卡器已打开';
                    } else {
                      text = '读卡器打开失败';
                    }
                    setState(() {});
                  },
                  child: const Text('打开读卡器'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    await _tianboPlugin.closeReader();
                    setState(() {
                      text = '读卡器已关闭';
                    });
                  },
                  child: const Text('关闭读卡器'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    var result = await _tianboPlugin.isOpen();
                    if (result) {
                      text = '当前状态：打开';
                    } else {
                      text = '当前状态：关闭';
                    }
                    setState(() {});
                  },
                  child: const Text('当前读卡器状态'),
                ),
                ElevatedButton(
                  onPressed: () async {
                    var result = await _tianboPlugin.readCard();
                    if (result != null) {
                      text = jsonEncode(result);
                    } else {
                      text = '读卡失败';
                    }
                    setState(() {});
                  },
                  child: const Text('读卡'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}