注意事项

商用的 companyId 请务必联系我司商务进行分配。

添加aar依赖

• 添加读卡SDK maven仓库

allprojects {
    repositories {
        google()
        jcenter()
        // 中软高科读卡SDK仓库
        maven {
            url 'https://gitee.com/cshtzrgk/read-card-sdk/raw/master/Repositorys'
        }
    }
}

• 依赖最新版本的读卡SDK

implementation "io.github.CshtZrgk:CshtReadCard:ZFB_3.3.9"

1、读卡参数配置

ReadCardOutMethod readCardManager = ReadCardApiOtg.Companion
                // 上下文
                .builder(getBaseContext())
                // 设置默认服务器ip及端口
                .setDefaultServerSetting("yfs3.sfzydq.com", 9999)
                // 设置备用服务器ip及端口
                .setStandbyServerSetting("yjm2.sfzydq.com", 9999)
                // 设置公司ID 。商用的 companyId 请务必联系我司商务进行分配。
                .setCompanyId("test")
                // 是否开启蜂鸣器
                .setVoiceOpen(true) 
                // 是否开启日志保存
                .setSaveLogFlag(true) 
                // 设置日志保存的目录绝对路径
                // 传空字符时，默认在 Android/data/包名/files/zrgkreadcardlog 下
                .setSaveLogAbsolutePath("") 
               // 是否初始化网络连接，若选择否，则只能读取身份证dn码及uid
               .setNetworkNeedInitial(true)
               // 设置读卡数据回调
               .setReadCardListener(listener)
               .buildCreate();

方法参数说明

回调

示例

    @Override
    public void onReadCardStateChanged(int type, int state, String msg) {
        switch (state){
            case Constants_info.READCARD_STATE_INIT_SUCCESS:
                // 初始化成功
                // 初始化成功后，开启单次读卡
                readCardManager.readCardOnceStart();
                break;
            case Constants_info.READCARD_STATE_INIT_FAIL:
                // 初始化失败
                break;
        }
    }

    @Override
    public void onReadIDCardSuccess(int type, IdCard bean, Info info) {
          // 身份证读取成功 | 外国人居住证读取成功 | 港澳台居住证读取成功 
          // 根据 IdCard bean中的type来区分
          // type==1080:中国居民身份证  type==1081:外国人永久居住证 type==1082:港澳台居住证
    }

    @Override
    public void onReadIDCardFail(int type, int state, String msg) {
         // 身份证读取失败
    }

    @Override
    public void onReadICCardSuccess(int type, String icnumber) {
         // IC卡读取成功
    }

    @Override
    public void onReadICCardFail(int type, int state, String msg) {
        // IC卡读取失败
    }

    @Override
    public void onReadIDCardSimpleInfo(int type, String dn, String uid) {
        // 离线读取身份证的 dn、uid
    }

2、读卡初始化方法

• 初始化方法如下：

readCardManager.readCardInit();

3、用户开启读卡

// 初始化成功后，可进行手动单次读卡调用
readCardManager.readCardOnceStart();

4、关闭自动循环读卡

readCardManager.closeAutoRead();

5、停止读卡

readCardManager.readCardStop();

6、获取序列号

readCardManager.getSerial();

7、获取固件版本号

readCardManager.getFirmwareVersion();

身份证详细信息 IdCard

港澳台居住证详细信息 IdCard

外国人永久居住证IdCard：

状态码对应表