人脸核身 - 代码示例

HarmonyOS 集成说明

开发环境要求

应用平台	适用版本	开发环境
HarmonyOS	5.0.3 及以上系统	HarmonyOS

项目配置

1、添加 HAR 文件依赖

请将 esignfacesdk.har 添加至项目的 src/libs 目录下，并在模块的 oh-package.json5 文件中配置依赖：

"dependencies": {
  "esignfacesdk": "file:src/libs/esignfacesdk.har"
}

点击下载Harmony SDK

注意：HarmonyOS的SDK、Demo仅支持编译到实机上运行

2、权限配置

在模块 module.json5 中添加权限声明，除网络权限外还需添加相机权限：

"requestPermissions": [
  {
    "name": "ohos.permission.CAMERA",
    "reason": "$string:cam_reason",
    "usedScene": {
      "abilities": [
        "EntryAbility"
      ],
      "when": "inuse"
    }
  }
]

SDK 接口说明

1、SDK 初始化

方法签名：

EsignSDK.getInstance().initSDK(licenseKey, license, (result: InitResponse) => { })

接口说明： 传入互亿无线平台获取的 licenseKey 和 license 字符串，完成 SDK 激活。

参数	类型	必填	说明
licenseKey	string	是	互亿无线开放平台提供的 licenseKey
license	string	是	互亿无线平台提供的 license 文件内容
result	InitResponse	是	初始化结果回调可通过 result.success 字段判断初始化是否成功。

请求示例：

2、唤起 SDK 刷脸

方法签名：

EsignSDK.getInstance().verity(faceAuthCode, (result: FaceResultResponse) => {})

接口说明： 调用刷脸 SDK，发起人脸核身流程。

参数	类型	必填	说明
faceAuthCode	String	是	后端获取的人脸识别 Token（faceToken）
result	FaceResultResponse	是	刷脸结果回调 FaceResultResponse 字段说明 passed： true 表示刷脸成功，false 表示失败 completed： true 表示流程完成，false 表示未完成 errCode：错误码 msg：错误描述信息说明：可根据返回result.passed字段判断刷脸是否成功，否则就是刷脸失败，获取errCode错误码和msg错误信息进行提示

参数

类型

必填

说明

faceAuthCode

String

是

后端获取的人脸识别 Token（faceToken）

result

FaceResultResponse

是

刷脸结果回调

FaceResultResponse 字段说明

passed： true 表示刷脸成功，false 表示失败
completed： true 表示流程完成，false 表示未完成
errCode： 错误码
msg： 错误描述信息

说明：可根据返回result.passed字段判断刷脸是否成功，否则就是刷脸失败，获取errCode错误码和msg错误信息进行提示