gpg:: مشغّل
#include <player.h>
يشير ذلك المصطلح إلى بنية بيانات تتيح لك الوصول إلى بيانات حول لاعب معيّن.
ملخّص
الشركات المصنّعة والمُصنّعة |
|
---|---|
Player()
|
|
Player(std::shared_ptr< const PlayerImpl > impl)
|
|
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
.
مخصص للاستخدام الداخلي من خلال واجهة برمجة التطبيقات.
العنوان
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()