# tyidcard

**Repository Path**: gdty/tyidcard

## Basic Information

- **Project Name**: tyidcard
- **Description**: 身份证阅读器和指纹识别工具包java sdk
- **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-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Gitea

## README

# tyidcard

## 身份证阅读器和指纹识别工具包

兼容 Windows 32 位和 64 位系统，支持大部分身份证阅读器设备。  
开发包由广东东信智能科技有限公司提供。

## 功能简介

- 支持身份证信息读取，包括姓名、性别、民族、出生日期、地址、身份证号、签发机关、有效期限等。
- 支持指纹信息采集与解析。
- 提供对身份证阅读器硬件的兼容支持，适配主流设备。
- 提供 JNA 工具类用于动态链接库加载和系统文件操作。
- 支持自动识别操作系统架构（x86/x64）并加载对应 DLL 文件。

## 安装说明

### Maven 配置

在 `pom.xml` 中添加以下配置：

```xml
<repositories>
    <repository>
        <id>gdteyu-maven</id>
        <name>public</name>
        <url>https://maven.cnb.cool/gdteyu/maven/-/packages/</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

<dependency>
    <groupId>com.gdty</groupId>
    <artifactId>tyidcard</artifactId>
    <version>xxx</version>
</dependency>
```

请将 `xxx` 替换为实际版本号。

## 使用示例

### 初始化身份证阅读器

```java
JNAUtils.initIdCardDll();
```

### 读取身份证信息

```java
// 示例代码，请参考 IdcardTest.java
public static void main(String[] args) {
    // 初始化身份证阅读器驱动
    JNAUtils.initIdCardDll();

    // 调用身份证阅读器接口读取信息
    byte[] idCardData = ... // 通过设备接口获取原始数据
    IdCardInfo idCardInfo = IdcardUitls.getInfo(idCardData);

    System.out.println("姓名：" + idCardInfo.getName());
    System.out.println("身份证号：" + idCardInfo.getIdCard());
}
```

### 获取指纹信息

```java
byte[] fpData = ... // 从身份证数据中提取的指纹信息
FpInfo fpInfo = FpUtils.getFp(fpData);

System.out.println("指纹1编码：" + fpInfo.getFirstFpCode());
System.out.println("指纹2编码：" + fpInfo.getSecondFpCode());
```

## 工具类说明

- `JNAUtils`：用于初始化动态链接库，支持自动识别系统架构并加载对应 DLL。
- `IdcardUitls`：提供身份证信息解析方法。
- `FpUtils`：提供指纹信息解析方法。
- `FileUtils`：提供文件路径和资源读取工具方法。
- `SystemUtils`：提供系统架构检测方法。

## 支持平台

- Windows 32 位 / 64 位系统

## 依赖说明

- 使用 JNA 调用本地 DLL 文件。
- 包含身份证阅读器和指纹识别模块的原生库文件（x86/x64）。

## 相关文档

[公安部身份证阅读器模块SAM通讯协议](https://blog.csdn.net/zhangbijun1230/article/details/85242964)

## 许可协议

请参考项目中的 LICENSE 文件。