gpg::Achievement

#include <achievement.h>

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

ملخّص

تتألف البيانات من نوعَين: خاص بالمستخدم (على سبيل المثال، ما إذا كان المستخدم قد فتح قفل الإنجاز وما إلى ذلك) وعام (مثل اسم الإنجاز).

الشركات المصنّعة والمُصنّعة
Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl)
تنشئ إنجازًا من shared_ptr إلى AchievementImpl.وهو مخصَّص للاستخدام الداخلي من خلال واجهة برمجة التطبيقات.
Achievement(const Achievement & copy_from)
إنشاء نسخة من إنجاز حالي
Achievement(Achievement && move_from)
نقل إنجاز حالي
~Achievement()

وظائف عامة
CurrentSteps() const
uint32_t
يعرض عدد الخطوات التي اتّخذها اللاعب نحو فتح إنجاز متزايد.
Description() const
const std::string &
تعرض وصفًا موجزًا لإنجازك.
Id() const
const std::string &
عرض السلسلة الفريدة التي أنشأتها Google Play Console مسبقًا.
LastModified() const تمت إزالة هذا العمود. أفضّل LastLastTime.
LastModifiedTime() const
يعرض الوقت الذي تم فيه آخر تعديل على الإدخال (يتم التعبير عنه بالمللي ثانية منذ حقبة يونكس).
Name() const
const std::string &
تعرض الاسم المختصر للإنجاز.
RevealedIconUrl() const
const std::string &
تعرض عنوان URL الذي يؤدي إلى صورة الرمز الذي تم إظهاره لهذا الإنجاز.
State() const
عرض حالة الإنجاز: HIDDEN أو REVEALED أو UNLOCKED
TotalSteps() const
uint32_t
تعرض إجمالي عدد الخطوات المطلوبة للاعب من أجل تحقيق إنجاز متزايد معيّن.
Type() const
عرض نوع الإنجاز: INCREMENTAL أو STANDARD.
UnlockedIconUrl() const
const std::string &
يعرض عنوان URL الذي يؤدي إلى صورة رمز فتح القفل لهذا الإنجاز.
Valid() const
bool
تعرض القيمة "صحيح" عندما تتم تعبئة الإنجاز المعروض ببيانات وتكون مصحوبة بحالة استجابة ناجحة. القيمة "خطأ" لإنجازات أنشأها المستخدم لم تتم تعبئتها أو لإنجاز مهمة تمت تعبئتها مصحوبة بحالة استجابة "غير ناجحة".
XP() const
uint64_t
عدد نقاط الخبرة التي يمنحها هذا الإنجاز.
operator=(const Achievement & copy_from)
يمكنك تحديد هذا الإنجاز من خلال نسخه من إنجاز آخر.
operator=(Achievement && move_from)
يمكنك تعيين هذا الإنجاز من خلال نقل هدف آخر إليه.

وظائف عامة

الإنجاز

 Achievement()

الإنجاز

 Achievement(
  std::shared_ptr< const AchievementImpl > impl
)

تنشئ إنجازًا من shared_ptr إلى AchievementImpl.وهو مخصَّص للاستخدام الداخلي من خلال واجهة برمجة التطبيقات.

الإنجاز

 Achievement(
  const Achievement & copy_from
)

إنشاء نسخة من إنجاز حالي

الإنجاز

 Achievement(
  Achievement && move_from
)

نقل إنجاز حالي

CurrentSteps

uint32_t CurrentSteps() const

يعرض عدد الخطوات التي اتّخذها اللاعب نحو فتح إنجاز متزايد.

ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

الوصف

const std::string & Description() const

تعرض وصفًا موجزًا لإنجازك.

عادة ما تخبر اللاعب بكيفية تحقيق الإنجاز. حتى 500 حرف. ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

Id

const std::string & Id() const

عرض السلسلة الفريدة التي أنشأتها Google Play Console مسبقًا.

يمكنك استخدامها للإشارة إلى إنجاز في برنامج لعبتك. ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

LastModified

Timestamp LastModified() const

تمت إزالة هذا العمود. أفضّل LastLastTime.

LastModifiedTime

Timestamp LastModifiedTime() const

يعرض الوقت الذي تم فيه آخر تعديل على الإدخال (يتم التعبير عنه بالمللي ثانية منذ حقبة يونكس).

ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

الاسم

const std::string & Name() const

تعرض الاسم المختصر للإنجاز.

حتى 100 حرف. ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

RevealedIconUrl

const std::string & RevealedIconUrl() const

تعرض عنوان URL الذي يؤدي إلى صورة الرمز الذي تم إظهاره لهذا الإنجاز.

يهدف هذا الرمز إلى أن يظهر عند الكشف عن الإنجاز، ولكن لم يتم فتح قفله بعد. لا يمكن استدعاء هذه الدالة إلا عندما تعرض الدالة Achievement::Valid() القيمة true.

الحالة

AchievementState State() const

عرض حالة الإنجاز: HIDDEN أو REVEALED أو UNLOCKED

ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true. يمكنك الاطّلاع على مزيد من المعلومات هنا.

TotalSteps

uint32_t TotalSteps() const

تعرض إجمالي عدد الخطوات المطلوبة للاعب من أجل تحقيق إنجاز متزايد معيّن.

ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

النوع

AchievementType Type() const

عرض نوع الإنجاز: INCREMENTAL أو STANDARD.

ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true. يمكنك الاطّلاع على مزيد من المعلومات هنا.

UnlockedIconUrl

const std::string & UnlockedIconUrl() const

يعرض عنوان URL الذي يؤدي إلى صورة رمز فتح القفل لهذا الإنجاز.

يهدف هذا الرمز إلى الظهور عند فتح قفل الإنجاز (وبالتالي الكشف عنه أيضًا). لا يمكن استدعاء هذه الدالة إلا عندما تكون الدالة Achievement::Valid() هي قيمة صحيحة.

صحيح

bool Valid() const

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

يجب أن يكون هذا صحيحًا بالنسبة إلى دوال getter في هذا الإنجاز (رقم التعريف، الاسم، الوصف، إلخ.) لتكون قابلة للاستخدام.

XP

uint64_t XP() const

عدد نقاط الخبرة التي يمنحها هذا الإنجاز.

ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.

operator=

Achievement & operator=(
  const Achievement & copy_from
)

يمكنك تحديد هذا الإنجاز من خلال نسخه من إنجاز آخر.

operator=

Achievement & operator=(
  Achievement && move_from
)

يمكنك تعيين هذا الإنجاز من خلال نقل هدف آخر إليه.

~Achievement

 ~Achievement()