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