การแก้ไข

หน้านี้อธิบายวิธีจัดการปัญหาเกี่ยวกับการตัดสินความสมบูรณ์

เมื่อมีการขอโทเค็นความสมบูรณ์ คุณจะมีตัวเลือกในการแสดงโทเค็น เล่นกล่องโต้ตอบของผู้ใช้ คุณอาจแสดงกล่องโต้ตอบเมื่อมี ด้วยการตัดสินความสมบูรณ์ กล่องโต้ตอบจะแสดงที่ด้านบนของแอป และแจ้งให้ผู้ใช้แก้ไขสาเหตุของปัญหา เมื่อปิดกล่องโต้ตอบแล้ว คุณสามารถยืนยันว่าปัญหาได้รับการแก้ไขแล้วด้วยคำขออื่นที่ส่งไปยังทีม Integrity API

หมายเหตุ: กล่องโต้ตอบความสมบูรณ์ทุกประเภทจะแสดงต่อผู้ใช้ โดยไม่คำนึงถึง เนื้อหาของโทเค็นความสมบูรณ์ คุณควรตรวจสอบเนื้อหาของความสมบูรณ์ โทเค็นบนเซิร์ฟเวอร์ของคุณเพื่อกำหนดว่าควรแสดงกล่องโต้ตอบใด

กล่องโต้ตอบความสมบูรณ์

GET_LICENSED (ประเภทรหัส 1)

ปัญหาคำตัดสิน

เมื่อ appLicensingVerdict == "UNLICENSED" ซึ่งหมายความว่าบัญชีผู้ใช้ ไม่มีใบอนุญาต กล่าวคือ ผู้ใช้ไม่ได้ติดตั้งหรือซื้อแอปจาก Google Play

การแก้ไข

คุณสามารถแสดงกล่องโต้ตอบ GET_LICENSED เพื่อแจ้งให้ผู้ใช้ดาวน์โหลดแอปของคุณ Google Play หากผู้ใช้ยอมรับ บัญชีผู้ใช้จะได้รับอนุญาต (appLicensingVerdict == "LICENSED") มีการเพิ่มแอปลงใน คลัง Play และ Google Play สามารถนำส่งอัปเดตแอปในนามของคุณได้

ตัวอย่าง UX

CLOSE_UNKNOWN_ACCESS_RISK (ประเภทรหัส 2)

ปัญหาคำตัดสิน

เมื่อ environmentDetails.appAccessRiskVerdict.appsDetected มี "UNKNOWN_CAPTURING" หรือ "UNKNOWN_CONTROLLING" หมายความว่าไม่ทราบ แอปที่ทำงานอยู่ในอุปกรณ์ที่สามารถจับภาพหน้าจอ หรือ กำลังควบคุมอุปกรณ์

การแก้ไข

คุณสามารถแสดงกล่องโต้ตอบ CLOSE_UNKNOWN_ACCESS_RISK เพื่อแจ้งให้ผู้ใช้ปิดได้ แอปที่ไม่รู้จักทั้งหมดซึ่งอาจกำลังจับภาพหน้าจอหรือควบคุมอุปกรณ์ หากผู้ใช้แตะปุ่ม Close all แอปดังกล่าวทั้งหมดจะปิดไป

ตัวอย่าง UX

CLOSE_ALL_ACCESS_RISK (ประเภทรหัส 3)

ปัญหาคำตัดสิน

เมื่อ environmentDetails.appAccessRiskVerdict.appsDetected มีรายการใดก็ได้ต่อไปนี้ "KNOWN_CAPTURING", "KNOWN_CONTROLLING","UNKNOWN_CAPTURING" หรือ "UNKNOWN_CONTROLLING" หมายความว่ามีแอปที่ทำงานอยู่ในอุปกรณ์ที่ อาจกำลังจับภาพหน้าจอหรือควบคุมอุปกรณ์อยู่

การแก้ไข

คุณสามารถแสดงกล่องโต้ตอบ CLOSE_ALL_ACCESS_RISK เพื่อแจ้งให้ผู้ใช้ปิดทั้งหมด แอปที่สามารถจับภาพหน้าจอหรือควบคุมอุปกรณ์ได้ หากผู้ใช้แตะปุ่ม Close all แอปทั้งหมดจะปิดไปใน อุปกรณ์

ตัวอย่าง UX

กล่องโต้ตอบขอความสมบูรณ์

เมื่อไคลเอ็นต์ขอโทเค็นความสมบูรณ์ คุณสามารถใช้วิธีการที่มีให้ใน StandardIntegrityToken (API มาตรฐาน) และ IntegrityTokenResponse (API คลาสสิก) showDialog(Activity activity, int integrityDialogTypeCode)

หมายเหตุ: หากต้องการใช้กล่องโต้ตอบความสมบูรณ์ คุณต้องใช้ไลบรารี Android ของ Integrity API รุ่น >= 1.3.0 Play Core Native SDK และ 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());
   

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

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: TaskI<nt >=
       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.
     TaskI<nteger >integrityDialogResponseCode =
         tokenResponse.showDialog(activity, showDialogType);
     // Handle response code, call the Integrity API again to confirm that
     // verdicts have been resolved.
   }
   

5. กล่องโต้ตอบจะแสดงทับกิจกรรมที่ให้ไว้ เมื่อผู้ใช้มี ปิดกล่องโต้ตอบ งานจะมีรหัสการตอบกลับเสร็จสมบูรณ์

6. (ไม่บังคับ) ขอโทเค็นอื่นเพื่อแสดงกล่องโต้ตอบเพิ่มเติม หากคุณให้ คำขอมาตรฐาน คุณจะต้องเตรียมความพร้อม ผู้ให้บริการโทเค็นอีกครั้งเพื่อรับผลการตัดสินใหม่