概述与资源

HarmonyOS SDK 提供给集成 HarmonyOS Next 原生客户端开发的开发者使用。

DeepKonw 为极验业务安全服务的基础感知构件，主要用于采集客户端的相关安全信息，为后续服务提供数据，是其他极验服务的基础

环境需求

安装

获取 SDK

通过邮件获取

导入 SDK 到项目工程并配置开发环境

1. 将获取的.har文件放入工程中的libs文件夹下。

2. 检查.har是否被添加到Library, 需要在项目的 oh-package.json5 下添加如下代码：

   "dependencies": { "captchaSdk": "file:./libs/geetest_deepknow_harmonyos_vx.y.z_date.har" }

添加权限

  "requestPermissions": [
  {
    "name": "ohos.permission.INTERNET",
    "usedScene": {
      "abilities": [
        ...
      ],
      ...
    }
  }
],

代码示例

初始化与调用

初始化

在应用业务创建时初始化。

static getInstance(context: Context, appId?: string): DPAPI | null

app_id 为在极验后台申请的 app_id

获取 session 数据

获取 session_id 查询当前状态

DPAPI.getInstance(this.context.getApplicationContext())?.getSessionStatus(this.dpListener);

session_id 使用参考服务端接入文档

提交自定义数据

提交自定义数据给极验分析（定制接口，获取 session_id 请调用 getSessionStatus 接口）

DPAPI.getInstance(this.context.getApplicationContext())?.submitExtraData(jsonObject, this.dpListener);

注意第一层必须有 "scene" 字段标识场景 id，具体见服务端文档

DPListener 接口实现

实现接口操作返回数据

private dpListener: DPListener = {
  onSessionResult: async (jsonObject: Record<string, Object> | null): Promise<void> => {
// 回调结果, 参考 demo 或者 api 文档
  },
  onSessionStatus: (status: boolean): void => {
// 是否及时返回，可以 loading 操作。 参考 demo
  }
}

日志打印

SDK 提供部分日志，TAG 为 Geetest_DeepKnow。

ErrorCode

及时查看极验输出日志