跳到主要内容

模拟点击检测

场景介绍​

从6.0.0(20) 版本开始，新增支持模拟点击检测。

应用通过调用Device Security Kit的detectSimulatedClickRisk接口，获取模拟点击检测结果，用于自动化点击、设备墙等作弊行为检测。

应用可以根据检测结果评估如何进行业务操作。

约束与限制​

每30秒最多可以调用10次，每个应用在每个设备上每天最多可以调用20次。

业务流程​

流程说明：

  1. 开发者应用调用detectSimulatedClickRisk接口，发起模拟点击检测请求。

    Device Security Kit收到请求后，首先采集当前设备模拟点击线索数据，然后将线索数据发送到Device Security服务器做检测，最后通过detectSimulatedClickRisk接口的返回值将检测结果传递给开发者应用。

  2. 获取检测结果，并根据结果做出相应处理。

接口说明​

以下是模拟点击检测相关接口，更多接口及使用方法请参见API参考。

接口名描述
detectSimulatedClickRisk(params: SimulatedClickDetectionRequest): Promise<string>模拟点击检测。

开发步骤​

  1. 导入Device Security Kit模块及相关公共模块。

    import { businessRiskIntelligentDetection } from '@kit.DeviceSecurityKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';

  2. 调用detectSimulatedClickRisk接口获取模拟点击检测结果。

    const TAG = "BusinessRiskIntelligentDetectionJsTest";

    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);
      }).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);
      });
    } 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);
    }

  3. 开发者应用可以根据模拟点击检测结果进行业务处理。

    模拟点击检测结果是一个格式为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未知。未检测到明显特征，无法识别。