يمكن أن تكون لوحات الصدارة طريقة ممتعة لتشجيع المنافسة بين اللاعبين، سواء بالنسبة إلى المعجبين الأكثر حماسًا (الذين سيتنافسون على المركز الأول في لوحة صدارة عامة) أو اللاعبين العاديين (الذين سيهتمون بمقارنة مستوى تقدّمهم بمستوى تقدّم أصدقائهم).
للتعرّف على كيفية تنفيذ لوحات الصدارة على منصتك، اطّلِع على عمليات التنفيذ من جهة العميل.
التعرّف على قوائم الصدارة
عند إنشاء قائمة صدارة، ستتولّى "خدمات ألعاب Play" إدارة معظم جوانب هذه القائمة نيابةً عنك. تتم العملية النموذجية على النحو التالي:
- في نهاية اللعبة (أو في لحظة مناسبة تحدّدها)، ترسل اللعبة نتيجة اللاعب إلى قائمة صدارة واحدة أو أكثر أنشأتها للعبة.
- تتحقّق "خدمات ألعاب Google Play" مما إذا كانت هذه النتيجة أفضل من النتيجة الحالية للاعب في قائمة الصدارة الخاصة بالنتيجة اليومية أو الأسبوعية أو النتيجة على الإطلاق. إذا كان الأمر كذلك، تعمل "خدمات ألعاب Play" على تعديل قوائم الصدارة ذات الصلة باستخدام النتيجة الجديدة.
- ترسل "خدمات ألعاب Play" تقريرًا عن النتيجة إلى برنامج اللعبة. يُعلم هذا التقرير العميل ما إذا كانت هذه النتيجة هي الأعلى على الإطلاق أو الأعلى في اليوم أو الأسبوع. إذا لم يكن كذلك، ستخبر "خدمات ألعاب Play" البرنامج بقيمة أعلى نتيجة حالية حقّقها اللاعب يوميًا أو أسبوعيًا أو على الإطلاق.
- لاسترداد نتائج لاعب في قائمة الصدارة، يمكنك طلب إطار زمني (يومي أو أسبوعي أو طوال الوقت) وتحديد ما إذا كان المستخدم يريد الاطّلاع على قائمة صدارة اجتماعية أو عامة. تُجري "خدمات ألعاب Google" جميع عمليات الفلترة اللازمة، ثم ترسل النتائج إلى العميل.
- في الحالات التي تتضمّن الكثير من النتائج المطلوب تسجيلها، لا ترسل "خدمات ألعاب Play" سوى بيانات أعلى النتائج في قائمة الصدارة. يمكنك أيضًا استرداد بيانات النتائج الأولية لأعلى النتائج أو النتائج المجاورة لنتيجة اللاعب.
لوحات صدارة متعددة
يمكن أن تتضمّن الألعاب لوحات صدارة متعدّدة، يصل عددها إلى 70 كحدّ أقصى. على سبيل المثال، قد توفّر لعبة متعدّدة المستويات قائمة صدارة مختلفة لكل مستوى، وقد تتضمّن لعبة سباق قائمة صدارة منفصلة لكل مضمار.
الأُطر الزمنية لقوائم الصدارة
ينشئ حزمة تطوير البرامج (SDK) في "ألعاب Play" تلقائيًا إصدارات يومية وأسبوعية وإصدارات منذ بداية الاستخدام لكل قائمة صدارة تنشئها. ليس عليك إنشاء لوحات صدارة منفصلة لكل إطار زمني.
تتم إعادة ضبط قوائم الصدارة اليومية في الساعة 12 صباحًا بتوقيت المحيط الهادئ الصيفي (UTC-7) على مدار العام.
تتم إعادة ضبط قوائم الصدارة الأسبوعية عند منتصف الليل بين يومَي السبت والأحد، وذلك في المنطقة الزمنية نفسها التي تستخدمها قوائم الصدارة اليومية (التوقيت العالمي المنسَّق -7).
قوائم الصدارة العامة والاجتماعية
يمكن أن تعرض حزمة تطوير البرامج (SDK) في "ألعاب Play" إصدارَين مختلفَين من كل قائمة صدارة للاعب:
قائمة الصدارة الاجتماعية هي قائمة صدارة تتألف من أشخاص في دوائر المستخدم (أو بشكل أكثر دقة، أعضاء الدوائر التي اختار المستخدم مشاركتها مع تطبيقك) والذين قرروا مشاركة نشاطهم في اللعب مع المستخدم.
قائمة الصدارة العامة هي قائمة صدارة تتألف من لاعبين اختاروا مشاركة نشاطهم في اللعب بشكل علني. إذا لم يوافق اللاعب على مشاركة نشاطه في اللعب مع الجميع، لن يظهر في قائمة الصدارة هذه.
عرض قوائم الصدارة
في مكتبات برامج العميل على الأجهزة الجوّالة، تتولّى المكتبات مهمة تنسيق لوحات الصدارة وعرضها. يمكنك تحديد ما إذا كان بإمكان اللاعب الاطّلاع على قائمة صدارة معيّنة أو على قائمة بكل قوائم الصدارة التي يمكنه الاختيار من بينها.
يمكنك أيضًا تنفيذ إصداراتك الخاصة من قوائم الصدارة من خلال الوصول إلى البيانات مباشرةً من مكتبات البرامج.
السمات
لإنشاء لوحات الصدارة وإدارتها، عليك التعرّف على سمات لوحات الصدارة التالية:
الأساسيات
ترتبط هذه العناصر الأساسية بكل قائمة صدارة:
- المعرّف هو سلسلة فريدة ستنشئها لك أداة Google Play Console. ستستخدم هذا المعرّف الفريد للإشارة إلى لوحة الصدارة في برامج الألعاب.
- الاسم هو اسم قصير لقائمة الصدارة (مثلاً، "أعلى النتائج" أو "المستوى 3"). يمكن أن يصل طول هذا الوصف إلى 100 حرف.
- الرمز هو رمز مربّع سيتم ربطه بلوحة الصدارة. للاطّلاع على أفضل الممارسات عند إنشاء رموز لوحات الصدارة، يُرجى الرجوع إلى إرشادات الرموز.
- ترتيب القائمة هو الترتيب الذي ستظهر به قائمة الصدارة عندما يعرض أحد اللاعبين قوائم الصدارة المرتبطة بلعبتك.
- الحدود هي قيم اختيارية تحدّد الحدّ الأدنى والأقصى للنتائج المسموح بها في لوحة الصدارة. ويمكن أن يساعدك ذلك في تجاهل النتائج التي تم إرسالها والتي تبدو احتيالية بوضوح. يمكنك أيضًا استخدام
Players.hideلإخفاء اللاعبين الذين تعتقد أنّهم أرسلوا نتائج احتيالية من جميع قوائم الصدارة في تطبيقك.
ترتيب لوحات الصدارة
يمكن أن تتضمّن لوحات الصدارة أحد نوعَي الترتيب التاليَين:
- لوحات الصدارة الأكبر هي الأفضل هي الإعداد التلقائي. وهذا هو الشكل الذي يظهر عادةً في معظم الألعاب التي يكسب فيها اللاعبون نقاطًا.
- يتم أحيانًا استخدام لوحات الصدارة التي تعرض أصغر قيمة في الحالات التي يكون فيها الحصول على نتيجة أصغر أفضل. تتوفّر الأمثلة الأكثر شيوعًا لهذا النوع من قوائم الصدارة في ألعاب السباقات، حيث تمثّل النتيجة الوقت الذي استغرقه اللاعب لإنهاء السباق.
تنسيق النتيجة
على الرغم من أنّه يتم إرسال جميع النتائج إلى لوحات الصدارة وتخزينها داخليًا كأعداد صحيحة طويلة، يمكن أن تعرض "خدمات ألعاب Play" هذه النتائج للمستخدم بعدة تنسيقات مختلفة:
تعرض لوحات الصدارة الرقمية النتائج على شكل أرقام. ويمكن عرضها كأعداد صحيحة أو كأعداد حقيقية بعدد ثابت من المنازل العشرية. يجب إرسال النتيجة كأعداد صحيحة، وسيتم إدراج الفاصلة العشرية في الموضع المحدّد. على سبيل المثال، سيتم عرض النتيجة
314159على النحو التالي:3.14159أو3141.59أو314159، وذلك استنادًا إلى الموضع العشري الذي حدّدته.تعرض لوحات الصدارة للوقت النتائج بتنسيق ساعات / دقائق / ثوانٍ/أجزاء من مئة من الثانية. يجب إرسال النتائج بالمللي ثانية، لذا سيتم تفسير
66032على أنّه1:06.03.تعرض لوحات الصدارة الخاصة بالعملات النتائج بتنسيق العملة. يجب إرسال النتائج على شكل جزء من مليون جزء من وحدة العملة الرئيسية. على سبيل المثال، سيتم تفسير النتيجة 19,950,000 على أنّها
$19.95، بافتراض أنّك حدّدت عملتك على أنّها دولار أمريكي.
تتيح لوحات الصدارة الرقمية أيضًا استخدام وحدات مخصّصة. على سبيل المثال، إذا كانت لعبتك تقيس أعلى النتائج بالأمتار، يمكنك تحديد "الأمتار" كوحدة القياس التلقائية للوحة الصدارة.
الترجمات وتنسيق النتيجة
عندما تطلب مكتبات برامج العميل على الأجهزة الجوّالة بيانات لوحة الصدارة من "خدمات ألعاب Play"، فإنّها تحدّد اللغة واللغة المحلية التي سيتم عرض هذه النتائج بها. تتيح لك REST API تحديد لغة مستندة إلى اللغة المحلية أيضًا. تُرجع "خدمات ألعاب Play" نتائج لوحة الصدارة المنسّقة والمناسبة لتلك اللغة واللغة المحلية. ستظهر هذه النتائج المنسّقة سواء أضفت ترجمات للوحة الصدارة أم لا.
في لوحات الصدارة الرقمية، يتم عرض تنسيق الأرقام بشكل مختلف حسب اللغة. (على سبيل المثال، 12,345.78 في الولايات المتحدة و12 345,78 في فرنسا) إذا كنت تستخدم وحدات مخصّصة وأضفت ترجمات إلى لعبتك، يجب توفير وحدات مترجَمة لكل لغة أضفتها. بعد ذلك، تعرض الخدمة هذه الوحدات المترجمة في المواضع المناسبة.
استنادًا إلى اللغة التي تختارها، قد تحتاج إلى تقديم إصدارات مختلفة من أسماء الوحدات. في اللغة الإنجليزية، ستحتاج إلى إصدار لعنصر واحد وآخر لكل ما عدا ذلك (على سبيل المثال، "متر" و"أمتار"). في المقابل، في اللغة البولندية، عليك تقديم نسخة لوحدة واحدة، ونسخة لبضع وحدات، ونسخة للعديد من الوحدات، ونسخة لكل ما عدا ذلك. لمزيد من المعلومات عن قواعد الجمع، راجِع مقالة سلاسل الكمية(صيغ الجمع).
بالنسبة إلى قوائم الصدارة للوقت، يتم عرض تنسيق الوقت وفقًا للغة اللاعب ومنطقته. سيكون ذلك ملحوظًا بشكل أساسي إذا كنت تستخدم أجزاء من الثانية أو إذا كانت قيمة الساعات تتضمّن أكثر من 3 أرقام (على سبيل المثال، 4,815:16:23.42 في الولايات المتحدة و4.815:16:23,42 في ألمانيا).
في لوحات الصدارة للعملات، سيتم عرض تنسيق العملة وفقًا للغة اللاعب وإعداداته المحلية. ومع ذلك، لا يمكنك تغيير وحدة العملة. على سبيل المثال، إذا حدّدت عملتك بالدولار الأمريكي، ستعرض اللعبة $19.95 في الولايات المتحدة و19,95 $ في فرنسا. ولكن لا يمكنك تحديد أنّ لعبتك تعرض الدولارات في الولايات المتحدة واليورو في فرنسا.
إرشادات الرموز
يجب إنشاء الرموز بتنسيق PNG أو JPEG بحجم 512 × 512. سيتم تصغير حجم الرموز في معظم برامج تشغيل الألعاب، لذا عليك تجنُّب إنشاء رموز تتضمّن الكثير من التفاصيل الدقيقة. يمكنك إرسال رموز تتضمّن قناة ألفا، وسيتم الاحتفاظ بمستوى الشفافية. سيظهر رمز لوحة الصدارة على خلفية رمادية داكنة على أجهزة Android، لذا اختَر رمزًا مناسبًا لهذه الحالة.
يُستخدم الرمز نفسه مع جميع اللغات، لذا ننصحك بعدم تضمين أي نص أو محتوى بلغة معيّنة في الرمز.
إنشاء قائمة صدارة
يوضّح لك هذا القسم كيفية إنشاء لوحات صدارة للألعاب الجديدة أو الحالية.
إنشاء قائمة صدارة للعبة جديدة
لإنشاء قائمة صدارة للعبة جديدة لم يتم نشرها، انتقِل إلى إدخال Google Play Console الخاص بلعبتك، ثم انتقِل إلى النمو > خدمات ألعاب Play > الإعداد والإدارة > قوائم الصدارة، ثم انقر على زر إنشاء قائمة صدارة.
بعد ذلك، ما عليك سوى ملء المعلومات المطلوبة لقائمة الصدارة هذه.
انقر على حفظ كمسوّدة، وستكون قائمة الصدارة في حالة "مسوّدة". بعد نشر لعبتك، يتم أيضًا نشر جميع قوائم الصدارة فيها.
إنشاء قائمة صدارة للعبة منشورة
لإنشاء قائمة صدارة إضافية للعبة سبق نشرها، اتّبِع الخطوات نفسها المذكورة أعلاه. لمزيد من المعلومات عن اختبار إصدار معدَّل من لعبة، يُرجى الاطّلاع على مقالة كيفية نشر التغييرات في لعبتك.
بعد اختبار قائمة صدارة بدون الحاجة إلى أي تعديلات أخرى، يمكنك إعادة نشر لعبتك باستخدام قوائم الصدارة الجديدة ليتم طرحها على مستوى العالم.
تعديل قائمة صدارة
لتعديل قائمة صدارة سبق أن أنشأتها، انقر عليها في علامة التبويب قوائم الصدارة في Google Play Console. في هذه المرحلة، سيظهر لك النموذج نفسه الذي استخدمته عند إنشاء قائمة الصدارة لأول مرة، ما يتيح لك تعديل أيّ من الحقول حسب الحاجة.
عند الانتهاء من تعديل قائمة الصدارة، انقر على زر حفظ كمسوّدة. ستكون قائمة الصدارة التي تم تعديلها حديثًا في حالة "مسوّدة"، ما يتيح لك اختبارها.
في حال عملها بشكل صحيح، اختَر نشر التغييرات من المربّع في أعلى نموذج قائمة الصدارة، وستتمكّن من إعادة نشر لعبتك، بالإضافة إلى جميع قوائم الصدارة المعدّلة، لجميع المستخدمين.
التراجع عن تعديل
إذا لم تنل إعجابك قائمة الصدارة المعدَّلة حديثًا وأردت العودة إلى النسخة السابقة، فما عليك سوى النقر على تراجع من المربّع في أعلى نموذج قائمة الصدارة. يؤدي ذلك إلى إعادة قائمة الصدارة إلى النسخة المنشورة سابقًا.
حذف قائمة صدارة
يمكنك حذف قوائم الصدارة التي تكون في حالة "مسوّدة" أو تم نشرها. لحذف قائمة صدارة في Google Play Console، انتقِل إلى نموذج قائمة الصدارة المعنيّة وانقر على حذف قائمة الصدارة في أعلى النموذج.
بدلاً من ذلك، يمكنك طلب Players.hide لإخفاء قائمة الصدارة الخاصة باللاعب في التطبيق.
إعادة ضبط قائمة صدارة
لا يمكنك إعادة ضبط بيانات مستوى تقدّم اللاعبين إلا في مسوّدات قوائم الصدارة.
- لإعادة ضبط قوائم الصدارة في Google Play Console، انقر على إعادة ضبط مستوى التقدّم في أعلى نموذج الحدث المعنيّ.
- لإعادة ضبط بيانات قائمة الصدارة آليًا، استخدِم طرق Management API
Scores.
إضافة ترجمات إلى قوائم الصدارة
يمكنك تحديد ترجماتك الخاصة لقوائم الصدارة المرتبطة بلعبتك. قبل إجراء ذلك، احرِص أولاً على إكمال الخطوات الموضّحة في مقالة كيفية إضافة ترجمات إلى اللعبة. يجب أيضًا أن تكون قد أنشأت قائمة صدارة واحدة أو أكثر للعبتك.
لإضافة ترجماتك الخاصة إلى قوائم الصدارة، افتح علامة التبويب قوائم الصدارة للعبة في Google Play Console، ثم اختَر قائمة صدارة حالية. في صفحة "تفاصيل قائمة الصدارة"، انقر على علامة التبويب للّغة التي أضفتها سابقًا في علامة التبويب تفاصيل اللعبة. في صفحة "تفاصيل قائمة الصدارة" لهذه اللغة، عدِّل النموذج باستخدام ترجماتك لقائمة الصدارة هذه. انقر على حفظ لتخزين تفاصيل قائمة الصدارة المترجَمة.
إخفاء نتائج قائمة الصدارة
توفّر "خدمات ألعاب Google Play" ميزة "الحماية من التلاعب" في قائمة الصدارة، وذلك من خلال التحقّق من النتائج المُشتبَه فيها وإخفاؤها تلقائيًا. تتوفّر هذه الميزة لألعاب Android فقط.
تكون ميزة "الحماية من التلاعب" مفعّلة تلقائيًا في قوائم الصدارة الجديدة التي تنشئها للعبة Android، ولكن تكون غير مفعّلة في قوائم الصدارة الحالية. لتفعيل ميزة "الحماية من التلاعب" في قوائم الصدارة الحالية التي سبق نشرها، اتّبِع الخطوات التالية:
- في Google Play Console، افتح علامة التبويب خدمات الألعاب، ثم اختَر لعبتك من القائمة.
- افتح علامة التبويب قوائم الصدارة، ثم اختَر نسخة قائمة الصدارة التي تريد تفعيل ميزة "الحماية من التلاعب" فيها.
- فعِّل الخيار تفعيل ميزة "الحماية من التلاعب" في قائمة الصدارة.
- انقر على حفظ ومتابعة.
- انشر لعبتك.
بعد تفعيل ميزة "الحماية من التلاعب" في قائمة صدارة في Google Play Console، قد يستغرق تطبيق هذه الميزة مدة تصل إلى 24 ساعة. ولا يتم إخفاء النتائج التي تم إرسالها قبل تفعيل ميزة "الحماية من التلاعب" بأثر رجعي.
في بعض الحالات، قد يتطلّب الأمر إيقاف ميزة "الحماية من التلاعب" (على سبيل المثال، إذا كانت لعبتك تعمل أيضًا على الويب بالإضافة إلى Android، وتشارك قوائم الصدارة على هذه الأنظمة الأساسية).
عمليات التنفيذ من جانب العميل
للتعرّف على كيفية تنفيذ لوحات الصدارة على منصتك، اطّلِع على المراجع التالية: