gpg:: AchievementManager
#include <achievement_manager.h>
מקבל ומגדיר נתונים שונים הקשורים להישגים.
סיכום
סוגים ציבוריים |
|
---|---|
FetchAllCallback
|
typedefstd::function< void(const FetchAllResponse &)>
מגדיר סוג של קריאה חוזרת שמקבל FetchAllResponse . |
FetchCallback
|
typedefstd::function< void(const FetchResponse &)>
מגדיר סוג של קריאה חוזרת שמקבל FetchResponse . |
ShowAllUICallback
|
typedefstd::function< void(const UIStatus &)>
מגדיר סוג של קריאה חוזרת שמקבל UIStatus . |
פונקציות ציבוריות |
|
---|---|
Fetch(const std::string & achievement_id, FetchCallback callback)
|
void
טעינה אסינכרונית של נתונים עבור הישג ספציפי בנגן שמחובר כרגע.
|
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
|
void
טעינה אסינכרונית של נתונים עבור הישג ספציפי בנגן שמחובר כרגע.
|
FetchAll(FetchAllCallback callback)
|
void
טוען באופן אסינכרוני את כל נתוני ההישגים של הנגן המחובר כעת.
|
FetchAll(DataSource data_source, FetchAllCallback callback)
|
void
טוען באופן אסינכרוני את כל נתוני ההישגים של הנגן המחובר כעת.
|
FetchAllBlocking()
|
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת
FetchAllResponse ישירות. |
FetchAllBlocking(DataSource data_source)
|
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת
FetchAllResponse ישירות. |
FetchAllBlocking(Timeout timeout)
|
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת
FetchAllResponse ישירות. |
FetchAllBlocking(DataSource data_source, Timeout timeout)
|
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת
FetchAllResponse ישירות. |
FetchBlocking(const std::string & achievement_id)
|
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של
FetchResponse . |
FetchBlocking(DataSource data_source, const std::string & achievement_id)
|
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של
FetchResponse . |
FetchBlocking(Timeout timeout, const std::string & achievement_id)
|
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של
FetchResponse . |
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
|
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של
FetchResponse . |
Increment(const std::string & achievement_id)
|
void
הגדלת הישג במספר השלבים הנתון.
|
Increment(const std::string & achievement_id, uint32_t steps)
|
void
הגדלת הישג במספר השלבים הנתון.
|
Reveal(const std::string & achievement_id)
|
void
הצגת הישג מוסתר לנגן שמחובר כרגע.
|
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
|
void
מגדירים הישג להשלמת מספר השלבים הנתון לפחות.
|
ShowAllUI(ShowAllUICallback callback)
|
void
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
|
ShowAllUI()
|
void
|
ShowAllUIBlocking()
|
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
|
ShowAllUIBlocking(Timeout timeout)
|
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
|
Unlock(const std::string & achievement_id)
|
void
קבלת הישג לשחקן שמחובר כרגע.
|
מבנים |
|
---|---|
gpg:: |
מכיל את כל הנתונים של כל ההישגים, יחד עם סטטוס התגובה. |
gpg:: |
מכיל נתונים וסטטוס תגובה עבור הישג יחיד. |
סוגים ציבוריים
FetchAllCallback
std::function< void(const FetchAllResponse &)> FetchAllCallback
מגדיר סוג של קריאה חוזרת שמקבל FetchAllResponse
.
סוג הקריאה החוזרת הזה זמין לפונקציות FetchAll(*)
שמפורטות בהמשך.
FetchCallback
std::function< void(const FetchResponse &)> FetchCallback
מגדיר סוג של קריאה חוזרת שמקבל FetchResponse
.
סוג הקריאה החוזרת הזה זמין לפונקציות Fetch(*)
שמפורטות בהמשך.
ShowAllUICallback
std::function< void(const UIStatus &)> ShowAllUICallback
מגדיר סוג של קריאה חוזרת שמקבל UIStatus
.
סוג הקריאה החוזרת הזה זמין לפונקציה ShowAllUI*
שבהמשך.
פונקציות ציבוריות
הבא
void Fetch( const std::string & achievement_id, FetchCallback callback )
טעינה אסינכרונית של נתונים עבור הישג ספציפי בנגן שמחובר כרגע.
הפונקציה מפעילה את ה-FetchCallback
שסופקו עם סיום הפעולה. אם לא מציינים את הפונקציה data_source
, הקריאה לפונקציה הזו זהה לקריאה ל-Fetch(DataSource data_source, const std::string& id,
FetchCallback)
כאשר data_source
מוגדר כ-CACHE_OR_NETWORK
.
הבא
void Fetch( DataSource data_source, const std::string & achievement_id, FetchCallback callback )
טעינה אסינכרונית של נתונים עבור הישג ספציפי בנגן שמחובר כרגע.
הפונקציה קוראת ל-FetchCallback
שסופק עם סיום הפעולה. צריך לציין data_source בתור CACHE_OR_NETWORK
או NETWORK_ONLY
.
FetchAll
void FetchAll( FetchAllCallback callback )
טוען באופן אסינכרוני את כל נתוני ההישגים של הנגן המחובר כעת.
הפונקציה מפעילה את ה-FetchAllCallback
שסופקו עם סיום הפעולה. אם לא מציינים את הפונקציה data_source
, הקריאה לפונקציה הזו זהה לקריאה ל-FetchAll(DataSource data_source, FetchAllCallback)
כאשר data_source
מצוין בתור CACHE_OR_NETWORK
.
FetchAll
void FetchAll( DataSource data_source, FetchAllCallback callback )
טוען באופן אסינכרוני את כל נתוני ההישגים של הנגן המחובר כעת.
הפונקציה מפעילה את ה-FetchAllCallback
שסופקו עם סיום הפעולה. צריך לציין את data_source
בתור CACHE_OR_NETWORK
או NETWORK_ONLY
.
FetchAllBlocking
FetchAllResponse FetchAllBlocking()
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת FetchAllResponse
ישירות.
אם לא מציינים את הערך של data_source
וגם לא את הערך timeout
, הקריאה לפונקציה הזו זהה לקריאה ל-FetchAllResponse FetchAllBlocking(DataSource data_source,
Timeout timeout)
כשהערך של data_source
הוא CACHE_OR_NETWORK
והערך timeout
מוגדר כ-10 שנים.
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source )
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת FetchAllResponse
ישירות.
צריך לציין את data_source
בתור CACHE_OR_NETWORK
או NETWORK_ONLY
. אם לא מציינים את הפרמטר timeout
, הקריאה לפונקציה הזו זהה לפונקציה FetchAllBlocking FetchAllResponse(DataSource data_source,
Timeout timeout)
שבה צוין הערך של data_source
, והפונקציה timeout
מוגדרת ל-10 שנים.
FetchAllBlocking
FetchAllResponse FetchAllBlocking( Timeout timeout )
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת FetchAllResponse
ישירות.
מציינים את timeout
כמספר שרירותי של אלפיות השנייה. אם לא מציינים את הפונקציה data_source
, הפונקציה הזו מקבילה לקריאה ל-FetchAllResponse FetchAllBlocking(DataSource data_source,
Timeout timeout)
כאשר data_source
מוגדר כ-CACHE_OR_NETWORK
ו-timeout
מכיל את הערך שצוין.
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source, Timeout timeout )
טעינה מסונכרנת של כל נתוני ההישגים של הנגן שמחובר כרגע לחשבון, והחזרת FetchAllResponse
ישירות.
צריך לציין את data_source
בתור CACHE_OR_NETWORK
או NETWORK_ONLY
. הגדרת זמן קצוב לתפוגה כמספר שרירותי של אלפיות השנייה.
FetchBlocking
FetchResponse FetchBlocking( const std::string & achievement_id )
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של FetchResponse
.
אם לא מגדירים את data_source
ואת timeout
, הקריאה לפונקציה הזו זהה לקריאה ל-FetchResponse FetchBlocking(DataSource data_source,
Timeout timeout, const std::string& id)
, כאשר data_source
מוגדר כ-CACHE_OR_NETWORK
ו-timeout
מוגדר ל-10 שנים.
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, const std::string & achievement_id )
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של FetchResponse
.
צריך לציין את data_source
בתור CACHE_OR_NETWORK
או NETWORK_ONLY
. אם לא מציינים את המימד timeout
, הקריאה לפונקציה הזו זהה לקריאה ל-FetchResponse FetchBlocking(DataSource data_source,
Timeout timeout, const std::string& id)
, עם הערך שצוין ל-data_source
והפרמטר timeout
מוגדר ל-10 שנים.
FetchBlocking
FetchResponse FetchBlocking( Timeout timeout, const std::string & achievement_id )
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של FetchResponse
.
מציינים את timeout
כמספר שרירותי של אלפיות השנייה. אם לא מציינים את המימד data_source
, הקריאה של הפונקציה הזו מקבילה לקריאה ל-FetchResponse FetchBlocking(DataSource data_source,
Timeout timeout, const std::string& id)
, כאשר data_source
מוגדר כ-CACHE_OR_NETWORK
ו-timeout
מכיל את הערך שצוין.
FetchBlocking
FetchResponse FetchBlocking( DataSource data_source, Timeout timeout, const std::string & achievement_id )
טעינה סינכרונית של נתונים להישג ספציפי, המזוהים באמצעות מזהה המחרוזת, עבור הנגן שמחובר כרגע לחשבון; הפונקציה מחזירה ישירות את הערך של FetchResponse
.
צריך לציין את data_source
בתור CACHE_OR_NETWORK
או NETWORK_ONLY
. מציינים את timeout
כמספר שרירותי של אלפיות השנייה.
תוספת
void Increment( const std::string & achievement_id )
הגדלת הישג במספר השלבים הנתון.
אם ההגדלה לא מוגדרת, הערך שלו יוגדר ל-1 כברירת מחדל. ההישג חייב להיות הישג מצטבר. כשהישג מגיע למספר השלבים המקסימלי, הנעילה שלו מתבטלת באופן אוטומטי. המערכת תתעלם מהפרשים נוספים.
תוספת
void Increment( const std::string & achievement_id, uint32_t steps )
הגדלת הישג במספר השלבים הנתון.
ההישג חייב להיות הישג מצטבר. ברגע שהישג יגיע למספר השלבים המקסימלי, הנעילה שלו תבוטל באופן אוטומטי. המערכת תתעלם מהפרשים נוספים.
חשיפה
void Reveal( const std::string & achievement_id )
הצגת הישג מוסתר לנגן שמחובר כרגע.
אם הנעילה של ההישג כבר בוטלה, לא תהיה לכך השפעה.
SetStepsAtLeast
void SetStepsAtLeast( const std::string & achievement_id, uint32_t steps )
מגדירים הישג להשלמת מספר השלבים הנתון לפחות.
קריאה לשיטה הזו בזמן שההישג כבר כולל יותר שלבים מהערך שצוין, היא פעולה ללא פעולה. לאחר שההישג יגיע למספר השלבים המקסימלי, הנעילה של ההישג תבוטל באופן אוטומטי ותתעלם מפעולות מוטציה נוספות.
ShowAllUI
void ShowAllUI( ShowAllUICallback callback )
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
היא מפעילה את ShowAllUICallback
באופן אסינכרוני.
ShowAllUI
void ShowAllUI()
הוצא משימוש. עדיף להשתמש באפשרות ShowAllUI(ShowAllUICallback callback) (הצגת קריאה חוזרת של AllUICallback). הצגת ממשק משתמש למשתמש שמציג מידע על כל ההישגים. ממשק המשתמש מוצג באופן אסינכרוני בכל הפלטפורמות.
ShowAllUIBlocking
UIStatus ShowAllUIBlocking()
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
היא מחזירה באופן סינכרוני UIStatus
. אם לא מציינים את הפרמטר timeout
, הקריאה לפונקציה הזו זהה לקריאה ל-ShowAllUIBlocking(Timeout timeout)
כשמציינים את timeout
כ-10 שנים.
ShowAllUIBlocking
UIStatus ShowAllUIBlocking( Timeout timeout )
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
היא מחזירה באופן סינכרוני UIStatus
. מציינים את timeout
כמספר שרירותי של אלפיות השנייה.
ביטול הנעילה
void Unlock( const std::string & achievement_id )
קבלת הישג לשחקן שמחובר כרגע.
אם ההישג מוסתר, גם ה-SDK חושף אותו.