从6.0.0(20) 版本开始,新增支持模拟点击检测。
应用通过调用Device Security Kit的detectSimulatedClickRisk接口,获取模拟点击检测结果,用于检测自动化点击、设备农场等作弊行为。
应用可以根据检测结果评估如何进行业务操作。

流程说明:
开发者应用调用detectSimulatedClickRisk接口,发起模拟点击检测请求。
Device Security Kit收到请求后,首先采集当前设备模拟点击线索数据,然后将线索数据发送到Device Security服务器做检测,最后通过detectSimulatedClickRisk接口的返回值将检测结果传递给开发者应用。
获取检测结果,并根据结果做出相应处理。
以下是模拟点击检测相关接口,更多接口及使用方法请参见API参考。
| 接口名 | 描述 |
|---|---|
| detectSimulatedClickRisk(params: SimulatedClickDetectionRequest): Promise<string> | 模拟点击检测。 |
导入Device Security Kit模块及相关公共模块。
import { hilog } from '@kit.PerformanceAnalysisKit';
import { businessRiskIntelligentDetection } from '@kit.DeviceSecurityKit';
import { BusinessError } from '@kit.BasicServicesKit'; 调用detectSimulatedClickRisk接口获取模拟点击检测结果。
const TAG: string = '[SimulatedClickRiskDetectModel]';
function simulatedClickRiskDetectPromise(): Promise<String> {
return new Promise(async (resolve: Function, reject: Function) => {
let params = {
version: 1
} as businessRiskIntelligentDetection.SimulatedClickDetectionRequest;
try {
hilog.info(0x0000, TAG, 'Detect simulated click risk begin.');
businessRiskIntelligentDetection.detectSimulatedClickRisk(params).then((result: string) => {
hilog.info(0x0000, TAG, 'Detect simulated click risk success: %{public}s', result);
resolve(result);
}).catch((error: Error) => {
let e: BusinessError = error as BusinessError;
hilog.error(0x0000, TAG, 'Detect simulated click risk failed: %{public}d %{public}s', e.code, e.message);
reject(error);
});
} catch (error) {
let e: BusinessError = error as BusinessError;
hilog.error(0x0000, TAG, 'Detect simulated click risk failed: %{public}d %{public}s', e.code, e.message);
reject(error);
}
});
} 开发者应用可以根据模拟点击检测结果进行业务处理。
模拟点击检测结果是一个格式为JSON格式的字符串,内容示例如下
{
"timestampMs": 9860437986543,
"version": 1,
"riskDecision": "fake",
"tags": ["AbnormalTap"]
}
timestampMs:发起请求时生成的时间戳。
riskDecision:风险检测结果。
version:检测结果消息格式的版本。默认值为1,当前只支持1。
tags:模拟点击关键特征。如果tags列表为空,表示未发现关键特征。如果tags列表不为空,表示发现关键特征。
| tags值 | 含义 |
|---|---|
| AbnormalDeviceIntegrity | 设备完整性遭到破坏。 |
| AbnormalDeviceBehavior | 设备行为异常,例如,设备连接状态、传感器状态等行为异常。 |
| AbnormalTap | 存在异常点击行为,例如,点击事件注入,自动化点击等。 |
| riskDecision值 | 含义 |
|---|---|
| fake | 当前设备存在作弊风险行为。详情见上方tags表格。 |
| likelyReal | 当前操作设备的是真人用户的可能性较高。 |
| unknown | 未知。未检测到明显特征,无法识别。 |