Flutter中文处理插件flutter_chs的使用

安装依赖

首先，在项目的 pubspec.yaml 文件中添加 flutter_chs 依赖：

  // 在命令行中运行以下命令：
  flutter pub add flutter_chs

运行上述命令后，会在 pubspec.yaml 文件中自动添加如下依赖项：

dependencies:
  flutter_chs: ^版本号

完成后，可以使用以下命令获取依赖：

flutter pub get

或者直接让 IDE 自动执行依赖安装。

导入依赖

在 Dart 文件中导入 flutter_chs 包：

import 'package:flutter_chs/flutter_chs.dart';

使用示例

1. 读取身份证

通过调用 readIdCard 方法读取身份证信息：

Map<String, dynamic> result = await FlutterChs.readIdCard(timeout: 10);
print("DEMO-RESULT: $result");

返回结果示例：

{
  "code": 0,         // 状态码：0 表示成功，1 表示失败
  "message": "成功", // 提示信息
  "data": "身份证信息" // 返回数据
}

2. 读取社保卡

通过调用 readSocialSecurityCard 方法读取社保卡信息：

Map<String, dynamic> result = await FlutterChs.readSocialSecurityCard();
print("DEMO-RESULT: $result");

返回结果示例：

{
  "code": 0,
  "message": "成功",
  "data": "社保卡信息"
}

3. 开启扫码功能

通过调用 scanOpen 方法开启扫码功能：

Map<String, dynamic> result = await FlutterChs.scanOpen(timeout: 10);
print("DEMO-RESULT: $result");

返回结果示例：

{
  "code": 0,
  "message": "成功",
  "data": "扫码结果"
}

4. 开启蜂鸣器开关

开启蜂鸣器：

await FlutterChs.beepSwitchOpen;

关闭蜂鸣器：

await FlutterChs.beepSwitchClose;

5. 寻找身份证

通过调用 findIdCard 方法寻找身份证：

Map<String, dynamic> result = await FlutterChs.findIdCard;
print("DEMO-RESULT: $result");

返回结果示例：

{
  "code": 0,
  "message": "成功",
  "data": "已找到身份证"
}

6. 寻找社保卡

通过调用 findHealthCard 方法寻找社保卡：

Map<String, dynamic> result = await FlutterChs.findHealthCard;
print("DEMO-RESULT: $result");

返回结果示例：

{
  "code": 0,
  "message": "成功",
  "data": "已找到社保卡"
}

7. 多合一功能（NFC、IC卡、扫码）

通过调用 openReadDevice 方法实现多合一功能：

/// 可选参数说明：
/// timeout       - 读卡超时时间，单位秒；默认：30 秒
/// isIdCard      - 是否支持身份证，默认：true
/// isScan        - 是否支持扫码，默认：true
/// isHealthCard  - 是否支持社保卡，默认：true

Map<String, dynamic> result = await FlutterChs.openReadDevice();
print("DEMO-RESULT: $result");

返回结果示例：

{
  "code": 0,
  "message": "成功",
  "data": "多合一设备读取结果"
}

8. 显示和隐藏 Loading

显示默认的 Loading：

FlutterChs.showLoading();

显示自定义消息的 Loading：

FlutterChs.showLoading(msg: '加载中...');

隐藏 Loading：

FlutterChs.hideLoading();

完整示例代码

以下是一个完整的示例代码，展示如何使用 flutter_chs 插件：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Flutter CHS 示例')),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 调用读取身份证方法
              Map<String, dynamic> result = await FlutterChs.readIdCard(timeout: 10);
              print("身份证读取结果: $result");

              // 调用读取社保卡方法
              Map<String, dynamic> socialResult = await FlutterChs.readSocialSecurityCard();
              print("社保卡读取结果: $socialResult");

              // 显示 Loading
              FlutterChs.showLoading(msg: '加载中...');

              // 模拟延迟操作
              await Future.delayed(Duration(seconds: 2));

              // 隐藏 Loading
              FlutterChs.hideLoading();
            },
            child: Text('开始读取'),
          ),
        ),
      ),
    );
  }
}