修復

本頁面說明如何處理完整性判定結果的問題。

在要求提供完整性權杖時，您可以選擇向使用者顯示 Google Play 對話方塊。如果完整性判定結果出現一或多個問題，您就可以顯示這個對話方塊。對話方塊會顯示在應用程式頂端，並提示使用者解決問題。對話方塊關閉後，您可以向 Integrity API 提出另一項要求，驗證問題是否已修正。

注意：無論完整性權杖的內容為何，可向使用者顯示的完整性對話方塊類型都沒有硬性規定。您應檢查伺服器上的完整性權杖內容，藉此判斷應顯示哪種對話方塊。

完整性對話方塊

GET_LICENSED (類型代碼 1)

判定結果問題

發生 appLicensingVerdict == "UNLICENSED" 的情形。這表示使用者帳戶未經授權。也就是說，他們不是從 Google Play 安裝或購買應用程式。

修復

您可以顯示 GET_LICENSED 對話方塊，提示使用者利用 Google Play 取得應用程式。如果使用者接受，使用者帳戶就會獲得授權 (appLicensingVerdict == "LICENSED")。系統會將應用程式新增至使用者的 Google Play 程式庫，而 Google Play 可代您提供應用程式更新。

使用者體驗範例

CLOSE_UNKNOWN_ACCESS_RISK (類型代碼 2)

判定結果問題

如果 environmentDetails.appAccessRiskVerdict.appsDetected 包含 "UNKNOWN_CAPTURING" 或 "UNKNOWN_CONTROLLING"，表示裝置上有不明應用程式正在執行，可能會擷取螢幕畫面或控制裝置。

修復

您可以顯示 CLOSE_UNKNOWN_ACCESS_RISK 對話方塊，提示使用者關閉所有可能擷取螢幕或控制裝置的不明應用程式。如果使用者輕觸 Close all 按鈕，系統會關閉所有這類應用程式。

使用者體驗範例

CLOSE_ALL_ACCESS_RISK (類型代碼 3)

判定結果問題

如果 environmentDetails.appAccessRiskVerdict.appsDetected 包含 "KNOWN_CAPTURING"、"KNOWN_CONTROLLING"、"UNKNOWN_CAPTURING" 或 "UNKNOWN_CONTROLLING" 中的任何項目，表示裝置上有執行中的應用程式，可能會擷取螢幕畫面或控制裝置。

修復

您可以顯示 CLOSE_ALL_ACCESS_RISK 對話方塊，提示使用者關閉所有可能擷取螢幕畫面或控制裝置的應用程式。如果使用者輕觸 Close all 按鈕，裝置上的所有這類應用程式都會關閉。

使用者體驗範例

要求完整性對話方塊

當用戶端要求完整性權杖時，您可以使用 StandardIntegrityToken (標準 API) 和 IntegrityTokenResponse (傳統 API) 中提供的方法： showDialog(Activity activity, int integrityDialogTypeCode)。

注意： 如要使用完整性對話方塊，您必須使用 Integrity API Android 程式庫 1.3.0 以上版本。Unity 外掛程式尚未支援此功能。

下列步驟概述如何使用 Play Integrity API 顯示「GET_LICENSED」對話方塊：

1. 透過應用程式要求完整性權杖，然後將權杖傳送至伺服器。使用「標準」或「傳統」要求都可以。

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

   原生

   /// 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));

2. 在伺服器上解密完整性權杖，然後檢查 appLicensingVerdict 欄位。如下所示：

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

3. 如果權杖包含 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;
   } 

   原生

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

4. 從伺服器擷取要求的程式碼後，在應用程式中使用該程式碼呼叫 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.
   } 

   原生

   // 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.
   }

5. 對話方塊會顯示在系統提供的活動頂端。使用者關閉對話方塊後，工作就會完成，並顯示回應代碼。

6. (選用) 要求其他權杖，以便顯示任何後續對話方塊。如果您提出標準要求，需再次替權杖供應工具暖機，才能取得最新判定結果。