@capacitor-community/play-integrity

中文文档
8.0.0发布于 2025/12/26MITTypeScriptESM + CJS零依赖近 30 天下载 1.4万

播放完整性 API 的电容插件

中文使用文档
文档目录10 节
  1. 演艺圈
  2. 安装
  3. 使用量
  4. 机器人
  5. 变量
  6. API 密码
  7. 请求集成托肯(...)
  8. 错误
  9. 完整性 API 不可用
  10. 未找到播放服务


演艺圈

@capacitor-community/play-integrity


Play Guide API 用于校验您的应用程序是Genuine App 二进制,与 Play Store 上可用的设备相比没有修改过. 它验证了当前用户账户持有许可(安装或支付您的应用程序的用户),以及该应用程序是否没有已知的恶意软件.

此插件称为 Play 完整性 API requestIntegrityToken 返回您 App 服务器必须使用 Google Play 服务器校验的符号的方法 .

电话 requestIntegrityToken 将返回 a token 用于验证。 见 Google的文档对此。 。 。 .

安装

npm install @capacitor-community/play-integrity
npx cap sync

使用量

import { PlayIntegrity } from '@capacitor-community/play-integrity';
...
try {
      // Nonce: See https://developer.android.com/google/play/integrity/classic
      // googleCloudProjectNumber: leave as 0 for the default for the application
      // or get from https://console.firebase.google.com/ Project Settings > General
      const result = await PlayIntegrity.requestIntegrityToken({
        nonce: nonce,
        googleCloudProjectNumber: 0
      });
      // Use result.token and decrypt and verify the integrity verdict
      // https://developer.android.com/google/play/integrity/classic#decrypt-verify
      console.log(`Play Integrity Result`, result);
    } catch (err) {
        // Recommendation: Report to backend and exit the application
    }

机器人

变量

此插件将使用以下工程变量( 在您的应用程序中定义) variables.gradle 文件名 :

  • googlePlayIntegrityVersion页:1 com.google.android.play:integrity (默认 : 1.6.0(中文(简体) )

API 密码

请求集成托肯(...)

requestIntegrityToken(options: { nonce: string; googleCloudProjectNumber: number; }) => Promise<{ token: string; }>
参数类型
options{ nonce: string; googleCloudProjectNumber: number; }

回返情况: Promise<{ token: string; }>


错误

下列出错可以发生,应当处理.

完整性 API 不可用

Error: -1: Integrity API error (-1): Integrity API is not available.
Integrity API is not enabled, or the Play Store version might be old.
Recommended actions:
1) Make sure that Integrity API is enabled in Google Play Console.
2) Ask the user to update Play Store.
 (https://developer.android.com/google/play/integrity/reference/com/google/android/play/core/integrity/model/IntegrityErrorCode.html#API_NOT_AVAILABLE).

未找到播放服务

Play Services not found

版本与发布记录

@capacitor-community/play-integrity 共发布 7 个版本,首次发布于 2024/01/16;过去 12 个月发布了 1 个版本。

版本发布日期距今
8.0.0latest2025/12/2610 个月前
7.1.02025/10/231 年前
7.0.02025/02/171.7 年前
6.0.02024/04/172 年前
5.0.02024/01/162 年前
0.0.22024/01/162 年前

关于 @capacitor-community/play-integrity 的常见问题

@capacitor-community/play-integrity 是什么?

播放完整性 API 的电容插件

如何安装 @capacitor-community/play-integrity?

在项目目录运行 npm install @capacitor-community/play-integrity,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capacitor-community/play-integrity 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capacitor-community/play-integrity 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capacitor-community/play-integrity 可以商用吗?

@capacitor-community/play-integrity 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@capacitor-community/play-integrity 的下载量有多少?

根据 npm 官方下载统计,@capacitor-community/play-integrity 在 2026/10/09 – 2026/11/07 这 30 天内被下载 13,645 次,日均约 455 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capacitor-community/play-integrity 还在维护吗?

最新版本 8.0.0 发布于 2025/12/26(10 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 1 个;首次发布于 2024/01/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。