秒验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的其他功能。