Z tego przewodnika dowiesz się, jak zbierać dane o grze użytkowników na potrzeby analizy gry za pomocą interfejsów API zdarzeń udostępnianych przez Usługi gier Google Play. Interfejsy API znajdziesz w com.google.android.gms.games.event
i com.google.android.gms.games
.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobisz, warto zapoznać się z koncepcjami dotyczącymi zdarzeń w grze.
Zanim zaczniesz kodować przy użyciu interfejsów API zdarzeń:
- Zdefiniuj wydarzenia dla swojej gry w Konsoli Google Play.
- Postępuj zgodnie z zaleceniami z listy kontrolnej logowania.
Pobieranie klienta zdarzeń
Aby zacząć korzystać z interfejsów API zdarzeń, gra musi najpierw uzyskać obiekt EventsClient
. Możesz to zrobić, wywołując metodę Games.getEventsClient()
i przekazując dla aktywności oraz GoogleSignInAccount
dla bieżącego gracza. Aby dowiedzieć się, jak pobrać informacje o koncie gracza, przeczytaj artykuł Logowanie się w Grach na Androida.
Przesyłanie zdarzeń
Możesz dodać do gry kod, który powiadomi Usługi gier Google Play, gdy wystąpi zdarzenie istotne dla Twojej gry.
Aby wysłać aktualizację zdarzenia, wywołaj funkcję EventsClient.increment()
z wartością eventId
i liczbą całkowitą incrementAmount
równą co najmniej 0.
- Parametr
eventId
jest generowany przez usługi gier Google Play, gdy po raz pierwszy zdefiniujesz zdarzenie w Konsoli Google Play, i służy do jednoznacznego zidentyfikowania zdarzenia w grze. - Za pomocą parametru
incrementAmount
możesz określić ilościowo postępy gracza w realizacji celu związanego z grą. Jeśli na przykład zdarzeniem, które chcesz śledzić w grze, jest „Pokonać 500 potworów o wielkich oczach”, parametrincrementAmount
może oznaczać liczbę potworów, które gracz zabił w pojedynczej bitwie.
Oto przykład przesyłania zdarzenia z wartością przyrostową 1:
public void submitEvent(String eventId) { Games.getEventsClient(this, GoogleSignIn.getLastSignedInAccount(this)) .increment(eventId, 1); }
Pobieranie zdarzeń
Możesz pobrać wszystkie dane zdarzeń zapisane na serwerach Google w przypadku swojej gry, wywołując funkcję EventsClient.load()
. W wywołaniu metody podaj wartość logiczną, aby wskazać, czy Usługi gier Google Play mają wyczyścić dane z lokalnego pamięci podręcznej na urządzeniu użytkownika.
Aby pobrać dane dotyczące konkretnych zdarzeń zdefiniowanych w Konsoli Google Play, wywołaj funkcję EventsClient.loadByIds()
i w parametrach wejściowych podaj tablicę identyfikatorów zdarzeń.
Ten fragment kodu pokazuje, jak wysłać do usług gier Google Play zapytanie o listę wszystkich zdarzeń w grze:
public void loadEvents() { Games.getEventsClient(this, GoogleSignIn.getLastSignedInAccount(this)) .load(true) .addOnCompleteListener(new OnCompleteListener<AnnotatedData<EventBuffer>>() { @Override public void onComplete(@NonNull Task<AnnotatedData<EventBuffer>> task) { if (task.isSuccessful()) { // Process all the events. for (Event event : task.getResult().get()) { Log.d(TAG, "loaded event " + event.getName()); } } else { // Handle Error Exception exception = task.getException(); int statusCode = CommonStatusCodes.DEVELOPER_ERROR; if (exception instanceof ApiException) { ApiException apiException = (ApiException) exception; statusCode = apiException.getStatusCode(); } showError(statusCode); } } }); }