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 管理中心事先產生的專屬字串。
|
LastModified() const
|
已淘汰。 偏好 LastModifiedTime。 |
LastModifiedTime() const
|
傳回項目上次修改時間 (以毫秒為單位，自 Unix 紀元開始算起)。
|
Name() const
|
const std::string &
傳回關卡的簡稱。
|
RevealedIconUrl() const
|
const std::string &
傳回導向此 Achievement 的已顯示圖示圖片的網址。
|
State() const
|
傳回關卡狀態：
HIDDEN、REVEALED 或 UNLOCKED。 |
TotalSteps() const
|
uint32_t
傳回玩家要解開特定增量關卡所需的總步驟數。
|
Type() const
|
傳回關卡類型：
INCREMENTAL 或 STANDARD。 |
UnlockedIconUrl() const
|
const std::string &
傳回可導向此 Achievement 無鎖版圖示圖片的網址。
|
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 管理中心事先產生的專屬字串。
用來指稱遊戲用戶端中的成就。只有在 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
傳回導向此 Achievement 的已顯示圖示圖片的網址。
如果顯示「成就」，但尚未解鎖，系統就會顯示這個圖示。只有在 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
傳回可導向此 Achievement 無鎖版圖示圖片的網址。
這個圖示需在解鎖「成就」後並顯示 (一併顯示)。只有在 Achievement::Valid() 傳回 true 時才能呼叫此函式。
有效
bool Valid() const
如果傳回的成就填入資料，且回應成功，則會傳回 true；如果是未填入的使用者建立的成就，或是已填入的成就包含失敗的回應狀態，則為 false。
此關卡的 getter 函式 (ID、名稱、說明等) 必須設為 true 才能使用。
~成就
~Achievement()