实人认证SDK

概述

• 活体检测： 通过SDK刷脸界面，完成指定动作（张嘴、摇头等），判断是否为真实自然人。
• 身份证OCR： 通过扫描采集身份证照片中的有效信息，识别并返回二代居民身份证正反面的关键信息。
• 身份证二要素： 通过官方权威核查，实时校验姓名和身份证号二要素是否一致。
• 人像比对： 在核验用户身份信息的同时判断人像和身份证信息是否为同一人。
• HarmonyOS Developer生态市场地址【实人认证SDK】

安装

"dependencies": { "@wanshu/realauthsdk": 'file:../RealAuthSDK' }

官方地址

demo下载地址

使用

1. 初始化

复制成功
 import {CLConfigureUtil,CLOCRManager,CLRealPersonManager } from '@wanshu/realauthsdk'
 // 设置appId
 CLConfigureUtil.setAppId(RS_AppKey)

 // 设置token,token的获取需要用户服务端对接平台服务端获取对应的token，demo中有本地获取示例
 CLConfigureUtil.setToken("<#token#>")

2. 活体检测

需要'ohos.permission.CAMERA','ohos.permission.MICROPHONE'权限

复制成功
// 添加延时防止获取不到surfaceId
setTimeout( ()=>{
      // 配置相机视图
      CLRealPersonManager.getInstance().initWithRecordView(this.context,this.surfaceId)
      // 设置超时时间
      CLRealPersonManager.getInstance().setTimeoutInterval(30)
      // 设置检测动作个数及安全标准
      CLRealPersonManager.getInstance().setActionNumer(1,0)
      // 设置动作的检测时长，默认为2s
      CLRealPersonManager.getInstance().setActionDuration(2)
      // 启动活体检测
      CLRealPersonManager.getInstance().startLiveDetectWithActionsHandler((params:CLTypeParamObject,url?:string)=>{

      },(status:CLStatus,params:ESObject)=>{
      })
    },200)

3. OCR识别

身份证双面识别

复制成功
/**
   * 身份证OCR接口    ⚠️ 先调用人像面（图片大小建议压缩为1M以内，超过会被SDK压缩）
   * @param image: 传入的身份证图片
   * @param isFront: true：人像面；false：国徽面
   * @returns Promise<Object> 返回结果：
   * @example
   * 国徽面数据 :{
                 "expire_date"       = "失效日期";
                 "issuing_authority" ="签发机关";
                 "issuing_date"      = "签发日期";
               };
   *人像面数据：{
                  "address"    = "地址";
                  "brith_day"  = "出生日期";
                  "id_card_no" = "身份证号";
                  "name"       = "姓名";
                  "nation"     = "民族";
                  "sex"        = "性别";
               };
   * */
  static async realPersonOCROfSignal(image: PixelMap, isFront: boolean): Promise<Object> 

身份证单面识别

复制成功
/**
   * 身份证OCR接口    识别人像面和国徽面（单图片大小建议压缩为1M以内，超过会被SDK压缩）
   * @param frontImagePixMap 人像面照片
   * @param backImagePixMap  国徽面照片
   * @returns Promise<Object> 返回结果
   * @example {
              back = {
                       "expire_date"       = "失效日期";
                       "issuing_authority" = "签发机关";
                       "issuing_date"      = "签发日期";
                     };
             front =  {
                       "address"    = "地址";
                       "brith_day"  = "出生日期";
                       "id_card_no" = "身份证号";
                       "name"       = "姓名";
                       "nation"     = "民族";
                       "sex"        = "性别";
                      };
   * */
  static async realPersonOCR(frontImagePixMap: PixelMap, backImagePixMap: PixelMap): Promise<Object> 

身份证认证

复制成功
/**
   * 身份证认证
   * @param name：姓名
   * @param idNumber：身份证号码
   * @returns Promise<Object> 返回结果：
   * @example {
                "order_no"  : "业务唯一流水号",
                "city"      : "城市",
                "country"   : "县区",
                "gender"    : "性别：1：男、2：女",
                "age"       : "年龄",
                "remark"    : "备注，例：一致",
                "birthday"  : "生日，格式是yyyyMMdd",
                "result"    : "返回结果： 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定（收费）   04-认证失败(不收费)",
                "handle_time" : "查询时间 例：2018-04-09 15:05:01",
                "province"  : "省份"
              }
   * */
  static async realPersonDetect(name: string, idNumber: string): Promise<Object>