gpg::AchievementManager

#include <achievement_manager.h>

מקבלת ומגדירה נתונים שונים הקשורים להישגים.

סיכום

סוגים ציבוריים
FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
מגדיר סוג של קריאה חוזרת שמקבל FetchAllResponse.
FetchCallback typedef
std::function< void(const FetchResponse &)>
מגדיר סוג של קריאה חוזרת שמקבל FetchResponse.
ShowAllUICallback typedef
std::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
הוצא משימוש. עדיף להשתמש ב-ShowAllUI(ShowAllUICallback callback) (הצגת קריאה חוזרת של AllUICallback). הצגת ממשק משתמש למשתמש שמציג מידע על כל ההישגים. ממשק המשתמש מוצג באופן אסינכרוני בכל הפלטפורמות.
ShowAllUIBlocking()
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
ShowAllUIBlocking(Timeout timeout)
מציג למשתמש ממשק משתמש שמציג מידע על כל ההישגים.
Unlock(const std::string & achievement_id)
void
השגת הישג לשחקן שמחובר כרגע.

מבנים
gpg::AchievementManager::FetchAllResponse

מכיל את כל הנתונים של כל ההישגים, יחד עם סטטוס התגובה.

gpg::AchievementManager::FetchResponse

מכיל נתונים וסטטוס תגובה עבור הישג יחיד.

סוגים ציבוריים

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 חושף אותו.