آمار بازی برای بازی‌های Android

این راهنما نحوه استفاده از «میاناهای برنامه‌سازی کاربردی آمار بازی» در برنامه Android را برای باز کردن و نمایش «آمار بازی» در بازی‌تان نشان می‌دهد. این «میاناهای برنامه‌سازی کاربردی» را می‌توانید در بسته‌های com.google.android.gms.games و com.google.android.gms.games.playergameevent پیدا کنید.

قبل‌از شروع

اگر قبلاً این کار را نکرده‌اید، ممکن است مرور کردن مفاهیم بازی «آمار بازی» برایتان مفید باشد.

قبل‌از شروع کدنویسی بااستفاده از Game Stats API:

دریافت کارخواه «آمار بازی»

برای شروع استفاده از Game Stats API، بازی شما ابتدا باید یک GameStatsClient شیء دریافت کند. می‌توانید این کار را با فراخوانی روش Games.getGameStatsClient() و ارسال فعالیت انجام دهید.

ادغام سمت کارخواه

ادغام سمت کارخواه برای PlayerGameEvent شامل ساختن شیء رویداد در «کیت توسعه نرم‌افزار Java» در نقاط راه‌اندازی و ارسال آن‌ها بااستفاده از توابع بارگذاری ارائه‌شده توسط کیت توسعه نرم‌افزار می‌شود.

به‌همین ترتیب، برای رویداد progressUpdate، پیشرفت به‌روزشده را بااستفاده از دارایی currentProgress با دارایی‌های تعریف‌شده اضافی ضبط کنید و آن‌ها را بااستفاده از توابع بارگذاری ارائه‌شده توسط کیت توسعه نرم‌افزار ارسال کنید.

رویدادها

ادغام سمت کارخواه برای PlayerGameEvent عبارت‌اند از:

ساختن رویداد بازی بازیکن

جاوا


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("matchCompleted")
  .addProperty("matchId", "Match_A")
  .addProperty("gameMode", "Battle_B")
  .addProperty("mapId", "Location_XYZ")
  .addProperty("isWinner", true)
  .addProperty("playerElimination", 2)
  .build();

List events = new ArrayList<>();
// ... populate list ...

ساختن رویداد بازی بازیکن progressUpdate

جاوا


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("progressUpdate")
  .addProperty("currentProgress", 52)
  // Add other properties if needed
  .build();

List events = new ArrayList<>();
// ... populate list ...

ضبط رویداد و بارگذاری

جاوا


// Buffers the event locally.
client.recordEvent(event);

// Buffers the events locally, (List version)
client.recordEvents(events);

// This submits the events to PGS
client.requestEventsUpload();