gpg::プレーヤー

#include <player.h>

特定のプレーヤーに関するデータにアクセスできるデータ構造。

概要

コンストラクタとデストラクタ
Player()
Player(std::shared_ptr< const PlayerImpl > impl)
shared_ptr から PlayerImpl に Player を作成します。
Player(const Player & copy_from)
既存のプレーヤーのコピーを作成します。
Player(Player && move_from)
既存のプレーヤーを新しいプレーヤーに移動します。
~Player()

パブリック関数
AvatarUrl(ImageResolution resolution) const
const std::string &
このプレーヤーのアバター画像が存在する URL を返します。
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 を返します。
operator=(const Player & copy_from)
Player &
別のプレーヤーからコピーして、このプレーヤーを割り当てます。
operator=(Player && move_from)
Player &
別のプレーヤー値を移動して、このプレーヤー値を割り当てます。

パブリック関数

AvatarUrl

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

このプレーヤーのアバター画像が存在する URL を返します。

ImageResolution パラメータは、画像の解像度を指定します。この関数を使用できるようにするには、Player::Valid() が true を返す必要があります。

CurrentLevel

const PlayerLevel & CurrentLevel() const

このプレーヤーの現在のレベルデータを取得します（既知の場合）。

HasLevelInfo() が false を返した場合、Valid() も false を返す PlayerLevel オブジェクトが返されます。

CurrentXP

uint64_t CurrentXP() const

プレーヤーの現在の XP の合計を取得します。

HasLevelInfo() が false を返した場合、ゼロが返されます。HasLevelInfo() が true を返した場合、プレイヤーの現在の XP の合計は CurrentLevel().MinimumXP ～CurrentLevel().MaximumXP の範囲内になります。

HasLevelInfo

bool HasLevelInfo() const

このプレーヤーがレベル情報を利用できるかどうかを返します。

false が返された場合、CurrentLevel() と NextLevel() は有効でない PlayerLevel オブジェクトを返します。

ID

const std::string & Id() const

現在ログインしているプレーヤーの Id を返します。

この関数を使用できるようにするには、Player::Valid() が true を返す必要があります。

LastLevelUpTime

Timestamp LastLevelUpTime() const

このプレーヤーが最後にレベルアップしたとき刻を取得します。

HasLevelInfo() が false を返した場合、またはプレイヤーがレベルアップしたことがない場合は、ゼロ（エポック）が返されます。

名前

const std::string & Name() const

現在ログインしているプレーヤーの Google+ 名を返します。

この関数を使用できるようにするには、Player::Valid() が true を返す必要があります。

NextLevel

const PlayerLevel & NextLevel() const

このプレーヤーの次のレベルのデータ（既知の場合）を取得します。

HasLevelInfo() が false を返した場合、Valid() も false を返す PlayerLevel オブジェクトが返されます。これは、プレーヤーが現在目指しているレベルです。プレーヤーがすでに到達できる最大レベルに達している場合、CurrentLevel() と NextLevel() は同じ値を返します。

選手

 Player()

選手

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

shared_ptr から PlayerImpl に Player を作成します。

API による内部使用を想定しています。

選手

 Player(
  const Player & copy_from
)

既存のプレーヤーのコピーを作成します。

選手

 Player(
  Player && move_from
)

既存のプレーヤーを新しいプレーヤーに移動します。

タイトル

const std::string & Title() const

プレーヤーのタイトルを取得します。

これは、Google Play Games エコシステム全体でプレーヤーが行ったアクションに基づいています。なお、すべてのプレーヤーにタイトルが付与されるわけではありません。また、プレーヤーのタイトルは時間の経過とともに変わる可能性があります。プレーヤーにタイトルがない場合、Title() は空の文字列を返します。

有効

bool Valid() const

返されたプレーヤーにデータが入力され、レスポンス ステータスが成功の場合、true を返します。データが入力されていないユーザー作成のプレーヤーの場合、またはデータが入力されているがレスポンス ステータスが失敗の場合、false を返します。

このオブジェクトのゲッター関数を使用できるようにするには、true を返す必要があります。

operator=

Player & operator=(
  const Player & copy_from
)

別のプレーヤーからコピーして、このプレーヤーを割り当てます。

operator=

Player & operator=(
  Player && move_from
)

別のプレーヤー値を移動して、このプレーヤー値を割り当てます。

~プレーヤー

 ~Player()