آمار بازی برای بازی‌های اندروید

این راهنما به شما نشان می‌دهد که چگونه از APIهای آمار بازی در یک برنامه اندروید برای باز کردن قفل و نمایش آمار بازی در بازی خود استفاده کنید. APIها را می‌توانید در بسته‌های com.google.android.gms.games و com.google.android.gms.games.playergameevent پیدا کنید.

قبل از اینکه شروع کنی

اگر هنوز این کار را نکرده‌اید، شاید مرور مفاهیم آمار بازی برایتان مفید باشد.

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

• دستورالعمل‌های نصب و راه‌اندازی برنامه خود را برای استفاده از سرویس‌های بازی‌های گوگل پلی در راهنمای «راه‌اندازی کیت توسعه نرم‌افزار سرویس‌های گوگل پلی» دنبال کنید.

• با دنبال کردن دستورالعمل‌های موجود در راهنمای کنسول گوگل پلی ، آمار بازی مورد نظر خود را برای باز کردن قفل یا نمایش در بازی تعریف کنید.

یک کلاینت آمار بازی دریافت کنید

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

ادغام سمت کلاینت

یکپارچه‌سازی سمت کلاینت برای PlayerGameEvent شامل ساخت شیء رویداد در Java SDK، در نقاط شروع و ارسال آنها با استفاده از توابع آپلود ارائه شده توسط SDK می‌شود.

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

رویدادها

ادغام سمت کلاینت برای PlayerGameEvent عبارتند از:

رویداد بازی Build Player

// 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();