Android oyunları için etkinlikler

Bu kılavuzda, Google Play Games Hizmetleri tarafından sağlanan etkinlik API'lerini kullanarak oyun analizleri için oyuncu oyun oynama verilerinin nasıl toplanacağı gösterilmektedir. API'leri com.google.android.gms.games.event ve com.google.android.gms.games paketlerinde bulabilirsiniz.

Başlamadan önce

Henüz yapmadıysanız etkinlikler oyun kavramlarını incelemeniz faydalı olabilir.

Etkinlik API'lerini kullanarak kod yazmaya başlamadan önce:

Events Client'ı edinme

Etkinlik API'lerini kullanmaya başlamak için oyununuzun önce bir EventsClient nesnesi alması gerekir. Bunu, PlayGames.getEventsClient() yöntemini çağırıp etkinliği ileterek yapabilirsiniz.

Etkinlik gönderme

Oyununuza, oyununuzla ilgili bir etkinlik gerçekleştiğinde Play Games Hizmetleri'ni bilgilendirecek kod ekleyebilirsiniz.

Etkinlik güncellemesi göndermek için eventId değeri ve 0'a eşit veya 0'dan büyük bir tam sayı olan incrementAmount ile EventsClient.increment() işlevini çağırın.

  • eventId, Google Play Console'da etkinliği ilk tanımladığınızda Play Games Hizmetleri tarafından oluşturulur ve bu etkinliği oyununuzda benzersiz şekilde tanımlamak için kullanılır.

  • Oyuncunun oyuna özel bir hedefi tamamlama yolundaki nicel ilerlemesini belirtmek için incrementAmount girişini kullanabilirsiniz. Örneğin, oyununuzun izlemek istediği etkinlik "500 böcek gözlü canavarı yen" ise incrementAmount değeri, oyuncunun tek bir savaşta öldürdüğü canavar sayısı olabilir.

1 artış miktarıyla etkinlik gönderme örneğini aşağıda bulabilirsiniz:

public void submitEvent(String eventId) {
  PlayGames.getEventsClient(this)
      .increment(eventId, 1);
}

Etkinlikleri alma

EventsClient.load() işlevini çağırarak oyununuz için Google'ın sunucularında depolanan tüm etkinlik verilerini alabilirsiniz. Yöntem çağrısında, Play Games Hizmetleri'nin kullanıcının cihazında yerel olarak önbelleğe alınan verileri temizleyip temizlememesi gerektiğini belirtmek için bir Boole değeri iletin.

Google Play Console'da tanımladığınız belirli etkinliklerle ilgili verileri almak için EventsClient.loadByIds() işlevini çağırın ve giriş parametrelerinde bir etkinlik kimlikleri dizisi iletin.

Aşağıdaki snippet'te, Play Games Hizmetleri'ne oyununuzdaki tüm etkinliklerin listesini nasıl sorgulayabileceğiniz gösterilmektedir:

public void loadEvents() {
  PlayGames.getEventsClient(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);
          }
        }
      });
}