中软高科微信小程序NFC证件读卡SDK插件，支持身份证、护照、港澳台通行证等

已于 2024-12-11 15:07:52 修改
阅读量2k 收藏 23
点赞数 39
文章标签： 微信小程序 小程序
于 2024-12-05 14:22:24 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_39406065/article/details/144265518
版权

1、引入插件

在小程序的app.json中，加入插件。

"plugins": {
    "readcard-plugin": {
      "version": "2.3.2",
      "provider": "wxa2583ebacdb87a6a"
    }
}

2、基础库

调试基础库  2.18.1及以上

微信版本：
iOS      暂不支持NFC(微信官方未支持)，可使用蓝牙外设读卡器 
Android  8.0.6及以上版本，同时支持NFC、蓝牙外设读卡器

3、使用插件功能

3.1、读取身份证件信息功能

在需要使用身份证读卡的页面中，使用插件示例。

const plugin = requirePlugin('readcard-plugin');
var StatusCode = null;
var that = this;
var initSuccess = false;

Page({
  data: {
    idCardInfo: null,
  },
  onLoad() {
    that = this;
    StatusCode = plugin.StatusCodeEnum();
    console.log("对照状态码：", StatusCode);

    // 设置APPID （开始读卡之前，必须设置）
    plugin.setAppId("appid联系我司商务获取");

    // 设置读卡SDK参数
    that.readSetting();

    // 初始化读卡
    that.initRead();
  },

  // 设置读卡SDK参数
  readSetting(){
    // 日志保存目录
    // 默认在 Android/data/com.tencent.mm/MicroMsg/wxanewfiles目录下   搜索 zrgk_mini_log
    // 不需要日志时，可以不设置
    plugin.setShowLog(wx.getFileSystemManager(), wx.env.USER_DATA_PATH);

    // 读卡参数设置，根据需要自行修改参数值，参数名称及类型不可修改。
    var _Setting = {
      decodeImageType: "dn1", // dn0: 无照片   dn1: 平台解码照片
      readCardType: 2, // 2：NFC  7：蓝牙外设读卡器  9: NFC读护照/通行证
      saveLog: true, // 是否保存日志文件。设置true时，必须调用以上的 plugin.setShowLog(); 设置日志保存的目录
      openLocalCache: true, // 是否开启本地缓存
      // 解码服务器配置。
      // 默认第1个为主服务器,优先使用。
      // 其余皆为备用服务器,主服务器异常时自动切换启用
      ipPortArray: [{ 
        address: 'yfs4.sfzydq.com',
        port: 9999,
        canUse: true
      }, { 
        address: 'test.sfzydq.com',
        port: 18180,
        canUse: true
      }]
    };
    // 将参数设置给插件
    plugin.readSetting(_Setting);
  },

  // 初始化 读卡示例代码
  initRead() {
    if (initSuccess == true) {
      wx.showToast({
        title: '已经初始化过了',
        icon: 'none'
      });
      return;
    }
    // 初始化并开始读卡
    plugin.startReadCard(function (code, msg, value, cardType) {
      let code_msg = "code：" + code + "\n" + "msg：" + msg;
      that.setData({
        msg: code_msg,
      });
      switch (code) {
        case StatusCode.ININ_ING.code: // 初始化中
          wx.showLoading({
            title: '初始化中...',
            mask: true
          });
          break;
        case StatusCode.ININ_OK.code: // 初始化成功
          initSuccess = true;
          wx.hideLoading();
          wx.showToast({
            title: '初始化成功',
            icon: 'success'
          })
          break;
        case StatusCode.ININ_FAILE.code: // 初始化失败
          initSuccess = false;
          wx.hideLoading();
          if (msg.indexOf("13000") != -1) {
            wx.showModal({
              title: '温馨提示',
              content: '设备不支持NFC',
              complete: (res) => {}
            });
          } else if (msg.indexOf("13001") != -1) {
            wx.showModal({
              title: '温馨提示',
              content: '系统NFC开关未打开',
              complete: (res) => {}
            });
          } else {
            wx.showToast({
              title: msg,
              icon: 'error'
            })
          }
          break;
        case StatusCode.FIND_CARD_START.code: // 开始寻卡
          wx.showToast({
            title: '开始寻卡',
            icon: 'success'
          })
          break;
        case StatusCode.FIND_CARD_SUCCESS.code: // 寻卡成功
          allCount += 1;
          wx.showToast({
            title: '寻卡成功',
            icon: 'success'
          })
          break;
        case StatusCode.READCARD_START.code: // 开始解码
          wx.showLoading({
            title: '请勿移动卡片',
            mask: true
          })
          break;
        case StatusCode.READCARD_SUCCESS.code: // 解码成功
          wx.hideLoading();
          wx.showToast({
            title: '解码成功',
            icon: 'success'
          })
          switch (cardType) {
            case StatusCode.CARD_IC.code: // IC卡
              console.log("IC卡：" , value);
              break;
            case StatusCode.CARD_LCT_STUDENT.code: // 绿城通学生卡
              console.log("绿城通学生卡：" , value);
              break;
            case StatusCode.CARD_LCT_NORMAL.code: // 绿城通普通卡
              console.log("绿城通普通卡：" , value);
              break;
            case StatusCode.CARD_LCT_OLD.code: // 绿城通老年卡
              console.log("绿城通老年卡：" , value);
              break;
            case StatusCode.CARD_IDCARD.code: // 身份证
              // 读取到的身份证信息 
              // 详细字段说明，详见文档下发的附录
              var idCardInfo = JSON.parse(value);
              console.log("身份证信息：" , idCardInfo);
              // 当设置平台解码身份证照片时，
              // idCardInfo.image字段，为base64编码的照片字符串，可直接用于显示
              // idCardInfo.type=1080 中国居民身份证
              // idCardInfo.type=1081 新版外国永久居住证
              // idCardInfo.type=1082 港澳台居住证
              // idCardInfo.type=1083 旧版外国永久居住证
              break;
            case StatusCode.CARD_EPASSPORT.code: // 护照/通行证
              // 读取到的护照/通行证信息 
              // 详细字段说明，详见文档下发的附录
              var cardInfo = JSON.parse(value);
              console.log("证件信息：" , cardInfo);
              // cardInfo.image字段，为base64编码的照片字符串，可直接用于显示
              break;
          }
          break;
        case StatusCode.READCARD_FAILE.code: // 解码失败
          wx.hideLoading();
          wx.showToast({
            title: '解码失败' + msg,
            icon: 'error'
          })
          that.readFa();
          break;
      }
    });
  },

  onUnload() {
    console.log("onUnload", "界面销毁，需要停止读卡");
    plugin.stopReadCard();
  }
})

3.2、活体检测/人脸比对功能

  • 在界面的 **.wxml 添加camera
<camera device-position="front" flash="off" resolution='medium' frame-size='small' style="height: 100%;width: 100%;"/>

界面的其余样式，自行定义

  • 在界面 **.js 配置使用插件
const plugin = requirePlugin('readcard-plugin');
var that = this;

Page({

  /**
   * 页面的初始数据
   */
  data: {
    type: 1, // 1：仅活体检测  2：活体 + 人脸1:1比对
    outTimeMs: 5000, // 超时时间 毫秒(最小3秒)
    photoData: null, // (照片数据的字节数组)仅活体检测不需要传比对的照片，人脸人脸1:1比对时，需要传入比对的照片
    appid: "", // appid联系我司商务获取
    _Setting: {
      saveLog: true, // 是否保存日志文件
      // 服务器配置
      ipPortArray: [{
        address: 'test.sfzydq.com',
        port: 18181,
        canUse: true
      }]
    }
  },



  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    that = this;
    that.authorize();
  },

  /**
   * 向用户申请相机权限
   */
  authorize() {
    wx.getSetting({
      success(res) {
        if (!res.authSetting['scope.camera']) {
          wx.authorize({
            scope: 'scope.camera',
            success() {
              // 用户已经同意
              that.faceLive();
            },
            fail() {
              wx.openSetting({
                success(res) {
                  that.authorize();
                }
              })
            }
          })
        } else {
          that.faceLive();
        }
      }
    })
  },

  /**
   * 开始活体检测
   */
  faceLive() {
    // 设置APPID
    plugin.setAppId(that.data.appid);
    // 设置其他检测参数
    plugin.settingFacelive(that.data._Setting);
    // 帧数据回调
    const context = wx.createCameraContext()
    const listener = context.onCameraFrame((frame) => {
      plugin.onCameraFrame(frame);
    });
    // 开始检测
    plugin.startFacelive(listener, that.data.type, that.data.outTimeMs, that.data.photoData)
      .then((bean) => {
        console.log(bean);
        var content = "";
        if (bean.code != "00") { // 失败
          content = bean.msg;
        } else {
          content = "结果：" + bean.code + "\n活体分值：" + bean.liveGrade;
          if (that.data.type == 2) {
            content += "\n人脸比对分值：" + bean.faceGrade;
          }
        }
        wx.showModal({
          title: '温馨提示',
          content: content,
          showCancel: false,
          success: (res) => {
            if (res.confirm) { // 用户点击确定
              wx.navigateBack();
            }
          }
        });
      }).catch((err) => {
        console.log(err);
        var content = "";
        try {
          if (typeof err == "object") {
            let bean = err;
            content = bean.msg;
            content += "\n活体分值:" + bean.liveGrade;
            if (that.data.type == 2) {
              content += "\n人脸比对分值：" + bean.faceGrade;
            }
          } else {
            content = err;
          }
        } catch (error) {
          content = JSON.stringify(error);
        }
        wx.showModal({
          title: '温馨提示',
          content: content,
          showCancel: false,
          success: (res) => {
            if (res.confirm) { // 用户点击确定
              wx.navigateBack();
            }
          }
        });
      });
  },

  /**
   * 生命周期函数--监听页面卸载
   */
  onUnload() {
    plugin.stopFacelive();
  }
})

4、配置TCP合法域名

必须将参数配置时，配置的 ipPortArray 参数中的所有服务器地址，加入到合法的TCP域名，
否则无法访问到服务器。
如配置：

tcp://yfs4.sfzydq.com

tcp://test.sfzydq.com

tcp://yjm2.sfzydq.com

tcp://yfs3.sfzydq.com

5、附录

身份证详细信息IdCardData

字段类型注释
typeint1080:中国居民身份证
addressstring家庭住址
birthdaystring出生日期
dnstringdn码
endDatestring身份证结束时间
startDatestring身份证生效时间
idstring身份证号码
imageStringbase64照片
issuestring签发机关
namestring姓名
nationstring民族
sexstring性别
uuidstringuuid

外国人永久居住证IdCardData：

字段类型注释
typeint1081:新版外国人永久居住证 1083:旧版外国人永久居住证
birthdaystring出生日期
dnstringdn码
endDatestring身份证结束时间
startDatestring身份证生效时间
idstring身份证号码
issuestring签发机关
sexstring性别
uuidstringuuid
imageStringbase64照片
nameChinesestring中文姓名
nameEnglishstring英文姓名
nameEnglishAddstring英文姓名备用
nationlitystring国籍
cardVersionstring卡版本号
cardTypestring卡类型
historicalNumberstring既往版本证件号码关联项
renewalNumberstring换证次数

港澳台居住证详细信息IdCardData

字段类型注释
typeint1082:港澳台居住证
addressstring家庭住址
birthdaystring出生日期
dnstringdn码
endDatestring身份证结束时间
startDatestring身份证生效时间
idstring身份证号码
imageStringbase64照片
issuestring签发机关
namestring姓名
nationstring民族
sexstring性别
uuidstringuuid
passCheckIdstring通行证号码
issuesNumberstring签发次数

护照通行证详细信息

字段类型注释
nameOfHolderstring中文姓名
primaryIdentifierstring姓
secondaryIdentifierstring名
genderstring性别 M男 F女
dateOfBirthstring生日
nationalitystring国家码
dateOfExpirystring有效期
documentNumberstring护照号码
durationlong解码时长
mrzstring机读码
personNumberstring个人号码
idNumberstring证件号码
imageStringbase64照片
微信小程序怎么读取居民身份证？
qq_33714389的博客
01-15 1911
上传并发布：完成功能测试后，你需要将小程序上传到微信小程序的开放平台，并通过一系列审核流程，最终发布小程序。// 默认在 Android/data/com.tencent.mm/MicroMsg/wxanewfiles目录下 搜索 zrgk_mini_log。case StatusCode.CARD_LCT_STUDENT.code: // 绿城通学生卡。case StatusCode.CARD_LCT_NORMAL.code: // 绿城通普通卡。
分享通过Uniapp调用NFC读取身份证信息
qq_33714389的博客
01-16 4155
通过 uniapp 调用手机NFC功能读取二代居民身份证，还支持其他证件读取（社保卡、绿城通、超级SIM卡、IC卡、银行卡、外国人永久居住证、港澳台居住证）
微信小程序读取写入NFC文本，以及NFC直接启动小程序指定页面
最新发布
天龙的博客
02-28 1559
微信小程序读取写入NFC文本，以及NFC直接启动小程序指定页面
微信小程序nfc读取数据
DULIUu的博客
06-11 3251
console.log('发现' + adapter.tech.mifareClassic + '卡');console.log('发送数据并解密成功, 接收数据如下:', res);console.log('发送数据并解密成功, 接收数据如下:', res);console.log('发送数据失败A', err);console.log('发送数据失败A', err);console.log('完成连接', res)title: 'nfc失败！console.log('没发现卡');
微信小程序：扫描身份证读取身份信息
bpaxxesx的博客
06-14 1549
微信小程序：扫描身份证读取身份信息
微信小程序—NFC功能 可行
qq_32908349的博客
05-28 2321
#小程序NFC功能 小程序官方文档 API 代码参考 ###开发需求 使用手机nfc功能，读取IC卡扇区信息，绑定微信登录用户。 ###问题解析 1.mifareClassic.transceive发送数据失败 ###代码片段 /* num01:扇区号; num02:扇区块号; */ function getIcMsg(num01,num02){ const adapter = wx.getNFCAdapter(); const mifareClassic = adapter.getMifar
测试相关、sdk卡读取
weixin_33849215的博客
05-12 172
测试: monkey 猴子 测试整个系统 adb shell monkey -v 1000 (-v 指定模拟测试的事件数量) 测试某个程序 adb shell monkey -p &lt;程序的包名&gt; -v 事件的数量 android下Junit测试配置信息: 在AndroidManifest.xml中配置一下信息 1. 在manifest节点下配置一下信息. ...
微信小程序识别身份证 （一）
weixin_45733254的博客
06-20 1379
微信小程序是被身份证，通过调用接口的方式进行实现
微信小程序实现身份证识别功能。ocr识别插件。
朱仁彬的博客
12-17 7958
最近做的医院项目牵扯识别身份证，进行就诊卡查询的功能。记录如何实现这一功能。 首先打开小程序的后台，点开设置，选择第三方设置。 然后找到插件选项，打开并添加ocr支持插件。 添加完成后 ，需要领取免费额度，是一天100次。多了就需要购买。链接挂下方 https://fuwu.weixin.qq.com/detail/000ce4cec24ca026d37900ed551415 做好准备工作后就是代码部分。 首先在app.json里配置ocr-plugin "plugins": { "ocr-p
【计算机毕业设计】基于微信小程序的驾校学车预约服务系统_驾校预约小程序的设计研究现状
2401_84691713的博客
05-12 1050
谈到面试，其实说白了就是刷题刷题刷题，天天作死的刷。。。。。为了准备这个“金三银四”的春招，狂刷一个月的题，狂补超多的漏洞知识，像这次美团面试问的算法、数据库、Redis、设计模式等这些题目都是我刷到过的并且我也将自己刷的题全部整理成了PDF或者Word文档（含详细答案解析）66个Java面试知识点架构专题（MySQL，Java，Redis，线程，并发，设计模式，Nginx，Linux，框架，微服务等）+大厂面试题详解（百度，阿里，腾讯，华为，迅雷，网易，中兴，北京中软等）算法刷题（PDF）本文已被。
中软高科考试系统
05-21
"中软高科考试系统"是一款基于Java技术构建的在线考试平台，旨在为教师和学生提供便捷、高效的考试与自动阅卷服务。该系统利用Java的强大学习和开发能力，构建了一个稳定、安全的环境，使教育者能够轻松创建和管理...
社保读卡SDK_最终版20151229.zip
04-26
压缩包里面有BS版本和CS版本的示例程序，有可用控件，注册即可使用，目前最新的控件了，也有调用示例，供大家参考
中软高科 WhoA实名战疫 App
02-17
个人实时上报动态、疫情查询、同乘查询、人证核验、无证核验和实名认证等，还有家庭成员“颜值PK”等娱乐化功能。
基于 Linux 系统 ARM 架构的身份证识别插件技术解析与应用示例
qq_33714389的博客
01-21 871
Linux 身份证读取，二代证识别案例分享
微信小程序NFC读写工具
qq_16031297的博客
10-23 2464
微信小程序搜NFC Tool可以体验
微信小程序实现身份证识别功能
一个超爱喝可乐的web前端攻城狮
02-28 5186
微信小程序实现身份证识别功能 1,首先登录小程序公众平台 2,进入设置 第三方设置 3,添加ocr插件 4,添加完成后 ，需要领取免费额度，是一天100次; 链接 然后就是代码编写部分 首先在app.json里配置ocr-plugin "plugins": { "ocr-plugin": { "version": "3.0.6", "provider": "wx4418e3e031e551be" } }, 然后在你需要的页面中引入插件 .json
Uniapp插件如何通过NFC读取多种证卡信息？
证卡识读张工的博客
12-12 2312
nfc读卡uniapp插件，由中软高科进行开发，主要是通过NFC读取居民身份证、港澳台居住证、外国人居住证、护照等证卡的信息。经过多个版本的升级更新，目前性能已趋于稳定，并且读卡速度较之最初版本有了大的提升。
基于Android NFC传感器读取身份证信息demo
sundy_ywz的博客
07-26 8030
摘要：通过导入开发包sdk开发基几Android NFC设备读取身份证信息 1. 开发条件： 1）鱼住往来科技的身份验证sdk ：下载地址：https://www.yzfuture.cn/views/service/index.html 2）Android Studio3.0以上 3）基于java语言开发，非kotlin语言 2.添加包步骤： 1）添加以下两个包 在Android Studio项目 中相应的依赖文件build.gradle（Module.app）添...
中软高科苹果iPhone手机iOS系统NFC身份证解码SDK集成说明
证卡识读张工的博客
12-06 1014
苹果iPhone手机iOS系统，使用NFC读取居民身份证、港澳台居住证、外国人居住证等证件信息
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值