gpg::הישג

#include <achievement.h>

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

סיכום

הנתונים מורכבים משני סוגים: ספציפיים למשתמש (למשל, האם המשתמש ביטל את נעילת ההישג וכו') וגלובלי (למשל, שם ההישג).

בונים והורסים
Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl) הפונקציה יוצרת הישג מ-shared_ptr ל-AchievementImpl.מיועד לשימוש פנימי של ה-API.
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	Timestamp הוצא משימוש. עדיפות ל-Last modifiedTime.
LastModifiedTime() const	Timestamp מחזירה את השעה שבה הרשומה שונתה לאחרונה (מבוטאת כאלפיות שנייה מאז תחילת מערכת Unix).
Name() const	const std::string & מחזירה את השם המקוצר של ההישג.
RevealedIconUrl() const	const std::string & מחזירה את כתובת ה-URL שמובילה לתמונה של הסמל שנחשף עבור הישג זה.
State() const	AchievementState מחזירה את מצב ההישג: HIDDEN, REVEALED או UNLOCKED.
TotalSteps() const	uint32_t מחזירה את מספר השלבים הכולל שנדרש לשחקן כדי לבטל את הנעילה של הישג מצטבר נתון.
Type() const	AchievementType מחזירה את סוג ההישג: INCREMENTAL או STANDARD.
UnlockedIconUrl() const	const std::string & מחזירה את כתובת ה-URL שמובילה לתמונה של סמל הנעילה בהישג הזה.
Valid() const	bool הפונקציה מחזירה את הערך True כאשר ההישג המוחזר מאוכלס בנתונים ומלווה בסטטוס תגובה לא מוצלח. FALSE לגבי הישג שנוצר על ידי משתמש שלא אוכלס או הישג מאוכלס שמלווה בסטטוס תגובה לא מוצלח.
XP() const	uint64_t מספר נקודות הניסיון שמוענק על ידי ההישג הזה.
operator=(const Achievement & copy_from)	Achievement & הקצאת ההישג הזה על ידי העתקה מהישג אחר.
operator=(Achievement && move_from)	Achievement & הפונקציה מקצה את ההישג הזה על ידי העברת הישג נוסף אליו.

תפקידים ציבוריים

הישג

 Achievement()

הישג

 Achievement(
  std::shared_ptr< const AchievementImpl > impl
)

הפונקציה יוצרת הישג מ-shared_ptr ל-AchievementImpl.מיועד לשימוש פנימי של ה-API.

הישג

 Achievement(
  const Achievement & copy_from
)

יצירת עותק של הישג קיים.

הישג

 Achievement(
  Achievement && move_from
)

העברת הישג קיים.

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.

LastModified

Timestamp LastModified() const 

הוצא משימוש. עדיפות ל-Last modifiedTime.

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()