gpg::玩家

#include <player.h>

一種資料結構，可讓您存取特定玩家的資料。

摘要

建構函式和解構函式
Player()
Player(std::shared_ptr< const PlayerImpl > impl)
從 shared_ptr 建構 Player 至 PlayerImpl。
Player(const Player & copy_from)
建立現有 Player 的副本。
Player(Player && move_from)
將現有的 Player 移至新的遊戲。
~Player()

公開函式
AvatarUrl(ImageResolution resolution) const
const std::string &
傳回此玩家顯示圖片的所在網址。
CurrentLevel() const
const PlayerLevel &
擷取此玩家目前的等級資料 (如果已知)。
CurrentXP() const
uint64_t
擷取玩家目前的 XP 總點數。
HasLevelInfo() const
bool
傳回此玩家是否擁有樓層資訊。
Id() const
const std::string &
傳回目前登入玩家的 Id。
LastLevelUpTime() const
擷取此玩家上次升級時的時間戳記。
Name() const
const std::string &
傳回目前登入玩家的 Google+ 名稱。
NextLevel() const
const PlayerLevel &
擷取此玩家的下一級資料 (如果已知)。
Title() const
const std::string &
擷取玩家的標題。
Valid() const
bool
如果傳回的玩家已填入資料，並且附上成功的回應狀態，則會傳回 true；未填入使用者建立的玩家為 false，或是填入失敗回應狀態的填入玩家為 false。
operator=(const Player & copy_from)
Player &
透過複製其他玩家的方式指派此玩家。
operator=(Player && move_from)
Player &
透過移動另一個值來指派此玩家值。

公開函式

AvatarUrl

const std::string & AvatarUrl(
  ImageResolution resolution
) const

傳回此玩家顯示圖片的所在網址。

ImageResolution 參數會指定圖片的解析度。Player::Valid() 必須傳回 true，才能使用這個函式。

CurrentLevel

const PlayerLevel & CurrentLevel() const

擷取此玩家目前的等級資料 (如果已知)。

如果 HasLevelInfo() 傳回 false，這會傳回 PlayerLevel 物件，而 Valid() 也會傳回 false。

CurrentXP

uint64_t CurrentXP() const

擷取玩家目前的 XP 總點數。

如果 HasLevelInfo() 傳回 false，則會傳回零。如果 HasLevelInfo() 傳回 true，玩家目前的 XP 總量將介於 CurrentLevel() 至 CurrentLevel() 範圍之間。

HasLevelInfo

bool HasLevelInfo() const

傳回此玩家是否擁有樓層資訊。

如果傳回 false，CurrentLevel() 和 NextLevel() 會傳回無效的 PlayerLevel 物件。

ID

const std::string & Id() const

傳回目前登入玩家的 Id。

Player::Valid() 必須傳回 true，才能使用這個函式。

LastLevelUpTime

Timestamp LastLevelUpTime() const

擷取此玩家上次升級時的時間戳記。

如果 HasLevelInfo() 傳回 false，或者玩家從未升級，就會傳回 0 (週期)。

名稱

const std::string & Name() const

傳回目前登入玩家的 Google+ 名稱。

Player::Valid() 必須傳回 true，才能使用這個函式。

NextLevel

const PlayerLevel & NextLevel() const

擷取此玩家的下一級資料 (如果已知)。

如果 HasLevelInfo() 傳回 false，這會傳回 PlayerLevel 物件，而 Valid() 也會傳回 false。這是玩家目前的目標關卡。如果玩家的等級已達最大玩家等級，CurrentLevel() 和 NextLevel() 都會傳回相同的值。

球員

 Player()

球員

 Player(
  std::shared_ptr< const PlayerImpl > impl
)

從 shared_ptr 建構 Player 至 PlayerImpl。

適用於 API 的內部使用。

球員

 Player(
  const Player & copy_from
)

建立現有 Player 的副本。

球員

 Player(
  Player && move_from
)

將現有的 Player 移至新的遊戲。

標題

const std::string & Title() const

擷取玩家的標題。

這取決於玩家在 Google Play 遊戲生態系統中採取的動作。請注意，並非所有玩家都有自己的作品，而且他們的標題可能會隨著時間而改變。如果玩家沒有標題，Title() 會傳回空白字串。

有效

bool Valid() const

如果傳回的玩家已填入資料，並且附上成功的回應狀態，則會傳回 true；未填入使用者建立的玩家為 false，或是填入失敗回應狀態的填入玩家為 false。

這個函式必須傳回 true，才能讓這個物件的 getter 函式使用。

operator=

Player & operator=(
  const Player & copy_from
)

透過複製其他玩家的方式指派此玩家。

operator=

Player & operator=(
  Player && move_from
)

透過移動另一個值來指派此玩家值。

~播放器

 ~Player()