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	Timestamp لاسترداد الطابع الزمني الذي انتقل فيه هذا اللاعب إلى مستوى أعلى.
Name() const	const std::string & لعرض اسم +Google للمشغل الذي تم تسجيل الدخول إليه حاليًا.
NextLevel() const	const PlayerLevel & استرداد بيانات المستوى التالي لهذا اللاعب، إذا كانت معروفة.
Title() const	const std::string & لاسترداد عنوان المشغِّل.
Valid() const	bool تعرض القيمة "صحيح" عندما يكون المشغّل الذي تم عرضه مملوءًا ببيانات ويكون مصحوبة بحالة استجابة ناجحة، أو خطأ لمشغّل لم ينشئه المستخدم أو لمشغّل مملوء مصحوب بحالة استجابة غير ناجحة.
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، سيؤدي ذلك إلى عرض كائن PlayerLevel الذي تُرجع له Source() أيضًا false.

CurrentXP

uint64_t CurrentXP() const 

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

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

HasLevelInfo

bool HasLevelInfo() const 

تعرض ما إذا كان هذا اللاعب لديه معلومات عن المستويات أم لا.

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

رقم التعريف

const std::string & Id() const 

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

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

LastLevelUpTime

Timestamp LastLevelUpTime() const 

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

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

الاسم

const std::string & Name() const 

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

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

NextLevel

const PlayerLevel & NextLevel() const 

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

إذا عرضت HasLevelInfo() false، سيؤدي ذلك إلى عرض كائن PlayerLevel الذي تُرجع له Source() أيضًا 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 

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

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

r=or

Player & operator=(
  const Player & copy_from
)

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

r=or

Player & operator=(
  Player && move_from
)

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

~لاعب

 ~Player()