1.1 API 定位：Android 设备可信身份认证层

Play Integrity API 是 Google 提供的云端验证服务，用于帮助开发者确认应用正运行在未经篡改的 Android 设备上，且由官方渠道分发。它取代了传统的 SafetyNet Attestation API，成为 Android 设备“可信身份”的核心认证层。

1.1.1 核心能力矩阵

1.1.2 与传统 SafetyNet 的对比

1.1.3 工作原理总览

下图展示了 Play Integrity API 的完整验证流程及三个核心能力的分布关系：

1.1.4 典型验证响应示例

Play Integrity API 返回的 JSON 包含三个顶层字段，分别对应三大核心能力：

{
  "requestDetails": {
    "requestPackageName": "com.example.app",
    "nonce": "f1a2b3c4d5e6",
    "timestampMillis": "1700000000000"
  },
  "appIntegrity": {
    "appRecognitionVerdict": "PLAY_RECOGNIZED",
    "packageName": "com.example.app",
    "certificateSha256Digest": ["..."],
    "versionCode": 123
  },
  "deviceIntegrity": {
    "deviceRecognitionVerdict": ["MEETS_DEVICE_INTEGRITY"],
    "deviceAttributes": {
      "hasBootloaderUnlock": false,
      "hasRoot": false
    }
  },
  "accountDetails": {
    "appLicensingVerdict": "LICENSED"
  }
}

1.1.5 开发者决策流程

1. 检查设备完整性：若 deviceIntegrity.deviceRecognitionVerdict 包含 MEETS_DEVICE_INTEGRITY，则通过；否则拒绝高风险操作。
2. 检查应用完整性：若 appIntegrity.appRecognitionVerdict 为 PLAY_RECOGNIZED，则确认应用未被篡改。
3. 检查用户许可：若 accountDetails.appLicensingVerdict 为 LICENSED，则允许正常使用；UNLICENSED 可引导购买或退出。
4. 综合判定：通常三个条件全部满足才视为“可信”环境，但可根据业务场景放宽（例如仅检查设备和应用，忽略账号许可）。