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

الدوال العامة

الإنجاز

 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 

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

ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.

الوصف

const std::string & Description() const 

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

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

رقم التعريف

const std::string & Id() const 

تعرض السلسلة الفريدة التي أنشأتها وحدة تحكم مطوّري البرامج في Google Play مسبقًا.

استخدِم هذا المعرّف للإشارة إلى إنجاز في برنامج لعبتك. ولا يمكن طلبها إلا عندما تكون قيمة الإنجازات::سلة() صحيحة.

LastModified

Timestamp LastModified() const 

تمت إزالة هذا العمود. اختر LastModifiedTime.

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()