בדף הזה מוסבר איך לטפל בבעיות שקשורות להחלטות לגבי תקינות.
כשמתבצע בקשה לאסימון תקינות, יש לכם אפשרות להציג למשתמש תיבת דו-שיח של 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 (Standard API) וב-IntegrityTokenResponse (Classic 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);
מותאמת
/// 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; }
מותאמת
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. }
מותאמת
// 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. }
תיבת הדו-שיח מוצגת מעל הפעילות שצוינה. כשהמשתמש סוגר את תיבת הדו-שיח, המשימה מסתיימת עם קוד תגובה.
(אופציונלי) מבקשים אסימון נוסף כדי להציג תיבת דו-שיח נוספת. אם שולחים בקשות רגילות, צריך לחמם שוב את ספק האסימונים כדי לקבל החלטה חדשה.