تشكّل لوحات الصدارة وسيلة ممتعة لزيادة المنافسة بين اللاعبين، سواء للمعجبين الأكثر وفاءً (الذين سيتنافسون على المركز الأول في قائمة الصدارة العامة) ولللاعبين العاديين الذين يهتمون بمقارنة مستوى تقدّمهم بأداء أصدقائهم.
لمعرفة كيفية تنفيذ ميزة "لوحات الصدارة" على منصتك، راجع عمليات تنفيذ العملاء.
فهم لوحات الصدارة
عند إنشاء ليدربورد، ستتولى "خدمات ألعاب Play" إدارة معظم جوانب "لوحة الصدارة" هذه نيابةً عنك. وتعمل العملية النموذجية على النحو التالي:
- في نهاية اللعبة (أو في وقت مناسب تحدده)، ترسل اللعبة نتيجة اللاعب إلى لوحة في الصدارة أو أكثر تكون قد أنشأتها لللعبة.
- وتتحقّق "خدمات ألعاب Play" ممّا إذا كانت هذه النتيجة أفضل من الرقم الذي أدخله اللاعب حاليًا في قائمة الصدارة للنتيجة اليومية أو الأسبوعية أو طوال الوقت. وإذا كان الأمر كذلك، ستعمل "خدمات ألعاب Play" على تعديل لوحات الصدارة المقابلة للنتيجة الجديدة.
- ترسِل "خدمات ألعاب Play" تقرير النتائج إلى عميل اللعبة. يخبر هذا التقرير العميل بما إذا كانت هذه نتيجة جديدة يوميًا أو أسبوعيًا أو طوال الوقت. وإذا لم تكن كذلك، ستخبر "خدمات ألعاب Play" العميل بالنتيجة اليومية أو الأسبوعية أو طوال الوقت التي سجّلها هذا اللاعب.
- لاسترداد نتائج اللاعب الخاصة بلوحة صدارة، يمكنك طلب إطار زمني (يوميًا أو أسبوعيًا أو طوال الوقت)، وتحديد ما إذا كان المستخدم يريد رؤية لوحة صدارة اجتماعية أو عامة أم لا. تُجري "خدمات ألعاب Play" كل عمليات الفلترة اللازمة، ثم تُرسِل النتائج إلى العميل مرة أخرى.
- في الحالات التي يتوفّر فيها الكثير من النتائج لإعداد تقارير بها، لا تُرسِل "خدمات ألعاب Play" سوى بيانات أعلى نتائج لوحة الصدارة. ويمكنك أيضًا استرداد بيانات النتائج الأولية لأعلى النتائج أو النتائج بجانب نتائج اللاعب.
لوحات صدارة متعددة
يمكن أن تتضمّن الألعاب عدة لوحات في الصدارة، بحد أقصى 70 لوحة. على سبيل المثال، قد توفر لعبة متعددة المستويات لوحة صدارة لكل مستوى، وقد تتضمن لعبة السباق ليدربورد منفصلاً لكل مسار.
الإطارات الزمنية في "لوحة الصدارة"
تنشئ حزمة تطوير البرامج (SDK) لألعاب Play تلقائيًا إصدارات يومية وأسبوعية وطوال الوقت لكل لوحة صدارة تنشئها. ليست هناك حاجة لإنشاء لوحات صدارة منفصلة لكل إطار زمني.
تتم إعادة ضبط قوائم الصدارة اليومية بالتوقيت العالمي المنسّق (UTC-7) (أي "منتصف الليل بتوقيت المحيط الهادئ الصيفي") طوال العام.
تتم إعادة ضبط لوحات الصدارة الأسبوعية في منتصف الليل بين السبت والأحد، وبالمنطقة الزمنية نفسها المستخدمة في لوحات الصدارة اليومية (UTC-7).
لوحات الصدارة العامة والاجتماعية
يمكن لحزمة تطوير البرامج (SDK) الخاصة بألعاب Play عرض إصدارَين مختلفَين من كل لوحة صدارة للّاعب:
ليدربورد الاجتماعية هي ليدربورد تتألف من أشخاص في دوائر المستخدمين (أو أعضاء الدوائر التي اختار المستخدم مشاركتها مع تطبيقك) قرروا مشاركة نشاطهم اللائق مع المستخدم.
لوحة الصدارة العامة هي قائمة صدارة تتألف من اللاعبين الذين اختاروا مشاركة أنشطة ألعابهم بشكل علني. إذا لم يختر لاعبك مشاركة نشاط أسلوب اللعب بشكل علني، فلن يظهر في لوحة الصدارة هذه.
عرض لوحات الصدارة
تعتني المكتبات في مكتبات عملاء الأجهزة الجوّالة بجميع تنسيقات لوحات الصدارة وعرضها. ويمكنك تحديد ما إذا كان بإمكان اللاعب رؤية لوحة صدارة محددة أو عرض قائمة بجميع لوحات الصدارة التي يمكنه الاختيار من بينها.
يمكنك أيضًا تنفيذ إصداراتك الخاصة من لوحات الصدارة من خلال الوصول إلى البيانات مباشرةً من مكتبات العملاء.
السمات
لإنشاء لوحات الصدارة وإدارتها، يجب أن تكون على دراية بسمات لوحة الصدارة التالية:
الأساسيّات
ترتبط هذه العناصر الأساسية بكل لوحة صدارة:
- رقم التعريف هو سلسلة فريدة ستنشئها لك أداة Google Play Console. ستستخدم هذا المعرّف الفريد للإشارة إلى قائمة الصدارة في عملاء الألعاب.
- الاسم هو اسم مختصر للوحة الصدارة (على سبيل المثال، "أعلى نتيجة" أو "المستوى 3"). ويمكن أن يصل طول هذا الاسم إلى 100 حرف.
- الرمز هو رمز مربّع سيتم ربطه بلوحة الصدارة. للحصول على أفضل الممارسات عند إنشاء رموز ليدربورد، راجع قسم إرشادات الرموز أدناه.
- ترتيب القائمة هو الترتيب الذي ستظهر به قائمة الصدارة عندما يعرض لاعب لوحات الصدارة المرتبطة بلعبتك.
- الحدود هي قيم اختيارية تحدّد الحدَّين الأدنى والأعلى للنتائج المسموح بها في لوحة الصدارة. ويمكن أن يساعدك ذلك في تجاهل عمليات الإرسال
التي تتضمن نتيجة احتيالية بشكل واضح. ويمكنك أيضًا استخدام
Players.hide
لإخفاء اللاعبين الذين تعتقد أنهم أرسلوا نتائج احتيالية من جميع لوحات الصدارة في تطبيقك.
الترتيب
يمكن أن تحتوي لوحات الصدارة على أحد نوعي الترتيب:
- لوحات الصدارة هي الأكبر حجمًا أفضل. وهذا ما تراه عادةً في معظم الألعاب التي يكسب فيها اللاعبون نقاطًا.
- يتم استخدام لوحات الصدارة الأصغر حجمًا أفضل في الحالات التي تكون فيها النتيجة الأصغر أفضل. ومن الأمثلة الأكثر شيوعًا لهذا النوع من قوائم الصدارة في ألعاب السباقات، حيث تمثل النتيجة وقت اللاعب لإنهاء السباق.
تنسيق النتيجة
في حين يتم إرسال جميع النتائج إلى لوحات الصدارة وتخزينها داخليًا بأعداد صحيحة طويلة، يمكن لـ "خدمات ألعاب Play" عرضها للمستخدم بعدد من التنسيقات المختلفة:
تعرض لوحات الصدارة الرقمية النتائج كأرقام. ويمكن عرضها كأعداد صحيحة أو كأرقام حقيقية بعدد ثابت من المنازل العشرية. ويمكنك إرسال النتيجة كأعداد صحيحة ويتم إدراج العلامة العشرية في الموقع الجغرافي المحدد. على سبيل المثال، سيتم عرض نتيجة
314159
على النحو التالي:3.14159
أو3141.59
أو314159
، بناءً على العلامة العشرية التي حدّدتها.تعرض لوحات الصدارة الوقت النتائج بالساعات / الدقائق / الثواني / المئات من التنسيقات الثانية. يجب إرسال النتائج بالمللي ثانية، وبالتالي سيتم تفسير
66032
على أنّه1:06.03
.تعرض لوحات الصدارة في العملة النتائج بتنسيق عملة. يمكنك إرسال النتائج على أنّها 1/1,000,000 من وحدة العملة الرئيسية. على سبيل المثال، سيتم تفسير نتيجة 19,950,000 على أنّها
$19.95
، بافتراض أنّك حدّدت عملتك على أنّها الدولار الأمريكي.
تتوافق لوحات الصدارة الرقمية أيضًا مع الوحدات المخصّصة. على سبيل المثال، إذا كانت لعبتك تقيس أعلى النتائج بالمتر، فيمكنك تحديد "الأمتار" كوحدة افتراضية للوحة الصدارة.
الترجمات وتنسيق النتائج
عندما تطلب مكتبات برامج الأجهزة الجوّالة بيانات من "لوحة الصدارة" من "خدمات ألعاب Play"، يتم تحديد لغة ولغة محلية لعرض هذه النتائج. تتيح لك REST API تحديد لغة تعتمد على اللغة أيضًا. تعرض "خدمات ألعاب Play" نتائج قوائم الصدارة المناسبة لهذه اللغة والمنطقة. ستظهر هذه النتائج المنسَّقة سواء أضفت ترجمات للوحة الصدارة أم لا.
بالنسبة إلى لوحات الصدارة الرقمية، يتم عرض تنسيق الأرقام بشكل مختلف لكل لغة. (على سبيل المثال، 12,345.78
في الولايات المتحدة و12 345,78
في فرنسا). إذا كنت تستخدم وحدات مخصصة وأضفت ترجمات إلى لعبتك، يتعين عليك توفير وحدات مترجمة لكل لغة أضفتها. وبعد ذلك، تعرض الخدمة هذه الوحدات المترجمة عندما يكون ذلك مناسبًا.
بناءً على اللغة التي تختارها، قد تحتاج إلى تقديم إصدارات مختلفة لأسماء الوحدات. باللغة الإنجليزية، ستحتاج إلى إصدار لعنصر آخر ونسخة أخرى لكل العناصر الأخرى (على سبيل المثال، "متر" و"مترات"). أما في البولندية، فقد تحتاج إلى توفير إصدار لوحدة واحدة، وبضعة وحدات، والعديد من الوحدات وكل شيء آخر. لمعرفة المزيد من المعلومات عن قواعد الجمع، راجع Quantity Strings(Plulars).
بالنسبة إلى لوحات الصدارة الوقت، يتم عرض تنسيق الوقت وفقًا للغة اللاعب ولغته. يمكن ملاحظة ذلك بشكل أساسي إذا كنت تستخدم أجزاء من الثانية أو إذا كانت قيمة ساعات العمل تتضمّن أكثر من 3 أرقام (مثلاً، 4,815:16:23.42
في الولايات المتحدة و4.815:16:23,42
في ألمانيا).
بالنسبة إلى لوحات الصدارة في فئة العملة، سيتم عرض تنسيق العملة وفقًا للغة اللاعب ولغته. لكن لا يمكنك تغيير وحدة العملة. على سبيل المثال، إذا حددت عملتك بالدولار الأمريكي، ستعرض اللعبة
$19.95
في الولايات المتحدة و19,95 $
في فرنسا. ولكن لا يمكنك تحديد أن لعبتك تعرض الدولارات في الولايات المتحدة واليورو في فرنسا.
الإرشادات المتعلقة بالرموز
يجب إنشاء الأيقونات كملفات 512 × 512 بتنسيق PNG أو JPEG. سيتم تقليص حجم الأيقونات الخاصة بك في معظم عملاء الألعاب، لذا يجب تجنب إنشاء الأيقونات بالتفاصيل الدقيقة جدًا. يمكنك إرسال أيقونات مع قناة ألفا، وسيتم الاحتفاظ بالشفافية. سيظهر رمز ليدربورد على خلفية رمادية أغمق على أجهزة Android، لذا اختر رمزًا يمكن أن يعمل بشكل جيد في هذه الحالة.
يُستخدم الرمز نفسه في جميع اللغات، لذا ننصح بعدم تضمين أي نص أو محتوى مترجَم في الرمز.
إنشاء لوحة صدارة
يوضِّح لك هذا القسم كيفية إنشاء لوحات الصدارة للألعاب الجديدة أو الحالية.
إنشاء لوحة صدارة للعبة جديدة
لإنشاء لوحة صدارة للعبة جديدة وغير منشورة، انتقِل إلى إدخال Google Play Console للعبتك، وانتقِل إلى النمو > خدمات ألعاب Play > الإعداد والإدارة > لوحات الصدارة، ثم انقر على زر إنشاء لوحة صدارة.
![زر "إضافة ليدربورد" في "لوحة الصدارة"](https://developer.android.com/static/images/games/pgs/leaderboardAddNew.png?authuser=19&hl=ar)
بعد ذلك، املأ المعلومات المطلوبة للوحة الصدارة هذه.
![نموذج معبأ للوحة الصدارة "الأفضل جولة".](https://developer.android.com/static/images/games/pgs/leaderboardSampleForm.png?authuser=19&hl=ar)
انقر على حفظ كمسودة، وستصبح لوحة الصدارة متوفرة في الحالة "مسودة". بعد نشر لعبتك، يتم نشر جميع لوحات الصدارة فيها.
إنشاء لوحة صدارة للعبة منشورة
لإنشاء لوحة صدارة إضافية للعبة سبق نشرها، اتّبع الخطوات نفسها الواردة أعلاه. ولمزيد من المعلومات حول اختبار إصدار محدّث من اللعبة، راجع نشر تغييرات لعبتك.
بعد اختبار "لوحة الصدارة" ورضا المستخدمين عنها، يمكنك إعادة نشر لعبتك باستخدام لوحات الصدارة الجديدة، وسيتم عرضها على العالم.
تعديل ليدربورد
لتعديل ليدربورد أنشأته من قبل، انقر عليه في علامة التبويب لوحات الصدارة في Google Play Console. في هذه المرحلة، سترى نفس النموذج الذي استخدمته عند إنشاء ليدربورد لأول مرة، وستتمكن من تعديل أي من الحقول كما ترغب.
عند الانتهاء من تعديل إحدى لوحات الصدارة، انقر على زر حفظ كمسودة. ستكون حالة ليدربورد التي تم تعديلها مؤخرًا في حالة "مسودة"، مما يتيح لك اختبارها.
إذا كانت الإعدادات تعمل بشكل صحيح، فحدّد نشر التغييرات من المربّع في أعلى نموذج "لوحة الصدارة"، وستتمكن من إعادة نشر لعبتك بالإضافة إلى جميع لوحات الصدارة التي تم تحديثها للجمهور.
التراجع عن تعديل
إذا قررت عدم الإعجاب بلوحة الصدارة التي تم تعديلها حديثًا وتريد العودة إلى التكرار السابق، ما عليك سوى اختيار تراجع من المربّع الذي يظهر أعلى نموذج "لوحة الصدارة". يعود "لوحة الصدارة" إلى النسخة المنشورة من قبل.
حذف لوحة صدارة
يمكنك حذف لوحات الصدارة التي تكون في الحالة "مسودة" أو التي تم نشرها. لحذف لوحة صدارة في Google Play Console، انتقِل إلى نموذج "لوحة الصدارة"، ثم انقر على حذف لوحة الصدارة في أعلى النموذج.
ويمكنك بدلاً من ذلك استدعاء
Players.hide
لإخفاء لوحة الصدارة للاعب في التطبيق.
إعادة ضبط ليدربورد
يمكنك إعادة ضبط بيانات مستوى تقدُّم اللاعبين فقط في مسودّة لوحات الصدارة.
- لإعادة ضبط لوحات الصدارة في Google Play Console، انقر على إعادة ضبط التقدم في أعلى النموذج لذلك الحدث.
- لإعادة تعيين بيانات ليدربورد آليًا، يمكنك استدعاء
أساليب واجهة برمجة تطبيقات الإدارة
Scores
".
إضافة ترجمات للوحات الصدارة
يمكنك تحديد ترجمتك الخاصة للوحات الصدارة المرتبطة بلعبتك. قبل إجراء ذلك، يجب أولاً إكمال الخطوات الموضّحة في قسم إضافة ترجمات للعبتك. ويجب أن تكون قد أنشأت أيضًا لوحة صدارة واحدة أو أكثر للعبتك.
لإضافة ترجمتك الخاصة للوحات الصدارة، افتح علامة التبويب لوحات الصدارة للعبتك في Google Play Console ثم اختر ليدربورد حالي. في صفحة "تفاصيل لوحة الصدارة"، انقر على علامة التبويب الخاصة بلغة أضفتها سابقًا في علامة التبويب تفاصيل اللعبة. في صفحة تفاصيل لوحة الصدارة لتلك اللغة، عدّل النموذج الذي يشتمل على ترجماتك للوحة الصدارة. انقر على حفظ لتخزين تفاصيل "لوحة الصدارة" المترجمة.
إخفاء نتائج لوحة الصدارة
توفّر "خدمات ألعاب Google Play" ميزة "الحماية من التلاعب في لوحة الصدارة" بهدف البحث عن النتائج التي يُشتبه في تلاعبها وإخفاء هذه النتائج تلقائيًا. لا تتوفر هذه الميزة إلا لألعاب Android.
تكون ميزة "الحماية من التلاعب" مفعَّلة تلقائيًا في لوحات الصدارة الجديدة التي تنشئها للعبة Android، ولكن تكون غير مفعّلة للوحات الصدارة الحالية. لتفعيل ميزة الحماية من التلاعب في لوحات الصدارة الحالية التي سبق نشرها، اتّبِع الخطوات التالية:
- في Google Play Console، افتح علامة التبويب خدمات الألعاب، ثم اختَر لعبتك من القائمة.
- افتح علامة التبويب ليدربورد، ثم اختَر مثيل لوحة الصدارة الذي تريد تفعيل الحماية من التلاعب عليه.
- فعِّل الخيار تفعيل الحماية من التلاعب في لوحة الصدارة.
- انقر على حفظ ومتابعة.
- انشر لعبتك.
بعد تفعيل ميزة "الحماية من التلاعب" في قائمة "في الصدارة" في Google Play Console، قد يستغرق تطبيق هذه الميزة مدة تصل إلى 24 ساعة. وبأثر رجعي، لن يتم إخفاء النتائج التي تم إرسالها قبل تفعيل الحماية من التلاعب.
في بعض الحالات، قد تحتاج إلى إيقاف ميزة "الحماية من التلاعب" (على سبيل المثال، إذا كانت لعبتك تعمل أيضًا على الويب بالإضافة إلى Android وتشارك قوائم الصدارة على هذه الأنظمة الأساسية).
عمليات التنفيذ المتعلقة بالعملاء
للتعرّف على كيفية تنفيذ ميزة "لوحات الصدارة" على منصتك، اطّلِع على المراجع التالية: