gpg:: הישג
#include <achievement.h>
מבנה נתונים יחיד שמאפשר לכם לגשת לנתונים לגבי סטטוס של הישג ספציפי.
סיכום
הנתונים מורכבים משני סוגים: ספציפיים למשתמש (למשל, האם המשתמש ביטל את נעילת ההישג וכו') וגלובלי (למשל, שם ההישג).
בונים והורסים |
|
---|---|
Achievement()
|
|
Achievement(std::shared_ptr< const AchievementImpl > impl)
|
|
Achievement(const Achievement & copy_from)
יצירת עותק של הישג קיים.
|
|
Achievement(Achievement && move_from)
העברת הישג קיים.
|
|
~Achievement()
|
תפקידים ציבוריים |
|
---|---|
CurrentSteps() const
|
uint32_t
מחזירה את מספר הצעדים שהשחקן ביצע כדי להשיג הישג מצטבר.
|
Description() const
|
const std::string &
מחזיר תיאור תמציתי של ההישג.
|
Id() const
|
const std::string &
מחזירה את המחרוזת הייחודית שנוצרה קודם לכן על ידי Google Play Developer Console.
|
LastModified() const
|
הוצא משימוש. עדיפות ל-Last modifiedTime. |
LastModifiedTime() const
|
מחזירה את השעה שבה הרשומה שונתה לאחרונה (מבוטאת כאלפיות שנייה מאז תחילת מערכת Unix).
|
Name() const
|
const std::string &
מחזירה את השם המקוצר של ההישג.
|
RevealedIconUrl() const
|
const std::string &
מחזירה את כתובת ה-URL שמובילה לתמונה של הסמל שנחשף עבור הישג זה.
|
State() const
|
מחזירה את מצב ההישג:
HIDDEN , REVEALED או UNLOCKED . |
TotalSteps() const
|
uint32_t
מחזירה את מספר השלבים הכולל שנדרש לשחקן כדי לבטל את הנעילה של הישג מצטבר נתון.
|
Type() const
|
מחזירה את סוג ההישג:
INCREMENTAL או STANDARD . |
UnlockedIconUrl() const
|
const std::string &
מחזירה את כתובת ה-URL שמובילה לתמונה של סמל הנעילה בהישג הזה.
|
Valid() const
|
bool
הפונקציה מחזירה את הערך True כאשר ההישג המוחזר מאוכלס בנתונים ומלווה בסטטוס תגובה לא מוצלח. FALSE לגבי הישג שנוצר על ידי משתמש שלא אוכלס או הישג מאוכלס שמלווה בסטטוס תגובה לא מוצלח.
|
XP() const
|
uint64_t
מספר נקודות הניסיון שמוענק על ידי ההישג הזה.
|
operator=(const Achievement & copy_from)
|
הקצאת ההישג הזה על ידי העתקה מהישג אחר.
|
operator=(Achievement && move_from)
|
הפונקציה מקצה את ההישג הזה על ידי העברת הישג נוסף אליו.
|
תפקידים ציבוריים
הישג
Achievement()
הישג
Achievement( std::shared_ptr< const AchievementImpl > impl )
הפונקציה יוצרת הישג מ-shared_ptr
ל-AchievementImpl
.מיועד לשימוש פנימי של ה-API.
CurrentSteps
uint32_t CurrentSteps() const
מחזירה את מספר הצעדים שהשחקן ביצע כדי להשיג הישג מצטבר.
אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר TRUE.
התיאור
const std::string & Description() const
מחזיר תיאור תמציתי של ההישג.
בדרך כלל אומר לשחקן איך לזכות בהישג. עד 500 תווים. אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר True.
Id
const std::string & Id() const
מחזירה את המחרוזת הייחודית שנוצרה קודם לכן על ידי Google Play Developer Console.
אפשר להשתמש בה כדי להתייחס להישג בלקוח המשחק. אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר True.
LastModifiedTime
Timestamp LastModifiedTime() const
מחזירה את השעה שבה הרשומה שונתה לאחרונה (מבוטאת כאלפיות שנייה מאז תחילת מערכת Unix).
אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר True.
שם
const std::string & Name() const
מחזירה את השם המקוצר של ההישג.
עד 100 תווים. אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר TRUE.
RevealedIconUrl
const std::string & RevealedIconUrl() const
מחזירה את כתובת ה-URL שמובילה לתמונה של הסמל שנחשף עבור הישג זה.
הסמל הזה אמור להופיע כשההישג נחשף, אבל הנעילה עדיין לא בוטלה. אפשר לקרוא לפונקציה הזו רק כאשר Achievement::Valid() מחזיר TRUE.
ארץ
AchievementState State() const
מחזירה את מצב ההישג: HIDDEN
, REVEALED
או UNLOCKED
.
אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר TRUE. מידע נוסף זמין כאן.
TotalSteps
uint32_t TotalSteps() const
מחזירה את מספר השלבים הכולל שנדרש לשחקן כדי לבטל את הנעילה של הישג מצטבר נתון.
אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר True.
תיאור
AchievementType Type() const
מחזירה את סוג ההישג: INCREMENTAL
או STANDARD
.
אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר TRUE. מידע נוסף זמין כאן.
UnlockedIconUrl
const std::string & UnlockedIconUrl() const
מחזירה את כתובת ה-URL שמובילה לתמונה של סמל הנעילה בהישג הזה.
הסמל הזה אמור להופיע כשנעילת ההישג בוטלה (ולכן גם ייחשף). אפשר לקרוא לפונקציה הזו רק כאשר Achievement::Valid() מחזיר TRUE.
נתונים תקפים
bool Valid() const
הפונקציה מחזירה את הערך True כאשר ההישג המוחזר מאוכלס בנתונים ומלווה בסטטוס תגובה לא מוצלח. FALSE לגבי הישג שנוצר על ידי משתמש שלא אוכלס או הישג מאוכלס שמלווה בסטטוס תגובה לא מוצלח.
כדי שאפשר יהיה להשתמש בפונקציות geter (מזהה, שם, תיאור וכו') של ההישג הזה, הערך חייב להיות נכון.
XP
uint64_t XP() const
מספר נקודות הניסיון שמוענק על ידי ההישג הזה.
אפשר להפעיל אותה רק כאשר Achievement::Valid() מחזיר TRUE.
אופרטור=
Achievement & operator=( const Achievement & copy_from )
הקצאת ההישג הזה על ידי העתקה מהישג אחר.
אופרטור=
Achievement & operator=( Achievement && move_from )
הפונקציה מקצה את ההישג הזה על ידי העברת הישג נוסף אליו.
~הישג
~Achievement()