Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji za pomocą Kotlina lub Javy. Jeśli używasz kodu natywnego, Unity lub Unreal Engine, skorzystaj z osobnych przewodników po integracji.
Konfigurowanie środowiska programistycznego
Biblioteka opinii w aplikacji w Google Play jest częścią podstawowych bibliotek Google Play. Aby zintegrować bibliotekę opinii w aplikacji w Google Play, dodaj te zależności Gradle.
Dynamiczny
// 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 obiektu ReviewManager
ReviewManager to interfejs, który umożliwia aplikacji rozpoczęcie procesu wystawiania oceny w aplikacji. Możesz go uzyskać, tworząc instancję za pomocą ReviewManagerFactory.
Kotlin
val manager = ReviewManagerFactory.create(context)
Java
ReviewManager manager = ReviewManagerFactory.create(context)
Przesyłanie żądania obiektu ReviewInfo
Postępuj zgodnie z wytycznymi dotyczącymi momentów, w których warto prosić o opinie w aplikacji, aby określić odpowiednie punkty w wzorcu przeglądania aplikacji, w których można poprosić użytkownika o opinię (np. gdy użytkownik ukończy poziom w grze). Gdy aplikacja osiągnie jeden z tych punktów, użyj instancji ReviewManager, aby utworzyć zadanie żądania. Jeśli operacja się powiedzie, interfejs API zwróci obiekt ReviewInfo potrzebny do rozpoczęcia procesu wystawiania opinii w aplikacji.
Kotlin
val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
if (task.isSuccessful) {
// 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()) {
// 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 wystawiania opinii w aplikacji
Użyj instancji ReviewInfo, aby uruchomić proces wystawiania opinii w aplikacji. Zanim aplikacja powróci do normalnego wzorca przeglądania (np. przejdzie do następnego poziomu), poczekaj, aż użytkownik zakończy proces dodawania opinii w aplikacji.
Kotlin
val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
// The flow has finished. The API doesn't indicate whether the user
// reviewed or not, or even whether the review dialog was shown. Thus, no
// matter the result, continue your app flow.
}
Java
Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
// The flow has finished. The API doesn't indicate whether the user
// reviewed or not, or even whether the review dialog was shown. Thus, no
// matter the result, continue your app flow.
});
Dalsze kroki
Przetestuj proces opinii w aplikacji, aby sprawdzić, czy integracja działa prawidłowo.