gpg:: Achievement
#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 &
傳回指向這個成就顯示圖示圖片的網址。
|
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
建構 Achievement 至 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。
此成就 (ID、名稱、說明等) 的 getter 函式必須設為 true。
~Achievement
~Achievement()