开发工具: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的其他功能。