gpg:: بازیکن

#include <player.h>

ساختار داده ای که به شما امکان می دهد به داده های مربوط به یک پخش کننده خاص دسترسی داشته باشید.

خلاصه

سازندگان و تخریب کنندگان

Player ()
Player (std::shared_ptr< const PlayerImpl > impl)
یک Player از shared_ptr به PlayerImpl می سازد.
Player (const Player & copy_from)
یک کپی از یک پخش کننده موجود ایجاد می کند.
Player ( Player && move_from)
یک بازیکن موجود را به یک بازیکن جدید منتقل می کند.
~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 را برمی گرداند. برای پخش‌کننده‌ای که کاربر ایجاد کرده است نادرست است یا برای پخش‌کننده‌ای که با وضعیت پاسخ ناموفق همراه است.
operator= (const Player & copy_from)
این بازیکن را با کپی کردن از یک بازیکن دیگر اختصاص می دهد.
operator= ( Player && move_from)
این مقدار Player را با انتقال یک مقدار دیگر به آن اختصاص می دهد.

توابع عمومی

AvatarUrl

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

نشانی اینترنتی محل قرارگیری تصویر آواتار این بازیکن را برمی‌گرداند.

پارامتر ImageResolution وضوح تصویر را مشخص می کند. Player::Valid() باید true را برگرداند تا این تابع قابل استفاده باشد.

سطح فعلی

const PlayerLevel & CurrentLevel() const 

در صورت شناخته شدن، داده های سطح فعلی را برای این بازیکن بازیابی می کند.

اگر HasLevelInfo() false را برگرداند، یک شی PlayerLevel که Valid() نیز false را برمی گرداند.

CurrentXP

uint64_t CurrentXP() const 

مجموع XP فعلی بازیکن را بازیابی می کند.

اگر HasLevelInfo() false را برگرداند، صفر برمی گردد. اگر HasLevelInfo() true را برگرداند، مجموع XP فعلی بازیکن در محدوده CurrentLevel() .MinimumXP تا CurrentLevel() .MaximumXP خواهد بود.

HasLevelInfo

bool HasLevelInfo() const 

نشان می دهد که آیا این بازیکن اطلاعات سطح در دسترس را داشته باشد یا خیر.

اگر false را برگرداند، CurrentLevel() و NextLevel() اشیاء PlayerLevel را برمی گرداند که معتبر نیستند.

شناسه

const std::string & Id() const 

Id بازیکنی که در حال حاضر وارد سیستم شده است را برمی‌گرداند.

Player::Valid() باید true را برگرداند تا این تابع قابل استفاده باشد.

LastLevelUpTime

Timestamp LastLevelUpTime() const 

مُهر زمانی را که این بازیکن آخرین بار در آن سطح بالا رفته را بازیابی می کند.

اگر HasLevelInfo() false را برگرداند، یا اگر بازیکن هرگز سطح بالاتری نداشته باشد، صفر (عصر) را برمی‌گرداند.

نام

const std::string & Name() const 

نام Google+‎ پخش‌کننده‌ای را که در حال حاضر وارد سیستم شده‌اید برمی‌گرداند.

Player::Valid() باید true را برگرداند تا این تابع قابل استفاده باشد.

مرحله ی بعد

const PlayerLevel & NextLevel() const 

داده های سطح بعدی را برای این بازیکن، در صورت شناخته شدن، بازیابی می کند.

اگر HasLevelInfo() false را برگرداند، یک شی PlayerLevel که Valid() نیز false را برمی گرداند. این سطحی است که بازیکن در حال حاضر برای رسیدن به آن تلاش می کند. اگر بازیکن از قبل در حداکثر سطحی باشد که می‌تواند به آن برسد، CurrentLevel() و NextLevel() مقادیر یکسانی را برمی‌گردانند.

بازیکن

 Player()

بازیکن

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

یک Player از shared_ptr به PlayerImpl می سازد.

برای استفاده داخلی توسط API در نظر گرفته شده است.

بازیکن

 Player(
  const Player & copy_from
)

یک کپی از یک پخش کننده موجود ایجاد می کند.

بازیکن

 Player(
  Player && move_from
)

یک بازیکن موجود را به یک بازیکن جدید منتقل می کند.

عنوان

const std::string & Title() const 

عنوان بازیکن را بازیابی می کند.

این بر اساس اقداماتی است که بازیکن در سراسر اکوسیستم بازی‌های Google Play انجام داده است. توجه داشته باشید که همه بازیکنان عنوان ندارند و ممکن است عنوان یک بازیکن در طول زمان تغییر کند. اگر یک بازیکن عنوانی نداشته باشد، Title() یک رشته خالی برمی گرداند.

معتبر

bool Valid() const 

زمانی که پخش کننده برگشتی پر از داده باشد و با وضعیت پاسخ موفقیت آمیز همراه باشد، مقدار true را برمی گرداند. برای پخش‌کننده‌ای که کاربر ایجاد کرده است نادرست است یا برای پخش‌کننده‌ای که با وضعیت پاسخ ناموفق همراه است.

برای اینکه توابع دریافت کننده در این شیء قابل استفاده باشند باید مقدار true را برگرداند.

اپراتور=

Player & operator=(
  const Player & copy_from
)

این بازیکن را با کپی کردن از یک بازیکن دیگر اختصاص می دهد.

اپراتور=

Player & operator=(
  Player && move_from
)

این مقدار Player را با انتقال یک مقدار دیگر به آن اختصاص می دهد.

~بازیکن

 ~Player()