パッケージ、リポジトリ、アプリカテゴリを検索

zkfinger10 のカバー
パッケージ詳細v1.0.0+2

zkfinger10

zk_finger10 プラグインは、ZKTECO の指紋デバイスの登録および検証機能をサポートするために使用されます。

Android
30日間ダウンロード
38
いいね数
19
Pub ポイント
150

パッケージをインストール

flutter pub add zkfinger10

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

zk_finger10 プラグインは、Android 上での ZKTECO フィンガープリントデバイスとの統合を可能にし、指紋の登録および検証機能を提供します。ローカルなバイオメトリック認証向けに設計されており、対応ハードウェア上で安全に指紋を直接キャプチャおよび検証できるようにします。物理アクセス制御、勤怠管理システム、またはオフライン環境におけるセキュアなユーザー認証が必要なアプリケーションに最適です。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

ソースリポジトリ

このパッケージを使用しているプロジェクト

データはまだありません。