تشكّل لوحات الصدارة وسيلة ممتعة لزيادة المنافسة بين اللاعبين، سواء أشدّ معجبيك (الذين سيتنافسون للحصول على المركز الأول في الجمهور العام) في الصدارة) ولللاعبين العاديين (الذين يهتمون مقارنة مستوى تقدمهم مع تقدم أصدقائهم).
للتعرّف على كيفية تطبيق قوائم الصدارة على منصتك، راجع عمليات تنفيذ العملاء.
فهم قوائم الصدارة
عند إنشاء لوحة صدارة، ستتولى "خدمات ألعاب 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 من وحدة العملة الرئيسية. على سبيل المثال، قد تكون درجة سيتم تفسير 19,950,000 على أنها
$19.95
، على افتراض أنك حددت بالدولار الأمريكي.
تتوافق أيضًا لوحات الصدارة الرقمية مع الوحدات المخصّصة. على سبيل المثال، إذا كانت لعبتك تقيس أعلى الدرجات بالأمتار، يمكنك تحديد "أمتار" كوحدة افتراضية قائمة الصدارة الخاصة بك.
الترجمات وتنسيق النتائج
عندما تطلب مكتبات برامج الأجهزة الجوّالة بيانات قوائم الصدارة من خدمة "الألعاب"، تحدد اللغة والمكان الذي سيتم عرض هذه النتائج به. تعمل REST على تتيح لك هذه الواجهة تحديد لغة واللغة كذلك. تعرض خدمة "الألعاب" نتائج منسقة للوحة الصدارة المناسبة لتلك اللغة وهذا المكان. ستظهر هذه النتائج المنسّقة سواء أضفت الترجمات الخاصة بلوحة الصدارة.
بالنسبة إلى لوحات الصدارة العددية، يتم عرض تنسيق الأرقام بشكل مختلف لكل
. (على سبيل المثال، 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 للعبتك، ثم انتقِل إلى Grow (نمو) > ألعاب Play الخدمات > الإعداد والإدارة > ليدربورد، ثم انقر على زر إنشاء قائمة صدارة.
!["إضافة ليدربورد" الزر في لوحة "لوحات الصدارة" الرئيسية](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/leaderboardAddNew.png?authuser=6&hl=ar)
ثم ما عليك سوى ملء المعلومات المطلوبة لقائمة الصدارة هذه.
![نموذج مملوء لجولة "أفضل جولة" قائمة الصدارة](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/leaderboardSampleForm.png?authuser=6&hl=ar)
انقر على حفظ كمسودة، وستكون لوحة الصدارة متاحة في "المسودة" الولاية. بعد نشر لعبتك، يتم نشر جميع قوائم الصدارة في لعبتك. معها.
إنشاء لوحة صدارة للعبة منشورة
لإنشاء لوحة صدارة إضافية للعبة تم نشرها من قبل، اتبع نفس الخطوات الموضحة أعلاه. لمزيد من المعلومات حول اختبار تحديث من لعبة، يُرجى الاطّلاع على نشر تغييرات لعبتك.
بعد اختبار لوحة الصدارة والرضا عنها، يمكنك إعادة نشرها لعبتك مع لوحات الصدارة الجديدة، وسيتم دفعها إلى العالم.
تعديل لوحة صدارة
لتعديل لوحة صدارة سبق لك إنشاؤها، انقر عليها في علامة التبويب لوحات الصدارة في Google Play Console في هذه المرحلة، سترى نفس النموذج الذي استخدمته عند إنشاء لوحة الصدارة، وستتمكن من قم بتحرير أي من الحقول كما تريد.
عند الانتهاء من تعديل لوحة صدارة، انقر على الزر حفظ كمسودة. تشير رسالة الأشكال البيانية ستكون لوحة الصدارة التي تم تعديلها حديثًا في "المسودة" والذي يسمح لك باختبار ذلك.
إذا كانت تعمل بشكل صحيح، اختَر نشر التغييرات من المربّع بجانب في أعلى نموذج لوحة الصدارة، وسيكون بإمكانك إعادة نشر لعبتك، مع كل قوائم الصدارة المعدّلة بشكل علني.
التراجع عن تعديل
إذا قررت عدم إعجابك بلوحة الصدارة التي تم تعديلها حديثًا وتريد الرجوع إلى إلى التكرار السابق، فما عليك سوى تحديد عودة من المربع الموجود أعلى نموذج ليدربورد. تعود لوحة الصدارة إلى الإصدار المنشور سابقًا .
حذف لوحة صدارة
يمكنك حذف لوحات الصدارة التي لا تزال في "المسودة". أو التي كانت المنشورة. لحذف لوحة صدارة في Google Play Console، يُرجى الانتقال إلى نموذج لوحة الصدارة، ثم انقر على حذف قائمة الصدارة في أعلى النموذج
وبدلاً من ذلك، يمكنك الاتصال
Players.hide
لإخفاء صورة لاعب
قائمة الصدارة في التطبيق
إعادة ضبط لوحة صدارة
لا يمكنك إعادة ضبط بيانات تقدّم اللاعب إلا في مسودّات لوحات الصدارة.
- لإعادة ضبط لوحات الصدارة في Google Play Console، انقر على إعادة ضبط التقدم عند في أعلى النموذج لهذا الحدث.
- لإعادة ضبط بيانات لوحة الصدارة آليًا، يمكنك طلب
طريقة
Scores
في Management API
إضافة ترجمات لقوائم الصدارة
يمكنك تحديد ترجماتك الخاصة لقوائم الصدارة المرتبطة بـ لعبتك. وقبل إجراء ذلك، عليك أولاً إكمال الخطوات الموضّحة في تؤدي إضافة ترجمات . ويجب أيضًا إنشاء لوحة صدارة واحدة أو أكثر للعبتك.
لإضافة ترجماتك الخاصة إلى قوائم الصدارة، افتح علامة التبويب لوحات الصدارة لعبتك في Google Play Console، ثم اختيار إحدى قوائم الصدارة الحالية في صفحة صفحة تفاصيل ليدربورد، انقر على علامة التبويب لإحدى اللغات التي التي تمت إضافتها في علامة التبويب تفاصيل اللعبة. في صفحة تفاصيل قائمة الصدارة لغة، فقم بتعديل النموذج الذي يتضمن ترجماتك للوحة الصدارة. (يُرجى النقر.) حفظ لتخزين التفاصيل المترجَمة في قائمة الصدارة
إخفاء نتائج لوحة الصدارة
توفّر "خدمات ألعاب Google Play" ميزة الحماية من التلاعب في لوحة الصدارة والتي يتحقق بحثًا عن النتائج التي يُشتبه في التلاعب بها ويخفيها تلقائيًا. هذه الميزة متوفّرة لألعاب Android فقط.
تكون ميزة "الحماية من التلاعب" مفعَّلة بشكل تلقائي في لوحات الصدارة الجديدة التي التي تنشئها لألعاب Android، ولكن يتم إيقافها في قوائم الصدارة الحالية. لتفعيل ميزة الحماية من التلاعب في لوحات الصدارة الحالية التي سبق وتم إدراجها تم نشره، اتبع الخطوات التالية:
- في Google Play Console، افتح علامة التبويب خدمات الألعاب، ثم اختَر من القائمة.
- افتح علامة التبويب لوحات الصدارة، ثم اختَر مثيل ليدربورد الذي تريد تمكين الحماية من التلاعب.
- فعِّل خيار تفعيل الحماية من التلاعب في لوحة الصدارة.
- انقر على حفظ ومتابعة.
- انشر لعبتك.
بعد تفعيل ميزة "الحماية من التلاعب" في لوحة الصدارة في Google Play Console، قد يستغرق تفعيل هذه الميزة مدة تصل إلى 24 ساعة. تم إرسال النتائج قبل تمكين الحماية من التلاعب لا يتم إخفاؤها بأثر رجعي.
في بعض الحالات، قد تحتاج إلى إيقاف ميزة "الحماية من التلاعب" (على سبيل المثال، في حال أردت تعمل لعبتك أيضًا على الويب بالإضافة إلى Android، كما تشارك إعلانات الصدارة عبر هذه المنصات).
عمليات التنفيذ للعملاء
للتعرّف على كيفية تطبيق ميزة "لوحات الصدارة" على منصتك، يمكنك الاطّلاع على ما يلي: الموارد: