# DKCloudID_UART_Andoird

**Repository Path**: lochy/DKCloudID_UART_Andoird

## Basic Information

- **Project Name**: DKCloudID_UART_Andoird
- **Description**: 德科物联云解码源码。配合德科DK26ME系列NFC模块读取完整的身份证明文信息，包括身份证号、姓名、名族、性别、住址、头像、出生日期、有效期等信息。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.derkiot.com/
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 2
- **Created**: 2020-08-05
- **Last Updated**: 2025-02-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: NFC, 身份证, 云解码, Android, 二代证云解码

## README

# DKCloudID_UART_Android

#### 介绍
深圳市德科物联技术有限公司的串口身份证阅读器Demo, 支持DK26ME、DK26ME-ANT、DK25GM、DK25-ST等模块。更多产品信息请访问[德科官网](http://www.derkiot.com/)。

### 如何集成到项目中
 **Step 1. Add the JitPack repository to your build file**
 
打开根build.gradle文件，将maven { url 'https://jitpack.io' }添加到repositories的末尾

```
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
```
 **Step 2. 添加 implementation 'com.gitee.lochy:dkcloudid-uart-android-sdk:v2.2.4' 到dependency** 

```

dependencies {
    implementation 'com.gitee.lochy:dkcloudid-uart-android-sdk:v2.2.4'
}
```

 **Step 3. 在AndroidManifest.xml中添加网络访问权限** 
 
 ```

    <uses-permission android:name="android.permission.INTERNET" />
```
 
 
 **Step 4. 初始化设备并打开串口** 

```

    //设备初始化
    uartNfcDevice = new UartNfcDevice();
    uartNfcDevice.setCallBack(deviceManagerCallback);
    
    //APP启动后延时3秒钟再打开串口，根据安卓主板的特性，不同的安卓主板需要延时的时间不一样
    new Thread(new Runnable() {
        @Override
        public void run() {
            try {
                Thread.sleep(3000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }

            uartNfcDevice.serialManager.open("/dev/ttyUSB0", "115200");
        }
    }).start();
```

 **Step 5. 添加读卡回调** 

```

    //设备操作类回调
    private DeviceManagerCallback deviceManagerCallback = new DeviceManagerCallback() {
        //非接寻卡回调
        @Override
        public void onReceiveRfnSearchCard(boolean blnIsSus, int cardType, byte[] bytCardSn, byte[] bytCarATS) {
            super.onReceiveRfnSearchCard(blnIsSus, cardType, bytCardSn, bytCarATS);
            
            final int cardTypeTemp = cardType;
            new Thread(new Runnable() {
                @Override
                public void run() {
                    //readWriteCardDemo(cardTypeTemp);   //普通IC卡读写API调用示例代码
                }
            }).start();
        }

        //身份证开始请求云解析回调
        @Override
        public void onReceiveSamVIdStart(byte[] initData) {
            super.onReceiveSamVIdStart(initData);

            Log.d(TAG, "开始解析");
        }

        //身份证云解析进度回调
        @Override
        public void onReceiveSamVIdSchedule(int rate) {
            super.onReceiveSamVIdSchedule(rate);
        }

        //身份证云解析异常回调
        @Override
        public void onReceiveSamVIdException(String msg) {
            super.onReceiveSamVIdException(msg);

            //显示错误信息
            //logViewln(msg);
        }

        //身份证云解析明文结果回调
        @Override
        public void onReceiveIDCardData(IDCardData idCardData) {
            super.onReceiveIDCardData(idCardData);

            //显示身份证数据
            showIDMsg(idCardData);
        }

        //卡片离开回调
        @Override
        public void onReceiveCardLeave() {
            super.onReceiveCardLeave();
            Log.d(TAG, "卡片已离开");
        }
    };
```