# tyfpr-android-sdk

**Repository Path**: gdty/tyfpr-android-sdk

## Basic Information

- **Project Name**: tyfpr-android-sdk
- **Description**: 基于Android平台的指纹识别SDK，提供完整的指纹采集、比对、设备控制等功能。适用于需要指纹识别能力的Android应用开发。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-27
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Gitea

## README

# tyfpr-android-sdk

## 功能简介
本项目为基于Android平台的指纹识别SDK，提供完整的指纹采集、比对、设备控制等功能。适用于需要指纹识别能力的Android应用开发。

## 特性
- 支持指纹采集与图像获取
- 提供指纹模板创建与比对功能
- 支持设备连接管理与权限控制
- 包含图像质量检测与校准功能

## 安装方法
### Gradle集成
在项目的`build.gradle`中添加仓库地址：
```gradle
maven { url 'https://maven.cnb.cool/gdty/gradle/-/packages/' }
```

在模块的`build.gradle`中添加依赖：
```gradle
implementation 'com.gdty.fpr:tyfpr-android-sdk:1.0.0'
```

## 使用说明
### 初始化
在Application中初始化SDK：
```java
public class TyApplition extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化SDK
    }
}
```

### 基本操作
#### 设备连接
```java
// 连接设备
Interface mInterface = new Interface(activity);
mInterface.F_OpenDevice();
```

#### 获取指纹图像
```java
byte[] imageBuffer = new byte[LAPI.IMAGE_SIZE];
mInterface.F_GetImage(mInterface.getrwusbdevices(), imageBuffer);
```

#### 创建指纹模板
```java
byte[] imageBuffer = ...; // 指纹图像数据
byte[] template = new byte[1024];
mInterface.F_CreateTemplate(deviceHandle, imageBuffer, template);
```

#### 指纹比对
```java
// 比较两个指纹模板
int result = mInterface.F_CompareTemplates(deviceHandle, template1, template2);
```

### 权限请求
使用USB设备前需要请求权限：
```java
HostUsb mHostUsb = new HostUsb();
mHostUsb.AuthorizeDevice(context, LAPI.VID, LAPI.PID);
```

## 注意事项
1. 调用的方法必须与so文件的包名一致
2. 本SDK不支持USB有线调试模式
3. 使用前请确保已正确声明USB权限
4. 指纹模板存储需自行管理数据库

## 示例代码
请参考`TestActivity.java`中的具体实现，包含完整的设备控制、指纹采集、模板管理等功能演示。

## 依赖项
- 需要`power.jar`支持底层通信
- 包含armeabi和armeabi-v7a架构的so文件

## 许可证
本项目遵循开源许可协议，请参考项目中的 `LICENSE` 文件获取详细信息。