Perbaikan

Halaman ini menjelaskan cara menangani masalah terkait verdict integritas.

Saat token integritas diminta, Anda memiliki opsi untuk menampilkan dialog Google Play kepada pengguna. Anda dapat menampilkan dialog jika ada satu atau beberapa masalah dengan verdict integritas. Dialog akan ditampilkan di bagian atas aplikasi, dan meminta pengguna untuk menyelesaikan penyebab masalah. Setelah dialog ditutup, Anda dapat memverifikasi bahwa masalah telah diperbaiki dengan mengirim permintaan lain ke Integrity API.

Dialog integritas

GET_LICENSED (Kode Jenis 1)

Masalah verdict

Saat appLicensingVerdict == "UNLICENSED". Artinya, akun pengguna tidak berlisensi. Dengan kata lain, mereka tidak menginstal atau membeli aplikasi tersebut dari Google Play.

Perbaikan

Anda dapat menampilkan dialog GET_LICENSED untuk meminta pengguna menginstal aplikasi Anda dari Google Play. Jika pengguna menyetujui permintaan, akun pengguna akan menjadi berlisensi (appLicensingVerdict == "LICENSED"). Aplikasi ditambahkan ke koleksi Google Play pengguna dan Google Play dapat mengirimkan update aplikasi atas nama Anda.

Contoh UX

Meminta dialog integritas

Saat klien meminta token integritas, Anda dapat menggunakan metode yang ditawarkan dalamStandardIntegrityToken (API Standar) dan IntegrityTokenResponse (API Klasik): showDialog(Activity activity, int integrityDialogTypeCode).

Langkah-langkah berikut menguraikan cara menggunakan Play Integrity API untuk menampilkan dialog GET_LICENSED:

1. Minta token integritas dari aplikasi Anda, lalu kirim token tersebut ke server Anda. Anda dapat menggunakan permintaan Standar atau Klasik.

   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. Di server, dekripsi token integritas dan periksa kolom appLicensingVerdict. Token akan tampak seperti berikut:

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

3. Jika token berisi appLicensingVerdict: "UNLICENSED", balas klien aplikasi Anda dengan memintanya menampilkan dialog pemberian lisensi:

   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. Di aplikasi Anda, panggil showDialog dengan kode yang diminta yang diambil dari server Anda:

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

5. Dialog ditampilkan di atas aktivitas yang disediakan. Saat pengguna menutup dialog, Tugas akan selesai dengan kode respons.

6. (Opsional) Minta token lain untuk menampilkan dialog lebih lanjut. Jika membuat permintaan standar, Anda harus melakukan persiapan ulang penyedia token untuk mendapatkan verdict baru.