תיקון שגיאות

בדף הזה נסביר איך לטפל בבעיות שקשורות להחלטות לגבי תקינות.

כשמתבצע בקשה לאסימון תקינות, יש לכם אפשרות להציג למשתמש תיבת דו-שיח של Google Play. תיבת הדו-שיח עשויה להופיע אם יש בעיה אחת או יותר בבדיקה של תקינות הקוד. תיבת הדו-שיח מוצגת מעל האפליקציה, ומבקשת מהמשתמשים לפתור את הבעיה. אחרי שתיבת הדו-שיח תיסגר, תוכלו לשלוח בקשה נוספת ל-Integrity API כדי לוודא שהבעיה נפתרה.

תיבות דו-שיח בנושא תקינות

GET_LICENSED (קוד סוג 1)

בעיה בתוצאה

כש-appLicensingVerdict == "UNLICENSED". המשמעות היא שחשבון המשתמש לא ברישיון. במילים אחרות, הם לא התקינו או קנו את האפליקציה מ-Google Play.

תיקון

אפשר להציג את תיבת הדו-שיח GET_LICENSED כדי לבקש מהמשתמש להוריד את האפליקציה מ-Google Play. אם המשתמש יאשר, חשבון המשתמש יקבל רישיון (appLicensingVerdict == "LICENSED"). האפליקציה תתווסף לספרייה של המשתמש ב-Google Play, ו-Google Play תוכל לשלוח עדכוני אפליקציה בשמכם.

דוגמה לחוויית משתמש

תיבת הדו-שיח של Play עם GET_LICENSED

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 (Standard API) וב-IntegrityTokenResponse (Classic API):‏showDialog(Activity activity, int integrityDialogTypeCode).

השלבים הבאים מתארים איך משתמשים ב-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);

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

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

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

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

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

  5. תיבת הדו-שיח מוצגת מעל הפעילות שצוינה. כשהמשתמש סוגר את תיבת הדו-שיח, המשימה מסתיימת עם קוד תגובה.

  6. (אופציונלי) מבקשים אסימון נוסף כדי להציג תיבת דו-שיח נוספת. אם אתם שולחים בקשות רגילות, תצטרכו לחמם מחדש את ספק האסימונים כדי לקבל שוב את פסק הדין.

הקודם
טיפול בקודי שגיאות
הבא
כלים נוספים ותמיכה