يمكن أن تكون لوحات الصدارة طريقة ممتعة لتشجيع المنافسة بين اللاعبين، سواءً كانوا من أشدّ المعجبين (الذين سيتنافسون على المركز الأول في لوحة صدارة عامة) أو من اللاعبين العاديين (الذين سيهتمون بمقارنة مستوى تقدّمهم بمستوى تقدّم أصدقائهم).
للتعرّف على كيفية تنفيذ لوحات الصدارة على منصتك، يُرجى الاطّلاع على مقالة عمليات التنفيذ من جهة العميل.
التعرّف على لوحات الصدارة
عند إنشاء لوحة صدارة، ستتولّى "خدمات ألعاب Play" إدارة معظم جوانب هذه اللوحة نيابةً عنك. وتسير العملية النموذجية على النحو التالي:
- في نهاية اللعبة (أو في لحظة مناسبة تحدّدها)، تُرسِل اللعبة نتيجة اللاعب إلى لوحة صدارة واحدة أو أكثر أنشأتها للعبة.
- تتحقّق "خدمات ألعاب Play" مما إذا كانت هذه النتيجة أفضل من النتيجة الحالية للاعب في لوحة الصدارة، سواءً كانت النتيجة اليومية أو الأسبوعية أو النتيجة الأفضل على الإطلاق. إذا كانت كذلك، تعدِّل "خدمات ألعاب Play" لوحات الصدارة المقابلة بالنتيجة الجديدة.
- تُرسِل "خدمات ألعاب Play" تقريرًا بالنتيجة إلى عميل اللعبة. ويُعلم هذا التقرير العميل ما إذا كانت هذه النتيجة هي أعلى نتيجة جديدة على الإطلاق أو أعلى نتيجة يومية أو أسبوعية. إذا لم تكن كذلك، ستُعلم "خدمات ألعاب Play" العميل بأعلى نتيجة حالية على الإطلاق أو أعلى نتيجة يومية أو أسبوعية لهذا اللاعب.
- لاسترداد نتائج اللاعب في لوحة صدارة، يمكنك طلب إطار زمني (يومي أو أسبوعي أو على الإطلاق)، وتحديد ما إذا كان المستخدم يريد الاطّلاع على لوحة صدارة اجتماعية أو عامة أم لا. تُجري "خدمات ألعاب Play" جميع عمليات الفلترة اللازمة، ثم تُرسِل النتائج إلى العميل.
- في الحالات التي تتضمّن الكثير من النتائج التي يجب الإبلاغ عنها، لا تُرسِل "خدمات ألعاب Play" إلا بيانات أعلى النتائج في لوحة الصدارة. يمكنك أيضًا استرداد بيانات النتائج الأولية لأعلى النتائج أو النتائج المجاورة لنتائج اللاعب.
لوحات صدارة متعددة
يمكن أن تتضمّن الألعاب لوحات صدارة متعددة، بحد أقصى 70 لوحة. على سبيل المثال، قد توفّر لعبة متعددة المستويات لوحة صدارة مختلفة لكل مستوى، وقد تتضمّن لعبة سباق لوحة صدارة منفصلة لكل مضمار.
الأطر الزمنية للوحات الصدارة
تُنشئ حزمة تطوير البرامج (SDK) لألعاب Play تلقائيًا إصدارات يومية وأسبوعية وعلى الإطلاق من كل لوحة صدارة تنشئها. لست بحاجة إلى إنشاء لوحات صدارة منفصلة لكل إطار زمني.
تتم إعادة ضبط لوحات الصدارة اليومية في الساعة 12 صباحًا بتوقيت المحيط الهادي (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,000,000 من وحدة العملة الرئيسية. على سبيل المثال، سيتم تفسير النتيجة 19,950,000 على أنّها
$19.95، على افتراض أنّك حدّدت عملتك بالدولار الأمريكي.
تتيح لوحات الصدارة الرقمية أيضًا استخدام وحدات مخصّصة. على سبيل المثال، إذا كانت لعبتك تقيس أعلى النتائج بالأمتار، يمكنك تحديد "الأمتار" كوحدة تلقائية للوحة الصدارة.
الترجمات وتنسيق النتائج
عندما تطلب مكتبات عميل الأجهزة الجوّالة بيانات لوحة الصدارة من "خدمات ألعاب Play"، فإنّها تحدّد لغة ولغةً محليةً لعرض هذه النتائج. تتيح لك واجهة برمجة تطبيقات REST API تحديد لغة تستند إلى اللغة المحلية أيضًا. تُرسِل "خدمات ألعاب Play" نتائج لوحة الصدارة المنسّقة المناسبة لتلك اللغة واللغة المحلية. ستظهر هذه النتائج المنسّقة سواءً أضفت ترجمات للوحة الصدارة أم لا.
بالنسبة إلى لوحات الصدارة الرقمية ، يتم عرض تنسيق الأرقام بشكلٍ مختلف حسب اللغة. (على سبيل المثال، 12,345.78 في الولايات المتحدة، و12 345,78 في فرنسا). إذا
كنت تستخدم وحدات مخصّصة وأضفت
ترجمات إلى لعبتك
، عليك توفير وحدات مترجَمة لكل لغة أضفتها. بعد ذلك، تعرض الخدمة هذه الوحدات المترجَمة حيثما كان ذلك مناسبًا.
استنادًا إلى اللغة التي تختارها، قد تحتاج إلى توفير إصدارات مختلفة من أسماء وحداتك. باللغة الإنجليزية، ستحتاج إلى إصدار لعنصر واحد، وإصدار آخر لكل شيء آخر (على سبيل المثال، "meter" و"meters"). في المقابل، ستحتاج باللغة البولندية إلى توفير إصدار لوحدة واحدة، وإصدار لبضع وحدات، وإصدار للعديد من الوحدات، وإصدار لكل شيء آخر. لمزيد من المعلومات عن قواعد الجمع، يُرجى الاطّلاع على مقالة سلاسل الكمية(الجمع).
بالنسبة إلى لوحات الصدارة الزمنية ، يتم عرض تنسيق الوقت وفقًا للغة اللاعب واللغة المحلية. سيكون ذلك ملحوظًا بشكلٍ أساسي إذا كنت تستخدم أجزاء من الثانية أو إذا كانت قيمة الساعات تتضمّن أكثر من 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
Scoresmethods.
إضافة ترجمات إلى لوحات الصدارة
يمكنك تحديد ترجماتك الخاصة للوحات الصدارة المرتبطة باللعبة. قبل إجراء ذلك، تأكَّد أولاً من إكمال الخطوات الموضّحة في مقالة إضافة ترجمات للعبتك. يجب أيضًا أن تكون قد أنشأت لوحة صدارة واحدة أو أكثر للعبتك.
لإضافة ترجماتك الخاصة إلى لوحات الصدارة، افتح علامة التبويب لوحات الصدارة للعبة في Google Play Console، ثم اختَر لوحة صدارة حالية. في صفحة تفاصيل لوحة الصدارة، انقر على علامة التبويب للغة سبق أن أضفتها في علامة التبويب تفاصيل اللعبة. في صفحة تفاصيل لوحة الصدارة لتلك اللغة، عدِّل النموذج باستخدام ترجماتك للوحة الصدارة هذه. انقر على حفظ لتخزين تفاصيل لوحة الصدارة المترجَمة.
إخفاء نتائج قائمة الصدارة
توفّر "خدمات ألعاب Google Play" ميزة "الحماية من التلاعب" في لوحة الصدارة، وذلك من خلال التحقّق من النتائج المُشتبَه فيها وإخفاؤها تلقائيًا. تتوفّر هذه الميزة لألعاب Android فقط.
تكون ميزة "الحماية من التلاعب" مفعّلة تلقائيًا في لوحات الصدارة الجديدة التي تنشئها للعبة Android، ولكن تكون غير مفعّلة في لوحات الصدارة الحالية. لتفعيل ميزة "الحماية من التلاعب" في لوحات الصدارة الحالية التي سبق نشرها، اتّبِع الخطوات التالية:
- في Google Play Console، افتح علامة التبويب خدمات الألعاب ، ثم اختَر لعبتك من القائمة.
- افتح علامة التبويب لوحات الصدارة ، ثم اختَر نسخة لوحة الصدارة التي تريد تفعيل ميزة "الحماية من التلاعب" فيها.
- فعِّل الخيار تفعيل ميزة "الحماية من التلاعب" في لوحة الصدارة.
- انقر على حفظ ومتابعة.
- انشر لعبتك.
بعد تفعيل ميزة "الحماية من التلاعب" في لوحة صدارة في Google Play Console، قد يستغرق تطبيق هذه الميزة مدة تصل إلى 24 ساعة. ولا يتم إخفاء النتائج التي تم إرسالها قبل تفعيل ميزة "الحماية من التلاعب" بأثر رجعي.
في بعض الحالات، قد يتطلّب الأمر إيقاف ميزة "الحماية من التلاعب" (على سبيل المثال، إذا كانت لعبتك تعمل أيضًا على الويب بالإضافة إلى Android، وتشارك لوحات الصدارة على هذه الأنظمة الأساسية).
عمليات التنفيذ من جهة العميل
للتعرّف على كيفية تنفيذ لوحات الصدارة على منصتك، يُرجى الاطّلاع على المراجع التالية: