Flutter门禁管理插件flutter_zkteco的使用

特性

• 通过TCP/IP连接到指纹识别设备
• 获取用户信息（如ID、姓名等）
• 获取考勤记录（时间戳、用户ID等）
• 支持实时数据和批量数据获取
• 兼容ZKTeco及类似设备

开始使用

安装

在你的项目pubspec.yaml文件中添加以下依赖：

dependencies:
  flutter_zkteco: ^1.0.2

然后运行：

flutter pub get

平台支持

• Android
• iOS
• Web (待定)
• Windows

使用方法

导入包

import 'package:flutter_zkteco/flutter_zkteco.dart';

初始化插件

// 创建一个ZKTeco实例
ZKTeco fingerprintMachine = ZKTeco('192.168.1.201', port: 4370);

// 初始化连接
bool isConnected = await fingerprintMachine.connect();
if (isConnected) {
  print('Connection established!');
} else {
  print('Connection failed!');
}

获取考勤记录

// 从机器获取考勤记录
List<AttendanceLog> logs = await fingerprintMachine.getAttendanceLogs();
for (var log in logs) {
  print('User ID: ${log.id}, Timestamp: ${log.timestamp}');
}

获取用户信息

// 从指纹机获取用户信息
List<UserInfo> users = await fingerprintMachine.getUsers();
for (var user in users) {
  print('User ID: ${user.userId}, Name: ${user.name}');
}

断开连接

await fingerprintMachine.disconnect();
print('Disconnected from the fingerprint machine.');

示例

下面是一个完整的示例，演示如何连接、获取数据并断开连接：

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '指纹机演示',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  ZKTeco fingerprintMachine;
  List<AttendanceLog> logs = [];

  [@override](/user/override)
  void initState() {
    super.initState();
    fingerprintMachine = ZKTeco('192.168.1.201', port: 4370);
  }

  Future<void> connectAndFetchLogs() async {
    bool isConnected = await fingerprintMachine.connect();
    if (isConnected) {
      List<AttendanceLog> fetchedLogs = await fingerprintMachine.getAttendanceLogs();
      setState(() {
        logs = fetchedLogs;
      });
      await fingerprintMachine.disconnect();
    } else {
      print('Failed to connect.');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('指纹考勤记录'),
      ),
      body: Center(
        child: Column(
          children: [
            ElevatedButton(
              onPressed: connectAndFetchLogs,
              child: Text('获取记录'),
            ),
            Expanded(
              child: ListView.builder(
                itemCount: logs.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text('User ID: ${logs[index].userId}'),
                    subtitle: Text('Timestamp: ${logs[index].timestamp}'),
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}