搜尋套件、儲存庫與 APP 分類

zkfinger10 封面
套件詳情v1.0.0+2

zkfinger10

zk_finger10 插件用於支援 ZKTECO 指紋設備的註冊與驗證功能。

Android
近 30 天下載
38
喜歡數
19
Pub 分數
150

安裝套件

flutter pub add zkfinger10

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

zk_finger10 插件可實現與 ZKTECO 指紋設備在 Android 上的整合,提供指紋註冊與驗證功能。專為本地生物識別認證設計,允許開發者安全地在支援的硬體上直接擷取與驗證指紋。該插件非常適合需要實體存取控制、出勤系統或離線環境下安全使用者認證的應用程式。它透過 ZKTECO SDK 實現原生裝置通訊,確保與多種 ZKTECO 指紋掃描儀相容。

適用情境

  • 出勤追蹤系統
  • 安全存取控制
  • 離線生物特徵認證
  • 員工時間管理
  • 設備特定的指紋註冊

主要特色

  • 支援ZKTECO指紋設備
  • 註冊和驗證功能
  • 僅限 Android 的平台支援
  • 原生設備通訊
  • 離線操作功能

適合對象

  • 開發出勤應用的開發者
  • 需要安全本地生物識別的系統
  • ZKTECO硬體整合
  • 基於Android的自助服務應用
  • 企業安全解決方案

使用建議

  • 僅限 Android 平台
  • 需要相容的ZKTECO硬體
  • 不支援 iOS
  • 取決於設備固件
  • 可能需要為特定型號進行額外設定

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Support Palestine

zkfinger10 - Modern Fingerprint Plugin for Flutter 🚀

pub package Flutter Android Stand with Palestine

📱 Sample Screenshot

screenshot

A modern, fully updated Flutter plugin for ZKTeco fingerprint scanners with Flutter v3.35.3 compatibility and Android Plugin V2 embedding. This package provides comprehensive support for ZKTeco fingerprint devices including enrollment, verification, and advanced template management.

✨ Major v1.0.0 Update - Fully Modernized!

This plugin has been completely modernized for 2024+ Flutter development:

  • 🎯 Flutter v3.35.3 Compatible
  • 🔧 Android Plugin V2 Embedding
  • 📱 Android API 34+ Support
  • 🏗️ Modern Gradle Build System
  • 💾 Enhanced Database Management
  • 🔒 Improved Security & Performance

📱 Supported Devices

Compatible with ZKTeco fingerprint scanners including:

  • SLK20R series
  • ZK9500 series
  • ZK6500 series
  • ZK8500R series
  • Other ZKTeco USB fingerprint devices

Note: This is an unofficial community-maintained package

cbdd3449eef878911f5c7b6ec75365d2-300x300 (1)

🚀 Getting Started

Requirements
  • Flutter: 3.35.0 or higher
  • Dart SDK: 3.1.0 or higher
  • Android: API 21+ (Android 5.0+)
  • Target Android: API 34 (Android 14)
Installation

Add this to your package's pubspec.yaml file:

dependencies:
  zkfinger10: ^1.0.0

Then run:

flutter pub get

⚙️ Android Configuration

1. Add Permissions

Add these permissions to your android/app/src/main/AndroidManifest.xml:

  • In the Manifest permission section add:
   <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />
    <uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE"
        android:maxSdkVersion="32"
        tools:ignore="ScopedStorage" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    <uses-permission android:name="android.hardware.usb.host" />
2. Configure Activity Intent Filters

Add these intent filters inside the <activity> tag in your AndroidManifest.xml:

<intent-filter>
    <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
    <action android:name="android.intent.action.BOOT_COMPLETED" />
  </intent-filter>
  <meta-data
           android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
           android:resource="@xml/device_filter" />
3. Add USB Device Filter

Create android/app/src/main/res/xml/device_filter.xml with the following content:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <usb-device vendor-id="6997" product-id="289" />
</resources>

📚 API Reference

Core Methods
import 'package:zkfinger10/zkfinger10.dart';

// Initialize connection
await ZkFinger.openConnection();

// Register a fingerprint
await ZkFinger.registerFinger(userId: "user123");

// Identify a fingerprint
await ZkFinger.identify();

// Clear all fingerprints
await ZkFinger.clearFingerDatabase();

// Close connection
await ZkFinger.closeConnection();
🆕 New Bidirectional Data Management
// Get fingerprint feature data for a specific user
String? feature = await ZkFinger.getUserFeature(userId: "user123");

// Get all users and their fingerprint data
Map<String, String>? users = await ZkFinger.getAllUsers();

// Get total count of users
int? count = await ZkFinger.getUserCount();

// Update user's fingerprint feature data
bool? success = await ZkFinger.updateUserFeature(
  userId: "user123",
  feature: "base64_encoded_fingerprint_data"
);

// Check if user exists
bool? exists = await ZkFinger.checkUserExists(userId: "user123");
Event Streams
// Listen to fingerprint status changes
ZkFinger.fingerStatusChangeStream.listen((status) {
  print('Status: ${status['message']}');
});

// Listen to fingerprint image data
ZkFinger.fingerImageStream.listen((imageBytes) {
  // Process fingerprint image
});

⚠️ Build Configuration

Release Build Settings

Add these lines to your android/app/build.gradle if you have problems on release:

    buildTypes {
        release {
           ....
            
            //Add these lines when releasing your app
            minifyEnabled false
            shrinkResources false
            // useProguard false 
            
        }
    }

🔧 Troubleshooting

Common Issues
  1. Plugin not found: Ensure you've run flutter pub get and restarted your IDE
  2. USB permission denied: Check that your device filter XML is correctly configured
  3. Build errors: Verify your Flutter and Android versions meet the requirements
  4. Runtime crashes: Ensure you're targeting Android API 34+ with proper permissions
Migration from v0.x.x

If upgrading from an older version:

  1. Update Flutter: Ensure you're using Flutter 3.35.0+
  2. Update Android: Target API 34+ in your build.gradle
  3. Check Permissions: Verify all required permissions are added
  4. Test Thoroughly: The plugin now uses V2 embedding which may affect lifecycle behavior

🤝 Contributing

Found a bug or want to contribute?

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • ZKTeco for the original SDK
  • Flutter community for continuous support
  • All contributors who helped modernize this plugin

所屬分類

依賴

依賴清單 2 項

  • plugin_platform_interface^2.1.8
  • uuid^4.5.1

原始碼儲存庫

使用此套件的專案

暫無相關資料。