Integracja opinii w aplikacji (Unity)

Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji za pomocą Unity. Istnieją osobne przewodniki po integracji dla osób korzystających z Kotlin lub Java lub kodu natywnego.

Omówienie pakietu SDK Unity

Interfejs Play In-App Review API jest częścią Play Core pakietu SDK. Interfejs API dla ReviewManager w ramach Unity w celu zażądania i uruchomienia przepływu za pomocą klasy RequestReviewFlow i LaunchReviewFlow . Po przesłaniu prośby aplikacja może sprawdzić jej stan przy użyciu ReviewErrorCode.

Konfigurowanie środowiska programistycznego

Pobierz najnowszą wersję wtyczki Play In-App Review Unity (Play In-App Review Unity) z pakietów Google dla zjednoczenie.

Tworzenie menedżera opinii

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

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

Poproś o obiekt ReviewInfo

Postępuj zgodnie ze wskazówkami dotyczącymi tego, kiedy wysyłać prośby w aplikacji opinie, aby określić dobre punkty. w ramach wzorca aplikacji, aby poprosić użytkownika o opinię (np. po kliknięciu zamyka ekran podsumowania po zakończeniu poziomu w grze. Gdy aby zbliżyć się do jednego z tych punktów, użyj narzędzia ReviewManager w celu 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 PlayReviewInfo obiekt wymagany przez aplikację, aby uruchomić proces sprawdzania aplikacji. W tym przykładzie parametr jest wykonywane wewnątrz współrzędu wykonania operacji asynchronicznej (nie spowoduje to zablokowania wątku głównego). Ponieważ wywołanie jest wykonywane asynchronicznie, może to potrwać do kilku sekund, aplikacja powinna nawiązać połączenie, zanim dotrze do użytkownika w którym miejscu chcesz wyświetlić opinię w aplikacji.

Uruchom proces sprawdzania aplikacji

Gdy aplikacja otrzyma PlayReviewInfo może uruchomić proces sprawdzania w aplikacji. Pamiętaj, że w polu PlayReviewInfo obiekt jest ważny tylko przez ograniczony czas, więc aplikacja nie powinna czekać zbyt długo przed uruchomieniem 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 sprawdź, czy integracja działa poprawnie.