Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji za pomocą Kotlina lub Javy. Jeśli używasz kodu natywnych, Unity lub Unreal Engine, dostępne są oddzielne przewodniki integracji.
Konfigurowanie środowiska programistycznego
Biblioteka Play do przeglądania opinii jest częścią podstawowych bibliotek Google Play. Aby zintegrować bibliotekę Play In-App Review Library, dodaj tę zależność Gradle.
Groovy
// In your app's build.gradle file: ... dependencies { // This dependency is downloaded from the Google's Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation 'com.google.android.play:review:2.0.2' // For Kotlin users also add the Kotlin extensions library for Play In-App Review: implementation 'com.google.android.play:review-ktx:2.0.2' ... }
Kotlin
// In your app's build.gradle.kts file: ... dependencies { // This dependency is downloaded from the Google's Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation("com.google.android.play:review:2.0.2") // For Kotlin users also import the Kotlin extensions library for Play In-App Review: implementation("com.google.android.play:review-ktx:2.0.2") ... }
Tworzenie klasy ReviewManager
ReviewManager
to interfejs, który umożliwia aplikacji rozpoczęcie procesu weryfikacji w aplikacji. Uzyskaj go, tworząc instancję za pomocą funkcji ReviewManagerFactory
.
Kotlin
val manager = ReviewManagerFactory.create(context)
Java
ReviewManager manager = ReviewManagerFactory.create(context)
Żądanie obiektu ReviewInfo
Aby określić odpowiednie momenty w przebiegu użytkownika w aplikacji, w których należy poprosić o ocenę, postępuj zgodnie z wskazówkami dotyczącymi proszenia o ocenę w aplikacji. Możesz na przykład poprosić o ocenę, gdy użytkownik kończy poziom w grze. Gdy aplikacja osiągnie jeden z tych punktów, użyj instancji ReviewManager
, aby utworzyć zadanie żądania. W przypadku powodzenia interfejs API zwraca obiekt ReviewInfo
, który jest potrzebny do rozpoczęcia procesu weryfikacji w aplikacji.
Kotlin
val request = manager.requestReviewFlow() request.addOnCompleteListener { task -> if (task.isSuccessful) { // We got the ReviewInfo object val reviewInfo = task.result } else { // There was some problem, log or handle the error code. @ReviewErrorCode val reviewErrorCode = (task.getException() as ReviewException).errorCode } }
Java
ReviewManager manager = ReviewManagerFactory.create(this); Task<ReviewInfo> request = manager.requestReviewFlow(); request.addOnCompleteListener(task -> { if (task.isSuccessful()) { // We can get the ReviewInfo object ReviewInfo reviewInfo = task.getResult(); } else { // There was some problem, log or handle the error code. @ReviewErrorCode int reviewErrorCode = ((ReviewException) task.getException()).getErrorCode(); } });
Uruchamianie procesu weryfikacji w aplikacji
Użyj instancji ReviewInfo
, aby rozpocząć proces sprawdzania w aplikacji. Poczekaj, aż użytkownik ukończy proces weryfikacji w aplikacji, zanim aplikacja wznowi normalny przepływ danych (np. przejście do następnego poziomu).
Kotlin
val flow = manager.launchReviewFlow(activity, reviewInfo) flow.addOnCompleteListener { _ -> // The flow has finished. The API does not indicate whether the user // reviewed or not, or even whether the review dialog was shown. Thus, no // matter the result, we continue our app flow. }
Java
Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo); flow.addOnCompleteListener(task -> { // The flow has finished. The API does not indicate whether the user // reviewed or not, or even whether the review dialog was shown. Thus, no // matter the result, we continue our app flow. });
Dalsze kroki
Sprawdź proces weryfikacji w aplikacji, aby upewnić się, że integracja działa prawidłowo.