Play Integrity API:应用访问风险抢先体验计划 (EAP)

应用访问风险信号会告知您的应用是否有正在运行的其他应用 用于截取屏幕、显示叠加层或控制设备。接收者 在您的应用中使用应用访问风险信号,请在 Integrity 中开启应用访问风险信号 的 API 响应部分,然后按照文档中的说明操作 应用访问风险判定结果 (Beta 版) 了解如何读取返回的判定结果。

此页面上的信息仅适用于已开始发出请求的应用 在抢先体验计划的前几个月内收到应用访问风险判定结果。这些应用 应用访问权限中会暂时继续收到一些已弃用的字段 以及 appsDetected 字段。如果您的应用属于 ,请参阅下一部分,了解如何迁移到 新的判定格式。

从旧的应用访问风险判定结果格式迁移

在 2024 年 4 月底之前加入应用访问风险信号 EAP 的应用将 应用访问风险判定结果中会暂时收到三个字段,即 appsDetected(如应用访问风险判定结果中所述) (Beta 版)和 两个已弃用的字段 playOrSystemAppsotherApps

appAccessRiskVerdict: {
    // This field can be INSTALLED, CAPTURING, CONTROLLING or UNEVALUATED.
    playOrSystemApps: "INSTALLED"
    // This field can be NOT_INSTALLED, INSTALLED, CAPTURING, CONTROLLING or UNEVALUATED.
    otherApps: "CAPTURING"
    // This field contains one or more of the eight possible responses.
    appsDetected: ["KNOWN_INSTALLED", "UNKNOWN_INSTALLED", "UNKNOWN_CAPTURING"]
}

如果未评估应用访问风险,以下应用将收到判定结果:

appAccessRiskVerdict: {
    playOrSystemApps: "UNEVALUATED"
    otherApps: "UNEVALUATED"
}

为了帮助您从使用 playOrSystemAppsotherApps 字段迁移到 新字段 appsDetected,下表概述了 这些字段

旧字段名称 旧字段值 对应的 appsDetected 回答
playOrSystemApps INSTALLED KNOWN_INSTALLED
CAPTURING KNOWN_INSTALLED, KNOWN_CAPTURING
CONTROLLING KNOWN_INSTALLED, KNOWN_CONTROLLING
如果存在以下情况,系统也可能会返回响应 KNOWN_CAPTURING: 除了控制 Play 之外,捕获 Google Play 应用或系统应用正在运行 或系统应用
UNEVALUATED 判定结果中不包含 appsDetected
otherApps NOT_INSTALLED 不返回任何 UNKNOWN_ 响应。
INSTALLED UNKNOWN_INSTALLED
CAPTURING UNKNOWN_INSTALLED, UNKNOWN_CAPTURING
CONTROLLING UNKNOWN_INSTALLED, UNKNOWN_CONTROLLING
如果存在以下情况,系统也可能会返回响应 UNKNOWN_CAPTURING: 除了控制其他应用以外,捕获其他应用的数据
UNEVALUATED 判定结果中不包含 appsDetected

请注意,运行可能会显示叠加层的应用以前检测不到 应用访问风险信号。因此,叠加层仅在新的 appsDetected 个回复,且不在playOrSystemAppsotherApps中 字段。

在移除这些字段之前,我们会与受影响应用的开发者联系 playOrSystemAppsotherApps