gpg::Achievement

#include <achievement.h>

單一資料結構，可讓您存取特定成就的狀態相關資料。

摘要

資料包含兩種類型：使用者專屬 (例如使用者是否已解鎖成就等) 和全球 (例如成就名稱)。

建構函式和解構函式
Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl)
從 shared_ptr 建構 Achievement 至 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 開發人員控制台事先產生的專屬字串。
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 內部使用。

訓練成果

 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 開發人員控制台事先產生的專屬字串。

用來指稱遊戲用戶端中的成就。只有在 Achievement::Valid() 傳回 true 時才會呼叫此方法。

LastModified

Timestamp LastModified() const

已淘汰，，瞭解如何調查及移除這項存取權。 優先使用 LastModifiedTime。

LastModifiedTime

Timestamp LastModifiedTime() const

傳回項目上次修改的時間 (以 Unix 紀元以來的毫秒數表示)。

只有在 Achievement::Valid() 傳回 true 時才會呼叫此方法。

名稱

const std::string & Name() const

傳回成就的簡稱。

最多 100 個半形字元。只有在 Achievement::Valid() 傳回 true 時才會呼叫此方法。

RevealedIconUrl

const std::string & RevealedIconUrl() const

傳回指向這個成就顯示圖示圖片的網址。

當「成就」顯示完成但尚未解鎖時，系統就會顯示這個圖示。只有在 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。

XP

uint64_t XP() const

這項成就獲得的經驗值。

只有在 Achievement::Valid() 傳回 true 時才會呼叫此方法。

operator=

Achievement & operator=(
  const Achievement & copy_from
)

從另一個成就複製來指派這個成就。

operator=

Achievement & operator=(
  Achievement && move_from
)

只要在成就中移動另一個成就，即可指派該成就。

~Achievement

 ~Achievement()