gpg::مشغّل

#include <player.h>

يشير ذلك المصطلح إلى بنية بيانات تتيح لك الوصول إلى بيانات حول لاعب معيّن.

ملخّص

الشركات المصنّعة والمُصنّعة
Player()
Player(std::shared_ptr< const PlayerImpl > impl)
لإنشاء مشغِّل من shared_ptr إلى PlayerImpl.
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
تعرض القيمة "صحيح" عندما يكون المشغّل المعروض مملوءًا بالبيانات وتكون مصحوبة بحالة استجابة ناجحة. تشير القيمة "false" إلى مشغّل لم تتم تعبئته بواسطة المستخدم أو لمشغِّل تمت تعبئته مصحوبًا بحالة استجابة غير ناجحة.
operator=(const Player & copy_from)
Player &
يتم تحديد هذا المشغّل من خلال النسخ من لاعب آخر.
operator=(Player && move_from)
Player &
يعيّن قيمة المشغّل هذه من خلال نقل قيمة أخرى إليها.

وظائف عامة

AvatarUrl

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

يعرض عنوان URL الذي تظهر فيه الصورة الرمزية لهذا اللاعب.

تحدّد مَعلمة ImageResolution درجة دقّة الصورة. يجب أن تعرض الدالة Player::Valid() القيمة "صحيح" لهذه الدالة لتكون قابلة للاستخدام.

CurrentLevel

const PlayerLevel & CurrentLevel() const

لاسترداد بيانات المستوى الحالي لهذا اللاعب، إذا كان معروفًا

إذا عرضت الدالة HasLevelInfo() القيمة false، سيؤدي ذلك إلى عرض كائن PlayerLevel الذي تعرض له Valid() القيمة false أيضًا.

CurrentXP

uint64_t CurrentXP() const

لاسترداد إجمالي XP الحالي للّاعب.

إذا عرضت HasLevelInfo() القيمة false، سيكون ناتج هذه القيمة صفرًا. إذا تم عرض قيمة HasLevelInfo() على القيمة "صحيح"، سيكون إجمالي نقاط XP الخاصة بالمشغّل ضمن النطاق CurrentLevel().MinXP إلى CurrentLevel().الحد الأقصى XP.

HasLevelInfo

bool HasLevelInfo() const

لعرض ما إذا كانت معلومات المستوى متاحة لهذا اللاعب أم لا.

وإذا كان ناتجها خطأ، سيعرض CurrentLevel() وNextLevel() كائنات غير صالحة PlayerLevel.

Id

const std::string & Id() const

عرض Id للمشغّل المسجّل الدخول إليه حاليًا.

يجب أن تعرض الدالة Player::Valid() القيمة "صحيح" لهذه الدالة لتكون قابلة للاستخدام.

LastLevelUpTime

Timestamp LastLevelUpTime() const

يسترد الطابع الزمني الذي ارتقى فيه هذا اللاعب إلى مستوى أعلى.

إذا عرض HasLevelInfo() القيمة false أو إذا لم ينتقل اللاعب إلى مستوى أعلى من قبل، سيتم عرض صفر (الحقبة).

الاسم

const std::string & Name() const

عرض اسم Google+ للمشغّل الذي سجّلت الدخول إليه حاليًا.

يجب أن تعرض الدالة Player::Valid() القيمة "صحيح" لهذه الدالة لتكون قابلة للاستخدام.

NextLevel

const PlayerLevel & NextLevel() const

لاسترداد بيانات المستوى التالي لهذا اللاعب، إذا كان معروفًا

إذا عرضت الدالة HasLevelInfo() القيمة false، سيؤدي ذلك إلى عرض كائن PlayerLevel الذي تعرض له Valid() القيمة false أيضًا. هذا هو المستوى الذي يسعى اللاعب للوصول إليه حاليًا. إذا كان المشغّل قد بلغ الحد الأقصى الذي يمكنه الوصول إليه، ستعرض CurrentLevel() وNextLevel() قيمًا متطابقة.

اللاعب

 Player()

اللاعب

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

لإنشاء مشغِّل من shared_ptr إلى PlayerImpl.

مخصص للاستخدام الداخلي من خلال واجهة برمجة التطبيقات.

اللاعب

 Player(
  const Player & copy_from
)

إنشاء نسخة من مشغِّل حالي

اللاعب

 Player(
  Player && move_from
)

نقل مشغِّل حالي إلى لاعب جديد

العنوان

const std::string & Title() const

يسترد عنوان المشغّل.

يستند ذلك إلى الإجراءات التي اتخذها اللاعب في المنظومة المتكاملة لألعاب Google Play. يُرجى ملاحظة أنّ ليس كلّ اللاعبين يملكون ألقابًا، وأنّ عنوان اللاعب قد يتغيّر بمرور الوقت. إذا لم يكن للمشغّل عنوانًا، سيعرض Title() سلسلة فارغة.

صحيح

bool Valid() const

تعرض القيمة "صحيح" عندما يكون المشغّل المعروض مملوءًا بالبيانات وتكون مصحوبة بحالة استجابة ناجحة. تشير القيمة "false" إلى مشغّل لم تتم تعبئته بواسطة المستخدم أو لمشغِّل تمت تعبئته مصحوبًا بحالة استجابة غير ناجحة.

يجب أن يكون ناتج هذه العملية صحيحًا حتى تكون دوال getter في هذا الكائن قابلة للاستخدام.

operator=

Player & operator=(
  const Player & copy_from
)

يتم تحديد هذا المشغّل من خلال النسخ من لاعب آخر.

operator=

Player & operator=(
  Player && move_from
)

يعيّن قيمة المشغّل هذه من خلال نقل قيمة أخرى إليها.

~اللاعب

 ~Player()