Integracja opinii w aplikacji (kotlin lub Java)

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.