Integracja opinii w aplikacji (Unity)

Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji za pomocą Unity. Jeśli używasz języka Kotlin lub Java albo kodu natywnego, dostępne są osobne przewodniki po integracji.

Omówienie pakietu SDK Unity

Interfejs Play In-App Review API należy do pakietu Play Core SDK. Interfejs API dla Unity udostępnia klasę ReviewManager, która służy do wysyłania żądań i uruchamiania przepływu za pomocą metod RequestReviewFlow i LaunchReviewFlow. Po wysłaniu prośby aplikacja może sprawdzić jej stan za pomocą narzędzia ReviewErrorCode.

Konfigurowanie środowiska programistycznego

Pobierz najnowszą wersję wtyczki Unity do sprawdzania w aplikacji Play z pakietów Google dla Unity.

Tworzenie menedżera opinii

Utwórz instancję ReviewManager, która obsługuje komunikację między Twoją aplikacją a interfejsem API.

// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();

Poproś o obiekt ReviewInfo

Postępuj zgodnie ze wskazówkami na temat tego, kiedy zgłaszać prośby o sprawdzenie aplikacji, aby określić, które z nich pozwolą Ci zachęcić użytkownika do sprawdzenia aplikacji (np. gdy zamknie ekran z podsumowaniem na końcu poziomu gry). Gdy aplikacja zbliży się do jednego z tych punktów, użyj instancji ReviewManager do utworzenia operacji asynchronicznej, jak w tym przykładzie:

var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();

Jeśli wywołanie się powiedzie, interfejs API zwróci obiekt PlayReviewInfo, którego aplikacja potrzebuje do uruchomienia procesu sprawdzania aplikacji. W tym przykładzie wywołanie jest wykonywane wewnątrz koperty, aby wykonać operację asynchroniczną (nie blokuje to wątku głównego). Wywołanie jest wykonywane asynchronicznie, więc może potrwać kilka sekund, dlatego aplikacja powinna wykonywać wywołanie, zanim aplikacja dojdzie do punktu przepływu użytkownika, w którym chcesz wyświetlić opinię w aplikacji.

Uruchamianie procesu sprawdzania w aplikacji

Gdy aplikacja otrzyma instancję PlayReviewInfo, może rozpocząć proces jej sprawdzania. Pamiętaj, że obiekt PlayReviewInfo jest ważny tylko przez ograniczony czas, więc aplikacja nie powinna zbyt długo czekać na uruchomienie przepływu.

var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
// 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

Przetestuj proces sprawdzania aplikacji, aby sprawdzić, czy integracja działa prawidłowo.