秒验HarmonyOS NEXT集成指南

开发工具：DevEco Studio

集成方式：在线集成

HarmonyOS API支持：>= 12

集成前准备

注册账号

使用MobSDK之前，需要先在MobTech官网注册开发者账号，并获取MobTech提供的AppKey和AppSecret，详情可以点击查看注册流程

提交审核

一键登录是运营商提供的能力，在使用秒验SDK之前，您需要在Mob开发者后台提交秒验审核，详情可以点击查看秒验审核流程

秒验SDK流程图

集成配置

添加依赖

在Terminal窗口中，执行如下命令进行安装

ohpm install @mobsdk/mobcore
ohpm install @mobsdk/secverify

HSP支持

在项目级的build-profile.json5中添加如下 buildOption 代码块

{
  "app": {
    "products": [
      {
        "name": "xxxxx",
        "signingConfig": "xxxxx",
        "compatibleSdkVersion": "5.0.0(12)",
        "runtimeOS": "HarmonyOS",
        "buildOption":{
          "strictMode":{
            "useNormalizedOHMUrl":true
          }
        }
      },
    ]
  },
}

权限配置

MobSDK需要 INTERNET 和 GET_NETWORK_INFO 权限才可正常使用，请在工程中entry模块的 module.json5文件中，新增 requestPermissions，如下所示：

"module": {
    "name": "xxx",
    "type": "entry",
    "description": "xxx",
    "mainElement": "xxx",
    "deviceTypes": [],
    "pages": "xxx",
    "abilities": [],
    // 配置如下
    "requestPermissions":[
      {
        "name": "ohos.permission.INTERNET"
      },
      {
        "name": "ohos.permission.GET_NETWORK_INFO"
      }
    ]
}

方法调用

使用MobSDK前，需调用以下代码初始化 MobSDK，该方法务必在使用SDK功能之前调用

MobSDK.init(context, "您的AppKey", "您的AppSecret")

为保证您的App在集成MobSDK之后能够满足工信部相关合规要求，您应确保App安装首次冷启动且取得用户阅读您《隐私政策》授权之后，调用 MobSDK.submitPolicyGrantResult回传隐私协议授权结果。

反之，如果用户不同意您App《隐私政策》授权，则不能调用 MobSDK.submitPolicyGrantResult回传隐私协议授权结果。 请参考秒验SDK隐私政策

• 通用方案

// isGranted 为true表示接受隐私政策
MobSDK.submitPolicyGrantResult(isGranted);

• 增加App数据采集主动控制器方案

// isGranted 为true表示接受隐私政策
// mcc 是App数据采集主动控制器的子类
MobSDK.submitPolicyGrantResult(isGranted, mcc);

示例代码

注：submitPolicyGrantResult是MobSDK的业务起点。调用位置开发者可以自己指定，只需在使用SDK功能之前调用即可，强烈建议开发者在终端用户点击应用隐私协议弹窗同意按钮后调用。

App数据采集主动控制器用来限制MobSDK采集并提供可选的数据维度和扩展功能。因相关信息的不收集将会对其对应的功能造成影响，请开发者结合业务实际需要进行合理配置。秒验SDK扩展业务功能设置可参考链接 ，其它App数据采集主动控制器的配置方法可参考链接。

MobSDK.init(context, "您的AppKey", "您的AppSecret")
export class MyCustomController extends MobCustomController {
  // TODO 重写控制器
}
MobSDK.submitPolicyGrantResult(true, new MyCustomController());

或者

MobSDK.init(context, "您的AppKey", "您的AppSecret")
MobSDK.submitPolicyGrantResult(true);

至此，秒验SDK已经集成完毕，可以参考其他文档继续使用秒验SDK的其他功能。