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
.وهو مخصَّص للاستخدام الداخلي من خلال واجهة برمجة التطبيقات.
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.
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() القيمة true.
صحيح
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()