الإنجازات

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إرسال ملاحظات

يمكن أن تكون الإنجازات طريقة رائعة لزيادة تفاعل المستخدمين في لعبتك. يمكنك إضافة إنجازات إلى لعبتك لتشجيع اللاعبين على تجربة ميزات قد لا يستخدمونها عادةً، أو على التعامل مع لعبتك بأنماط لعب مختلفة تمامًا. يمكن أن تكون الإنجازات أيضًا طريقة ممتعة لمقارنة تقدّم اللاعبين مع بعضهم البعض والمشاركة في مسابقة مرحة.

للتعرّف على كيفية تنفيذ الإنجازات لمنصتك، اطّلِع على عمليات تنفيذ العميل.

السمات

لفهم آلية عمل الإنجازات، عليك التعرّف على بعض السمات المرتبطة بها.

ترتبط هذه العناصر الأساسية بكل إنجاز:

• Id هو سلسلة فريدة يتم إنشاؤها بواسطة Google Play Console. ستستخدم هذا المعرّف الفريد للإشارة إلى الإنجاز في عملاء لعبتك.
• الاسم هو اسم مختصر للإنجاز (مثل "رجل الفطائر"). يمكن أن تضم قيمة العنصر 100 حرف كحد أقصى.
• الوصف هو وصف موجز عن إنجازك. عادةً ما يوضّح هذا الوصف للاعب كيفية تحقيق الإنجاز (على سبيل المثال، "خبز فطيرة ليمون مع المرينغ قبل غروب الشمس"). يمكن أن تحتوي القيمة على 500 حرف كحد أقصى.
• الرمز هو رمز مربّع مرتبط بإنجازك. للاطّلاع على أفضل الممارسات عند إنشاء رموز الإنجازات، راجِع قسم إرشادات الأيقونات.
• ترتيب القائمة هو الترتيب الذي تظهر به الإنجازات المُقفَلة عندما يعرض أحد اللاعبين الإنجازات المرتبطة بلعبتك. ويمكن أن يكون ذلك بأي ترتيب تريده. تظهر الإنجازات التي تم تحقيقها في أعلى القائمة بالترتيب الذي تم تحقيقها به.

الولاية

يمكن أن تكون الإنجازات في إحدى الحالات الثلاث التالية:

• يعني الإنجاز الخفي أنّ تفاصيل الإنجاز مخفية عن اللاعب. توفّر "خدمات ألعاب Google Play" عنصرًا نائبًا عامًا ووصفًا ورمزًا للإنجاز عندما يكون في حالة مخفية. ننصح بإخفاء الإنجاز إذا كان يتضمّن معلومات مُفجّأة لا تريد revealed إظهارها عن لعبتك في وقت مبكر جدًا (على سبيل المثال، "اكتشاف أنّك كنت شبحًا طوال الوقت").
• يشير الإنجاز المُعلَن عنه إلى أنّ اللاعب يعرف عن الإنجاز، ولكنّه لم يحصل عليه بعد. تبدأ معظم الإنجازات في الحالة المكشوفة.
• يعني الإنجاز المُحقَّق أنّ اللاعب قد حصل على الإنجاز بنجاح. يمكن تحقيق إنجاز بلا اتصال بالإنترنت. عندما تصبح اللعبة متاحة على الإنترنت، تتم مزامنتها مع "خدمات ألعاب Play" لتعديل حالة الإنجاز المُستلَم.

إنجازات تدريجية

يمكن تصنيف الإنجازات على أنّها عادية أو متزايدة. بشكل عام، يتطلب الإنجاز المتصاعد من اللاعب تحقيق تقدّم تدريجي نحو تحقيق الإنجاز على مدار فترة زمنية أطول. وعندما يحرز اللاعب تقدّمًا نحو الإنجاز التدريجي، يمكنك إبلاغ "خدمات ألعاب Play" بتقدّمه الجزئي.

تتتبّع خدمة Google Play معلومات مستوى التقدّم، وتُرسِل تنبيهًا إلى اللعبة عندما يستوفي اللاعب المعايير اللازمة لتحقيق هذا الإنجاز، و تُعلمه بمدى تقدّمه نحو تحقيق هذا الهدف.

إنّ الإنجازات المتزايدة تراكمية على مستوى جلسات اللعب، ولا يمكن إزالة مستوى التقدّم أو إعادة ضبطه من داخل اللعبة. على سبيل المثال، "الفوز في 50 لعبة" يُعدّ إنجازًا تدريجيًا. ولن يكون "تحقيق الفوز في 3 مباريات متتالية" مناسبًا، لأنّه سيتم إعادة ضبط مستوى تقدّم اللاعب عند خسارة مباراة. ولن تكون عبارة "امتلاك 5,000 قطعة باور بوكر" مؤهّلة أيضًا، لأنّ اللاعب يمكنه كسب القطع وخسارتها أثناء اللعب. بالنسبة إلى الإنجازات الأخيرَين، عليك تتبُّع حالة "الفوز على التوالي" أو إجمالي عدد الشرائح لدى اللاعب وفتح الإنجازات العادية عندما يحقّقها اللاعب.

عند إنشاء إنجاز تراكمي، عليك تحديد إجمالي عدد الخطوات المطلوبة لتحقيقه (يجب أن يكون هذا الرقم بين 2 و10,000). بينما يحقق المستخدم تقدّمًا نحو تحقيق الإنجاز، عليك الإبلاغ عن عدد الخطوات الإضافية التي اتّخذها المستخدم في "خدمات ألعاب Play". بعد أن يصل العدد الإجمالي للخطوات إلى قيمة الفتح، يتم فتح الإنجاز (حتى إذا كان مخفيًا). لست بحاجة إلى تخزين التقدّم التراكمية للمستخدم.

النقاط

ترتبط الإنجازات بقيمة نقاط. يجب أن تكون نتيجة اللاعب مضاعفة 5، ولا يمكن أن تحصل أي لعبة على أكثر من 1,000 نقطة في مجموع جميع إنجازاتها (على الرغم من أنّه يمكن أن تحصل على عدد أقل). بالإضافة إلى ذلك، لا يمكن أن يحصل أي إنجاز على أكثر من 200 نقطة.

تتبُّع مكافآت الخبرة (XP)

يمكن للّاعبين الانتقال إلى مستويات أعلى في ملفّاتهم الشخصية على الألعاب عند تحقيق إنجازات في الألعاب المتوافقة مع "ألعاب Play". مقابل كل نقطة مرتبطة بأحد الإنجازات، يحصل اللاعب على 100 نقطة خبرة عند تحقيقه هذا الإنجاز. بعبارة أخرى:

XP for an achievement = 100 * (point value for the achievement)

تتتبّع خدمات "ألعاب Play" عدد النقاط التي يحصل عليها كل لاعب وتُرسِل إعلامًا إلى تطبيق "ألعاب Google Play" عندما يحصل اللاعب على نقاط كافية "لرفع مستوى شخصيته". يمكن للاعبين الاطّلاع على مستوى حساباتهم وسجلّ نقاط الخبرة من صفحة "الملف الشخصي" في تطبيق "ألعاب Play".

الحد الأدنى من الإنجازات

يجب أن تتضمّن اللعبة التي توفّر إنجازات خمسة إنجازات على الأقل قبل نشرها. يمكنك إجراء الاختبار باستخدام عدد أقل من خمسة إنجازات، ولكن ننصح بإنشاء خمسة إنجازات على الأقل قبل نشر لعبتك.

الحد الأقصى للإنجازات

يقتصر عدد الإنجازات على حدود النقاط وتوزيعها. وبما أنّ الحد الأقصى لعدد النقاط هو 1,000 نقطة، وبما أنّ كل إنجاز يحصل على 5 نقاط، فإنّ الحد الأقصى لعدد الإنجازات هو 200 إنجاز. ومع ذلك، إذا تم منح الإنجازات نقاطًا إضافية، سينخفض عدد الإنجازات المتاحة نتيجةً لذلك.

إضافة إنجازات

هناك طريقتان لإنشاء الإنجازات لأول مرة باستخدام Google Play Console:

• إنشاء إنجاز: أضِف التعريفات والبيانات الوصفية لكل إنجاز بدوره.
• استيراد الإنجازات: استيراد التعريفات وغيرها من البيانات الوصفية لإنجازات متعددة معًا في خطوة واحدة

إنشاء إنجاز

لإنشاء إنجاز للعبة جديدة لم يتم نشرها، يُرجى إكمال الخطوات التالية:

1. في Google Play Console، اختَر لعبة.
2. في صفحة خدمات ألعاب Google Play - الإنجازات (النمو > خدمات ألعاب Google Play > الإعداد والإدارة > الإنجازات)، اختَر إنشاء إنجاز.
3. في صفحة إضافة إنجازات، املأ النموذج.
4. انقر على الحفظ كمسودة.
5. بعد إنشاء إنجاز، عليك نشر لعبتك.

إضافة المزيد من الإنجازات

إذا كان لديك إنجازات حالية وتريد إضافة المزيد:

1. في Google Play Console، اختَر لعبة.
2. في صفحة خدمات ألعاب Google Play - الإنجازات (نمو > خدمات ألعاب Google Play > الإعداد والإدارة > الإنجازات)، اختَر إضافة إنجازات.

استيراد الإنجازات

لإضافة عدة إنجازات إلى لعبتك في آنٍ واحد، اتّبِع الخطوات التالية:

1. أنشئ ملفًا مضغوطًا يحتوي على إنجازاتك.
2. حمّل الملف.

لمزيد من المعلومات عن ملف zip، يُرجى الاطّلاع على إرشادات ملفات zip.

لاستيراد الإنجازات:

1. في Google Play Console، اختَر لعبة.
2. في صفحة خدمات ألعاب Google Play - الإنجازات (النمو > خدمات ألعاب Google Play > الإعداد والإدارة > الإنجازات)، اختَر استيراد الإنجازات.
3. في صفحة استيراد الإنجازات، انقر على تحميل.
4. اختَر ملف zip الذي تريد تحميله.
5. انقر على الحفظ كمسودة.
6. بعد استيراد الإنجازات، عليك نشر لعبتك.

نشر اللعبة

بعد اختبار لعبتك ونشرها، يتم نشر جميع إنجازات لعبتك معها.

تعديل إنجاز

لتعديل إنجاز سبق لك إنشاؤه، اختَر الإنجاز في علامة التبويب الإنجازات في Google Play Console. في هذه المرحلة، سيظهر لك النموذج نفسه الذي استخدمته عند إنشاء الإنجاز لأول مرة، ويمكنك تعديل أي من الحقول حسب الحاجة.

عند الانتهاء من تعديل إنجاز، انقر على الزر الحفظ كمسودة. سيكون الإنجاز الذي تم تعديله حديثًا في مرحلة "جاهز للاختبار"، وسيكون بإمكانك تجربته. إذا كان يعمل بشكل صحيح، اختَر إعادة النشر من القائمة المنسدلة. يؤدي ذلك إلى إعادة نشر لعبتك للجميع، بالإضافة إلى كل إنجازاتك المعدَّلة.

التراجع عن التعديل

إذا قررت أنّ الإنجاز الحالي لا يعجبك وأردت الرجوع إلى إنجازك بالشكل الذي كان عليه من قبل، انقر على الرجوع من القائمة المنسدلة في Google Play Console، وستتم إعادة جميع إنجازاتك إلى الإصدار الذي تم نشره سابقًا.

حذف إنجاز

بعد نشر إنجازك، لا يمكن حذفه.

لا يمكنك حذف إنجاز في حالة النشر المُسبَق إلا من خلال النقر على الزر حذف في أسفل نموذج هذا الإنجاز.

إعادة ضبط إنجاز

لا يمكنك إعادة ضبط بيانات مستوى تقدّم اللاعبين إلا في ما يتعلّق بالإنجازات التي تحت الإنشاء.

• لإعادة ضبط الإنجازات في Google Play Console، انقر على الزر إعادة ضبط مستوى تقدّم الإنجازات في أسفل نموذج هذا الحدث.
• لإعادة ضبط بيانات الإنجازات آليًا، يمكنك استدعاء طرق Management API Achievements.

إرشادات حول الرموز

يجب إنشاء الرموز بتنسيق PNG أو JPEG أو JPG بدقة 512 × 512 بكسل. ما عليك سوى تزويدنا برمز الإنجاز الذي تم فتحه. سننشئ تلقائيًا نسخة بالأبيض والأسود للرمز المعروض. لهذا السبب، ننصحك بأن تشمل رموز الإنجازات عناصر ملونة، حتى يتمكّن المستخدمون من التفريق بين الإنجازات التي تم الكشف عنها والتي تم فتحها.

عند عرض رمز إنجاز في إشعار Android، يتم وضع رمز دوار فوق الرمز ويتم إخفاء زواياه الخارجية. تأكَّد من أنّ رمزك لا يزال يُظهر شكلًا جيدًا في هذه الظروف.

يتم استخدام الرمز نفسه في جميع اللغات، لذا ننصحك بعدم تضمين أي نص أو محتوى مترجَم في الرمز.

إرشادات ملفات ZIP

يمكنك استيراد إنجازات متعددة في آنٍ واحد باستخدام ملف zip. راجِع جدول أسماء الملفات الدقيقة التي يجب استخدامها في ملف zip:

متطلبات ملف ZIP:

• لا تتضمّن أي أدلة فرعية.
• أسماء ملفات فريدة
• ملفات CSV أو PNG أو JPEG أو JPG فقط
• يجب ألا تحتوي ملفات CSV على صف للرؤوس.
• يجب ألا يزيد حجم كل ملف عن 1 ميغابايت.
• يجب ألا يحتوي ملف zip على أكثر من 203 ملفات.
• يجب أن يكون إجمالي حجم ملف zip أقل من 200 ميغابايت.

تنسيق ملف AchievementsMetadata.csv

يحتوي ملف AchievementsMetadata.csv على البيانات الوصفية لكل إنجاز. يجب أن يتضمّن الملف المعلومات كقيم مفصولة بفواصل بالترتيب التالي:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

يتم وصف هذه الحقول في الجدول التالي:

متطلبات ملف AchievementsMetadata.csv:

• يجب أن يحتوي كل صف على سبع قيم. إذا أردت حذف قيمة، اترك الحقل فارغًا.
• يتم استخدام الحقلين Name وDescription كلغة تلقائية.
• يجب أن يكون الحقل Name فريدًا في جميع الإنجازات.
• يجب ألّا تحتوي الحقول التالية على فواصل: Name وDescription.

نموذج ملف AchievementsMetadata.csv:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

تنسيق AchievementsLocalizations.csv

ملف AchievementsLocalizations.csv هو ملف اختياري يُعدّ جميع البيانات اللازمة لوصف كل إنجاز للمستخدمين بلغات مختلفة. تتم ترجمة الإنجازات بما يتوافق مع اللغات المحدّدة للعبة.

يجب أن يتضمّن الملف المعلومات كقيم مفصولة بفواصل بالترتيب التالي:

   Name, Localized name, Localized description, locale

يتم وصف هذه الحقول في الجدول التالي:

متطلبات ملف AchievementsLocalizations.csv:

• يجب أن تكون أسماء الإنجازات في اللعبة فريدة لكل لغة. على سبيل المثال، إذا كانت اللعبة تتيح استخدام اللغتَين en-US وfr-FR، يمكن أيضًا تسمية إنجاز بـ "Achievement1" للغة en-US و "Achievement1" للغة fr-FR.
• يجب أن يحتوي كل صف على أربع قيم. إذا أردت حذف قيمة Localized description، اترك الحقل فارغًا.

نموذج ملف AchievementsLocalizations.csv:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

تنسيق AchievementsIconMappings.csv

ملف AchievementsIconMappings.csv هو ملف اختياري يُستخدَم لربط إنجازاتك بالرمز المحدّد. يجب أن يتضمّن الملف المعلومات على شكل قيم مفصولة بفواصل بالترتيب التالي:

Name, icon filename

يتم وصف هذه الحقول في الجدول التالي:

متطلبات ملف AchievementsIconMappings.csv:

• يجب أن يحتوي كل صف على قيمتَين.
• يمكن أن تكون ملفات الرموز بتنسيق PNG أو JPEG فقط.

نموذج ملفAchievementsIconMappings.csv:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

ملفات الرموز

يجب أن تكون الرموز التي تشير إليها في ملف AchievementsIconMappings.csv متوفّرة في أرشيف ZIP الحالي الذي تستورده. لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات الرموز.

إضافة ترجمات للإنجازات

يمكنك تحديد ترجماتك الخاصة للإنجازات المرتبطة بلعبتك. قبل إجراء ذلك، تأكَّد أولاً من إكمال الخطوات الموضّحة في مقالة إضافة ترجمات للعبة.

تتوفّر طريقتان لإضافة ترجمات للعبة:

• يمكنك استخدام خيار استيراد الإنجازات لتحميل translations لعدة إنجازات جديدة في آنٍ واحد. لا يمكنك استخدام هذا الخيار لتحميل ترجمات الإنجازات الحالية.

• يمكنك إضافة ترجمات لكل إنجاز في لعبتك. لإضافة ترجمة خاصة بك لكل إنجاز:

  1. في Google Play Console، افتح علامة التبويب الإنجازات ل لعبتك، ثم اختَر إنجازًا حاليًا.
  2. في صفحة تفاصيل الإنجازات، اختَر علامة التبويب للغة التي سبق أن أضفتها في علامة التبويب تفاصيل اللعبة.
  3. في صفحة تفاصيل الإنجاز لهذه اللغة، عدِّل النموذج باستخدام ترجماتك لهذا الإنجاز.
  4. انقر على حفظ لتخزين تفاصيل الإنجازات المترجَمة.

عمليات تنفيذ العميل

للتعرّف على كيفية تنفيذ الإنجازات لمنصّتك، اطّلِع على المراجع التالية:

• Android
• Unity
• الويب
• أفضل الممارسات لتنفيذ الإنجازات