Google I/O 2025 新增功能：使用设备召回功能（Beta 版），在保护用户隐私的同时，检测和防止重复滥用行为以及您指定的其他操作。

补救对话框

本页面介绍了如何处理完整性判断问题。

请求完整性令牌时，您可以选择向用户显示 Google Play 对话框。当完整性判断存在一个或多个问题时，您可以显示对话框。对话框显示在您的应用顶部，并提示用户解决导致问题的原因。对话框关闭后，您可以通过向 Integrity API 发送另一个请求来验证问题是否已解决。

请求完整性对话框

当客户端请求完整性令牌时，您可以使用 StandardIntegrityToken（标准 API）和 IntegrityTokenResponse（经典 API）中提供的方法：showDialog(Activity activity, int integrityDialogTypeCode)。

以下步骤概述了如何使用 Play Integrity API 通过 GET_LICENSED 对话框代码显示补救对话框。本节之后列出了您的应用可以请求的其他对话框代码。

从您的应用请求完整性令牌，并将令牌发送到您的服务器。您可以使用标准请求或经典请求。

Kotlin

// Request an integrity token
val tokenResponse: StandardIntegrityToken = requestIntegrityToken()
// Send token to app server and get response on what to do next
val yourServerResponse: YourServerResponse = sendToServer(tokenResponse.token())

Java

// Request an integrity token
StandardIntegrityToken tokenResponse = requestIntegrityToken();
// Send token to app server and get response on what to do next
YourServerResponse yourServerResponse = sendToServer(tokenResponse.token());

Unity

// Request an integrity token
StandardIntegrityToken tokenResponse = RequestIntegrityToken();
// Send token to app server and get response on what to do next
YourServerResponse yourServerResponse = sendToServer(tokenResponse.Token);

Unreal Engine

// Request an integrity token
StandardIntegrityToken* Response = RequestIntegrityToken();
// Send token to app server and get response on what to do next
YourServerResponse YourServerResponse = SendToServer(Response->Token);

原生

/// Request an integrity token
StandardIntegrityToken* response = requestIntegrityToken();
/// Send token to app server and get response on what to do next
YourServerResponse yourServerResponse = sendToServer(StandardIntegrityToken_getToken(response));

在您的服务器上，解密完整性令牌并检查 appLicensingVerdict 字段。它可能看起来像这样

// Licensing issue
{
  ...
  accountDetails: {
      appLicensingVerdict: "UNLICENSED"
  }
}

如果令牌包含 appLicensingVerdict: "UNLICENSED"，回复您的应用客户端，请求其显示许可对话框

Kotlin

private fun getDialogTypeCode(integrityToken: String): Int{
  // Get licensing verdict from decrypted and verified integritytoken
  val licensingVerdict: String = getLicensingVerdictFromDecryptedToken(integrityToken)

  return if (licensingVerdict == "UNLICENSED") {
          1 // GET_LICENSED
      } else 0
}

Java

private int getDialogTypeCode(String integrityToken) {
  // Get licensing verdict from decrypted and verified integrityToken
  String licensingVerdict = getLicensingVerdictFromDecryptedToken(integrityToken);

  if (licensingVerdict.equals("UNLICENSED")) {
    return 1; // GET_LICENSED
  }
  return 0;
}

Unity

private int GetDialogTypeCode(string IntegrityToken) {
  // Get licensing verdict from decrypted and verified integrityToken
  string licensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken);

  if (licensingVerdict == "UNLICENSED") {
    return 1; // GET_LICENSED
  }
  return 0;
}

Unreal Engine

private int GetDialogTypeCode(FString IntegrityToken) {
  // Get licensing verdict from decrypted and verified integrityToken
  FString LicensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken);

  if (LicensingVerdict == "UNLICENSED") {
    return 1; // GET_LICENSED
  }
  return 0;
}

原生

private int getDialogTypeCode(string integrity_token) {
  /// Get licensing verdict from decrypted and verified integrityToken
  string licensing_verdict = getLicensingVerdictFromDecryptedToken(integrity_token);

  if (licensing_verdict == "UNLICENSED") {
    return 1; // GET_LICENSED
  }
  return 0;
}

在您的应用中，调用 showDialog 并传入从服务器获取的请求代码

Kotlin

// Show dialog as indicated by the server
val showDialogType: Int? = yourServerResponse.integrityDialogTypeCode()
if (showDialogType != null) {
  // Call showDialog with type code, the dialog will be shown on top of the
  // provided activity and complete when the dialog is closed.
  val integrityDialogResponseCode: Task<Int> =
  tokenResponse.showDialog(activity, showDialogType)
  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

Java

// Show dialog as indicated by the server
@Nullable Integer showDialogType = yourServerResponse.integrityDialogTypeCode();
if (showDialogType != null) {
  // Call showDialog with type code, the dialog will be shown on top of the
  // provided activity and complete when the dialog is closed.
  Task<Integer> integrityDialogResponseCode =
      tokenResponse.showDialog(activity, showDialogType);
  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

Unity

IEnumerator ShowDialogCoroutine() {
  int showDialogType = yourServerResponse.IntegrityDialogTypeCode();

  // Call showDialog with type code, the dialog will be shown on top of the
  // provided activity and complete when the dialog is closed.
  var showDialogTask = tokenResponse.ShowDialog(showDialogType);

  // Wait for PlayAsyncOperation to complete.
  yield return showDialogTask;

  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

Unreal Engine

// .h
void MyClass::OnShowDialogCompleted(
  EStandardIntegrityErrorCode Error,
  EIntegrityDialogResponseCode Response)
{
  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

// .cpp
void MyClass::RequestIntegrityToken()
{
  UStandardIntegrityToken* Response = ...
  int TypeCode = YourServerResponse.integrityDialogTypeCode();

  // Create a delegate to bind the callback function.
  FShowDialogStandardOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnShowDialogCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnShowDialogCompleted);

  // Call ShowDialog with TypeCode which completes when the dialog is closed.
  Response->ShowDialog(TypeCode, Delegate);
}

原生

// Show dialog as indicated by the server
int show_dialog_type = yourServerResponse.integrityDialogTypeCode();
if (show_dialog_type != 0) {
  /// Call showDialog with type code, the dialog will be shown on top of the
  /// provided activity and complete when the dialog is closed.
  StandardIntegrityErrorCode error_code =
      IntegrityTokenResponse_showDialog(response, activity, show_dialog_type);

  /// Proceed to polling iff error_code == STANDARD_INTEGRITY_NO_ERROR
  if (error_code != STANDARD_INTEGRITY_NO_ERROR)
  {
      /// Remember to call the *_destroy() functions.
      return;
  }

  /// Use polling to wait for the async operation to complete.
  /// Note, the polling shouldn't block the thread where the IntegrityManager
  /// is running.

  IntegrityDialogResponseCode* response_code;
  error_code = StandardIntegrityToken_getDialogResponseCode(response, response_code);

  if (error_code != STANDARD_INTEGRITY_NO_ERROR)
  {
      /// Remember to call the *_destroy() functions.
      return;
  }

  /// Handle response code, call the Integrity API again to confirm that
  /// verdicts have been resolved.
}

该任务会以响应代码完成。
（可选）请求另一个令牌以显示任何进一步的对话框。如果您发出标准请求，您需要再次预热令牌提供程序以获取新的判断。

完整性对话框代码

GET_LICENSED（类型代码 1）

判断问题

当 appLicensingVerdict == "UNLICENSED" 时。这意味着用户账号未获得许可。换句话说，他们并非通过 Google Play 安装或购买了此应用。

补救措施

您可以显示 GET_LICENSED 对话框，提示用户从 Google Play 获取您的应用。如果用户接受，则该用户账号将获得许可（appLicensingVerdict == "LICENSED"）。该应用会添加到用户的 Google Play 库中，Google Play 可以代表您提供应用更新。

示例用户体验

GET_LICENSED Play dialog

CLOSE_UNKNOWN_ACCESS_RISK（类型代码 2）

判断问题

当 environmentDetails.appAccessRiskVerdict.appsDetected 包含 "UNKNOWN_CAPTURING" 或 "UNKNOWN_CONTROLLING" 时，表示设备上运行着一些未知应用，它们可能正在捕获屏幕或控制设备。

补救措施

您可以显示 CLOSE_UNKNOWN_ACCESS_RISK 对话框，提示用户关闭所有可能正在捕获屏幕或控制设备的未知应用。如果用户点按 Close all 按钮，所有此类应用都将被关闭。

示例用户体验

Dialog for close unknown access risk

CLOSE_ALL_ACCESS_RISK（类型代码 3）

判断问题

当 environmentDetails.appAccessRiskVerdict.appsDetected 包含 "KNOWN_CAPTURING"、"KNOWN_CONTROLLING"、"UNKNOWN_CAPTURING" 或 "UNKNOWN_CONTROLLING" 中的任何一个时，表示设备上运行着一些应用，它们可能正在捕获屏幕或控制设备。

补救措施

您可以显示 CLOSE_ALL_ACCESS_RISK 对话框，提示用户关闭所有可能正在捕获屏幕或控制设备的应用。如果用户点按 Close all 按钮，所有此类应用都将在设备上关闭。

示例用户体验

Dialog for close all access risk

处理错误代码

其他工具和支持

补救对话框 利用收藏功能保持井然有序 根据您的偏好保存内容并进行分类。

请求完整性对话框

Kotlin

Java

Unity

Unreal Engine

原生

Kotlin

Java

Unity

Unreal Engine

原生

Kotlin

Java

Unity

Unreal Engine

原生

完整性对话框代码

GET_LICENSED（类型代码 1）

判断问题

补救措施

示例用户体验

CLOSE_UNKNOWN_ACCESS_RISK（类型代码 2）

判断问题

补救措施

示例用户体验

CLOSE_ALL_ACCESS_RISK（类型代码 3）

判断问题

补救措施

示例用户体验

补救对话框