يمكن أن تكون لوحات الصدارة طريقة ممتعة لتشجيع المنافسة بين اللاعبين، سواءً بالنسبة إلى المعجبين الأكثر حماسة (الذين سيتنافسون على المركز الأول في لوحة صدارة علني ) أو بالنسبة إلى اللاعبين العاديين (الذين سيهتمون مقارنة مستوى تقدّمهم بمستوى أصدقائهم).
للتعرّف على كيفية تنفيذ قوائم الصدارة لمنصّتك، اطّلِع على عمليات تنفيذ العميل.
فهم لوحات الصدارة
عند إنشاء قائمة صدارة، ستتولى "خدمات ألعاب Play" إدارة معظم جوانب قائمة الصدارة نيابةً عنك. تتم العملية عادةً على النحو التالي:
- في نهاية إحدى الألعاب (أو في لحظة مناسبة تحدّدها أنت)، تُرسِل اللعبة نتيجة اللاعب إلى قائمة صدارة واحدة أو أكثر أنشأتها للعبة.
- تتحقّق "خدمات ألعاب Play" مما إذا كانت هذه النتيجة أفضل من النتيجة المدرَجة حاليًا في لوحة الصدارة الخاصة باللاعب للنتيجة اليومية أو الأسبوعية أو النتيجة على مدار الوقت. إذا كان الأمر كذلك، تعدّل "خدمات ألعاب Play" قوائم الصدارة ذات الصلة بالنتيجة الجديدة.
- تُرسِل "خدمات ألعاب Play" تقريرًا عن النتيجة إلى برنامج تشغيل اللعبة. يُعلم هذا التقرير العميل ما إذا كان هذا الإجراء هو نتيجة قياس جديدة قياسية تشمل اليوم أو الأسبوع أو جميع الأوقات. وإذا لم يكن كذلك، ستُعلم "خدمات ألعاب Play" العميل بالنقاط المرتفعة الحالية لهذا اللاعب على أساس يومي أو أسبوعي أو على مستوى جميع الأوقات.
- لاسترداد نتائج أحد اللاعبين في قائمة صدارة، يمكنك طلب ملف شخصي في جدول زمني (يومي أو أسبوعي أو على مدار الوقت)، وتحديد ما إذا كان المستخدم يريد الاطّلاع على قائمة صدارة اجتماعية أو عامة. تُجري "خدمات ألعاب Play" جميع عمليات الفلترة اللازمة، ثم تُعيد النتائج إلى العميل.
- في الحالات التي تتوفّر فيها الكثير من النتائج المطلوب الإبلاغ عنها، تُرسِل "خدمات ألعاب Play" البيانات المتعلّقة بنتائج قائمة الصدارة الأعلى فقط. يمكنك أيضًا استرداد بيانات النتائج الأولية لأعلى النتائج أو النتائج المجاورة لنتائج اللاعب.
قوائم صدارة متعددة
يمكن أن تتضمّن الألعاب لوحات صدارة متعددة، بحد أقصى 70 لوحة. على سبيل المثال، قد تقدّم لعبة متعددة المستويات قائمة صدارة مختلفة لكل مستوى، وقد تحتوي لعبة سباق على قائمة صدارة منفصلة لكل مسار.
الأطر الزمنية لقائمة الصدارة
تنشئ حزمة تطوير البرامج (SDK) لتطبيق "ألعاب Play" تلقائيًا تصاميم يومية وأسبوعية وتصاميم لكلّ الوقت لكلّ قائمة صدارة تنشئها. ليس عليك إنشاء لوحات صدارة منفصلة لكل إطار زمني.
تتم إعادة ضبط قوائم الصدارة اليومية عند التوقيت العالمي المنسق -7 (أي "منتصف الليل بالتوقيت الصيفي للمحيط الهادئ") طوال العام.
تتم إعادة ضبط قوائم الصدارة الأسبوعية عند منتصف الليل بين السبت والأحد، في المنطقة الزمنية نفسها التي تنطبق على قوائم الصدارة اليومية (التوقيت العالمي المتفق عليه -7).
لوحات الصدارة العامة والاجتماعية
يمكن لحزمة تطوير البرامج (SDK) لتطبيق "ألعاب Play" عرض نسختَين مختلفتَين من كل جدول صدارة أمام اللاعب:
قائمة الصدارة الاجتماعية هي قائمة تتألف من مستخدمي تطبيقاتك الذين قرروا مشاركة نشاطهم في اللعب مع مستخدمي التطبيق الآخرين في حلقاتهم (أو بتعبير أدق، أعضاء الحلقات التي اختار المستخدم مشاركتها مع تطبيقك).
قائمة الصدارة العلنية هي قائمة تتألف من اللاعبين الذين اختاروا مشاركة نشاطهم في اللعب بشكل علني. إذا لم يختار اللاعب مشاركة نشاطه في اللعب بشكل علني، لن يظهر في قائمة الصدارة هذه.
عرض قوائم الصدارة
في مكتبات تطبيقات الأجهزة الجوّالة، تتولى المكتبات جميع عمليات التنسيق وعرض قوائم الصدارة. يمكنك تحديد ما إذا كان بإمكان اللاعب الاطّلاع على ملف شخصي في ملف شخصي في لوحة صدارة معيّنة، أو الاطّلاع على قائمة بكل قوائم الصدارة التي يمكنه الاختيار من بينها.
يمكنك أيضًا تنفيذ نُسخك الخاصة من قوائم الصدارة من خلال الوصول إلى data مباشرةً من مكتبات العميل.
السمات
لإنشاء قوائم الصدارة وإدارتها، عليك التعرّف على ملف شخصيسمات قائمة الصدارة التالية:
الأساسيات
ترتبط هذه العناصر الأساسية بكل قائمة صدارة:
- رقم التعريف هو سلسلة فريدة ستُنشئها أداة Google Play Console نيابةً عنك. ستستخدم هذا المعرّف الفريد للإشارة إلى لوحة الصدارة في عملاء اللعبة.
- الاسم هو اسم مختصر لقائمة الصدارة (على سبيل المثال، "أعلى النتائج" أو "المستوى 3"). يمكن أن يصل طول هذا العنوان إلى 100 حرف.
- الرمز هو رمز مربّع سيتم ربطه بقائمة الصدارة. للاطّلاع على أفضل الممارسات عند إنشاء رموز قوائم الصدارة، اطّلِع على إرشادات الرموز.
- ترتيب القائمة هو الترتيب الذي ستظهر به قائمة الصدارة عندما يعرض أحد اللاعبين قوائم الصدارة المرتبطة بلعبتك.
- الحدود هي قيم اختيارية تحدّد الحدّ الأدنى والأعلى لنتائج
الألعاب المسموح بها في لوحة الصدارة. ويمكن أن يساعدك ذلك في تجاهل نتائج التقييم
المرسَلة التي تتضمّن بيانات احتيالية بوضوح. يمكنك أيضًا استخدام
Players.hideلإخفاء اللاعبين الذين تعتقد أنّهم أرسلوا نتائج احتيالية من كل قوائم الصدارة في تطبيقك.
ترتيب قوائم الصدارة
يمكن أن تتضمّن قوائم الصدارة أحد نوعَي الترتيب التاليَين:
- تظهر قوائم الصدارة كلما كان حجمها أكبر، كان ذلك أفضل تلقائيًا. هذا هو عادةً ما يظهر في معظم الألعاب التي يحصل فيها اللاعبون على نقاط.
- يتم أحيانًا استخدام قوائم الصدارة الأصغر حجمًا أفضل في الحالات التي يكون فيها تسجيل نتيجة أصغر حجمًا أفضل. إنّ أمثلة هذا النوع من القوائم الأكثر شيوعًا هي في ألعاب السباقات، حيث تمثّل النتيجة وقته لإنهاء السباق.
تنسيق النتيجة
على الرغم من أنّه يتم إرسال جميع النتائج إلى قوائم الصدارة وتخزينها داخليًا كأعداد تكاملية طويلة، يمكن لخدمة "ألعاب Play" عرضها للمستخدم بعدة تنسيقات مختلفة:
تعرِض قوائم الصدارة الرقمية النتائج كأرقام. ويمكن عرضها كأعداد صحيحة أو كأعداد حقيقية بعدد ثابت من الأرقام العشرية. يتم إرسال النتيجة كأرقام صحيحة ويتم إدراج النقطة العشرية في الموضع المحدّد. على سبيل المثال، سيتم عرض النتيجة
314159على النحو التالي:3.14159أو3141.59أو314159، استنادًا إلى الموضع العشري الذي حدّدته.تعرض قوائم الصدارة الوقت النتائج بالساعات / الدقائق / الثواني / الكسور المئوية من الثانية. يجب إرسال النتائج بالمللي ثانية، وبالتالي سيتم تفسير
66032على أنّه1:06.03.تقدّم قوائم الصدارة للعملة النتائج بتنسيق عملة. أرسِل النقاط مقسومة على 1,000,000 من وحدة العملة الرئيسية. على سبيل المثال، سيتم تفسير النتيجة 19,950,000 على أنّها
$19.95، بافتراض أنّك حدّدت العملة على أنّها دولار أمريكي.
تتيح قوائم الصدارة الرقمية أيضًا استخدام وحدات مخصّصة. على سبيل المثال، إذا كانت لعبتك تُقيِّم أعلى النتائج بالمتر، يمكنك تحديد "متر" كوحدة تلقائية لجدول صدارة اللعبة.
الترجمات وتنسيق الدرجات
عندما تطلب مكتبات تطبيقات العميل للأجهزة الجوّالة بيانات قوائم الصدارة من "خدمات ألعاب Play"، تحدّد لغة وإعدادات لغة لعرض هذه النتائج. تتيح لك واجهة برمجة التطبيقات REST تحديد لغة مستندة إلى المنطقة الجغرافية أيضًا. تعرض "خدمات ألعاب 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، وتشارك لوحات الصدارة على جميع هذه الأنظمة الأساسية).
عمليات تنفيذ العميل
للتعرّف على كيفية تنفيذ قوائم الصدارة لمنصّتك، اطّلِع على المراجع التالية: