gpg:: الإنجاز
#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 مسبقًا.
|
LastModified() const
|
تمت إزالة هذا العمود. اختر LastModifiedTime. |
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
لعرض عدد الخطوات التي اتخذها اللاعب نحو فتح إنجاز إضافي.
ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
الوصف
const std::string & Description() const
تعرض وصفًا موجزًا لإنجازك.
يخبر اللاعب عادةً بكيفية تحقيق الإنجاز. حتى 500 حرف. ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
رقم التعريف
const std::string & Id() const
تعرض السلسلة الفريدة التي أنشأتها وحدة تحكم مطوّري البرامج في Google Play مسبقًا.
استخدِم هذا المعرّف للإشارة إلى إنجاز في برنامج لعبتك. ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
LastModifiedTime
Timestamp LastModifiedTime() const
لعرض الوقت الذي تم فيه إجراء آخر تعديل على الإدخال (يتم التعبير عنه بالمللي ثانية منذ حقبة يونكس).
ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
الاسم
const std::string & Name() const
لعرض الاسم المختصر للإنجاز.
حتى 100 حرف. ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
RevealedIconUrl
const std::string & RevealedIconUrl() const
تعرض عنوان URL الذي يؤدي إلى صورة الرمز الذي تم الكشف عنه للإنجاز هذا.
ويظهر هذا الرمز عند الكشف عن الإنجاز، ولكن لم يتم فتح قفله بعد. لا يمكن استدعاء هذه الدالة إلا عندما تكون الإنجازات::سلة() صحيحة.
الحالة
AchievementState State() const
عرض حالة الإنجاز: HIDDEN
أو REVEALED
أو UNLOCKED
ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة. يمكنك الاطّلاع على مزيد من المعلومات هنا.
TotalSteps
uint32_t TotalSteps() const
لعرض إجمالي عدد الخطوات المطلوبة للّاعب من أجل فتح إنجاز إضافي معيّن.
ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
Type
AchievementType Type() const
لعرض نوع الإنجاز: INCREMENTAL
أو STANDARD
ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة. يمكنك الاطّلاع على مزيد من المعلومات هنا.
UnlockedIconUrl
const std::string & UnlockedIconUrl() const
يتم عرض عنوان URL الذي يؤدي إلى صورة رمز فتح قفل الإنجاز هذا.
يتم عرض هذا الرمز عند فتح قفل الإنجاز (وبالتالي يتم الكشف عنه أيضًا). لا يمكن استدعاء هذه الدالة إلا عندما تكون الإنجازات::سلة() صحيحة.
صالحة
bool Valid() const
تعرض القيمة "صحيح" عندما تتم تعبئة الإنجاز الذي تم إرجاعه ببيانات ويكون مصحوبةً بحالة استجابة ناجحة، أو القيمة "خطأ" لإنجاز لم ينشئه المستخدم أو لإنجاز مملوء مصحوب بحالة استجابة غير ناجحة.
يجب أن يكون صحيحًا بالنسبة إلى دوال getter في هذا الإنجاز (المعرّف، والاسم، والوصف، وما إلى ذلك) لتكون قابلة للاستخدام.
XP
uint64_t XP() const
عدد نقاط الخبرة التي يمنحها هذا الإنجاز.
ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.
r=or
Achievement & operator=( const Achievement & copy_from )
يمكن تعيين هذا الإنجاز من خلال نسخه من إنجاز آخر.
r=or
Achievement & operator=( Achievement && move_from )
يتم تعيين هذا الإنجاز من خلال نقل إنجاز آخر إليه.
~الإنجاز
~Achievement()