המדריך הזה מראה כיצד להשתמש בשירות האירועים באפליקציה C++.
לפני שמתחילים
אם עדיין לא עשיתם זאת, כדאי לעיין בקונספטים של משחקים לאירועים.
כדי להגדיר את סביבת הפיתוח C++ לשימוש בשירות אירועים, בצע את ההוראות במדריך תחילת העבודה עבור C++. אפשר להוריד את ערכת ה-SDK C++ של Play Games Services מדף ההורדות של SDK.
כדי שלמשחק תהיה גישה לאירועים, צריך להגדיר אותם קודם ב-Google Play Console.
שליחת אירוע
אתם יכולים להוסיף קוד למשחק כדי להודיע לשירות האירועים בכל פעם שמתרחש אירוע מעניין במשחק שלכם. דוגמאות לאירועים שאפשר לתעד במשחק: הריגה של אויבים, חיפוש או חזרה לאזורים שונים במשחק או רכישת פריטים מתוך המשחק. בדרך כלל תקראו לשיטה Increment במנהל האירועים כדי להגדיל את מספר האירועים באחד, בכל פעם שהשחקן מבצע פעולה המשויכת לאירוע (לדוגמה, "הרג מפלצת אחת").
הדוגמה הבאה ממחישה איך שולחים את המספר המעודכן של האירועים לשירות האירועים.
// Increment the event count when player performs the 'Attack blue
// monster' action.
game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);
אחזור אירועים
כדי לאחזר את ערך הספירה הנוכחי ששמור בשרתי Google לאירוע ספציפי, צריך להתקשר לאחת מהשיטות של Fetch*. לדוגמה, אפשר לעשות זאת אם אתם רוצים להציג את הנתונים הסטטיסטיים של שחקן מסוים או להתקדם מממשק משתמש מותאם אישית במשחק.
הדוגמה הבאה מראה איך מאחזרים ומתעדים את נתוני האירועים במשחק.
// Log Events details.
LogI("---- Showing Event Counts -----");
gpg::EventManager::FetchAllCallback callback =
[](gpg::EventManager::FetchAllResponse const &response) {
for (auto i : response.data) {
gpg::Event const &event = i.second;
LogI("Event name: %s count: %d", event.Name().c_str(),
event.Count());
}
};
game_services_->Events().FetchAll(callback);