logo
logo
请输入关键词搜索产品或者文档
中国

中国站

创蓝云智

国际站

Innopaas

鸿蒙端集成文档

更新时间:2026-07-23 19:05:12

一、准备工作

1、概述

本文是活体检测SDK_HarmonyOS 端接入文档,用于指导 SDK 的集成使用。

2、创建应用

在创蓝平台注册账号,创建应用并获取 appIdappkey

3、开发环境搭建

添加依赖

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

4、快速体验 demo

  • SDK压缩包中的RealAuthDemo文件是demo示例源码,可直接运行起来测试。

二、API调用

0. 获取authToken

  • 请查看服务端集成文档,调用获取授权Token(authToken)接口,获取authToken为后续步骤做准备。

1、初始化

调用 SDK 其他流程方法前,请确保已调用过初始化,否则会返回未初始化。(会采集信息,建议放到同意协议后调用)

 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)
24小时热线 400-9669-253