패키지, 저장소 및 앱 카테고리 검색

zkfinger10 표지
패키지 상세v1.0.0+2

zkfinger10

zk_finger10 플러그인은 ZKTECO의 지문 장치를 등록 및 검증 기능을 지원하기 위해 사용됩니다.

Android
30일 다운로드
38
좋아요
19
Pub 점수
150

패키지 설치

flutter pub add zkfinger10

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

zk_finger10 플러그인은 안드로이드에서 ZKTECO 지문 장치와의 통합을 가능하게 하며, 지문 등록 및 검증 기능을 제공합니다. 로컬 생체 인식 인증을 위해 설계되어 개발자가 지원되는 하드웨어에서 지문을 안전하게 캡처하고 검증할 수 있도록 합니다. 물리적 접근 제어, 출퇴근 시스템 또는 오프라인 환경에서의 보안 사용자 인증이 필요한 애플리케이션에 적합합니다. ZKTECO SDK를 통해 네이티브 장치 통신을 활용하여 다양한 ZKTECO 지문 스캐너와 호환성을 보장합니다.

사용 사례

  • 출석 추적 시스템
  • 보안 액세스 제어
  • 오프라인 생체 인식 인증
  • 직원 시간 관리
  • 기기별 지문 등록

주요 기능

  • ZKTECO 지문 장치를 지원합니다
  • 등록 및 검증 기능
  • 안드로이드 전용 플랫폼 지원
  • 네이티브 장치 통신
  • 오프라인 운영 기능

적합한 대상

  • 출석 앱을 개발하는 개발자
  • 안전한 로컬 생체 인식을 필요로 하는 시스템
  • ZKTECO 하드웨어 통합
  • 안드로이드 기반 키오스크 애플리케이션
  • 엔터프라이즈 보안 솔루션

고려 사항

  • 안드로이드 플랫폼에 제한됨
  • 호환되는 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

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.