נתונים סטטיסטיים של משחקים ל-Android

במדריך הזה נסביר איך להשתמש בממשקי ה-API של נתונים סטטיסטיים של המשחק באפליקציה ל-Android כדי להעניק ולהציג את נתונים סטטיסטיים של המשחק במשחק. ממשקי ה-API נכללים בחבילות com.google.android.gms.games ו-com.google.android.gms.games.playergameevent.

לפני שמתחילים

אם עדיין לא עשיתם זאת, אנחנו ממליצים לכם להכיר את המושגים שקשורים לנתונים סטטיסטיים של משחקים.

לפני שמתחילים לכתוב קוד שמשתמשים בו בממשק ה-API של נתוני המשחק:

  • מתקינים ומגדירים את האפליקציה לפי ההוראות לשימוש ב-Google Play Games Services שמופיעות במדריך להגדרת Google Play Services SDK.

  • מגדירים את נתוני המשחק שרוצים שהמשחק יציג או יאפשר גישה אליהם, לפי ההוראות במדריך Google Play Console.

קבלת לקוח נתונים סטטיסטיים של המשחק

כדי להתחיל להשתמש ב-Game Stats API, המשחק שלכם צריך קודם לקבל אובייקט GameStatsClient. כדי לעשות את זה, קוראים לשיטה Games.getGameStatsClient() ומעבירים את הפעילות.

שילוב בצד הלקוח

השילוב בצד הלקוח של PlayerGameEvent יכלול בנייה של אובייקט האירוע ב-Java SDK בנקודות ההפעלה ושליחה שלו באמצעות פונקציות ההעלאה שסופקו על ידי ה-SDK.

באופן דומה, לגבי האירוע progressUpdate, מתעדים את ההתקדמות המעודכנת באמצעות המאפיין currentProgress עם מאפיינים מוגדרים נוספים ושולחים אותם באמצעות פונקציות ההעלאה שסופקו על ידי ה-SDK.

אירועים

השילובים בצד הלקוח של PlayerGameEvent הם:

יצירת אירוע משחק של שחקן

Java


// 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 אירוע שחקן במשחק

Java


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

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

הקלטת אירוע והעלאה

Java


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

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

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