يوضّح هذا المستند كيفية دمج ميزة "إحصاءات اللعب" في لعبتك باستخدام Google Play Console. ويشمل تنسيقات ملفات CSV وZIP الأساسية، ويشرح كيفية إنشائها واستيرادها وإدارتها.
إنشاء الأحداث أو استيرادها
هناك طريقتان لإضافة أحداث لأول مرة باستخدام Google Play Console:
- إنشاء حدث: يمكنك إضافة حدث واحد في كل مرة.
- استيراد الأحداث: استيراد أحداث متعدّدة
إنشاء حدث
لإنشاء حدث خاص بإحدى الألعاب، أكمِل الخطوات التالية:
- اختَر لعبة في Google Play Console.
- في صفحة إحصاءات الألعاب ضمن خدمات ألعاب Play (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات الألعاب)، اختَر إضافة حدث > إنشاء حدث.
- في صفحة إنشاء حدث، املأ النموذج.
- انقر على حفظ التغييرات.
استيراد أحداث
لإضافة أحداث متعدّدة إلى لعبتك في آنٍ واحد، اتّبِع الخطوات التالية:
- أنشئ ملف CSV للأحداث PlayerGameEvent.csv.
- اختَر لعبة في Google Play Console.
- في صفحة إحصاءات الألعاب ضمن خدمات ألعاب Play (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات الألعاب)، اختَر إضافة حدث > الاستيراد من خلال ملف CSV.
- في صفحة إعدادات الأحداث، أفلِت ملف CSV لتحميله.
- بعد إنشاء حدث، عليك إعداد الإحصاءات.
إنشاء إحصاءات أو استيرادها
هناك طريقتان لإضافة الإحصاءات لأول مرة باستخدام Google Play Console:
- إنشاء إحصائية: أضِف إحصائية واحدة في كل مرة.
- إحصاءات الاستيراد: استيراد إحصاءات متعددة
إنشاء إحصاء
لإنشاء إحصائية للعبة، أكمِل الخطوات التالية:
- اختَر لعبة في Google Play Console.
- في صفحة إحصاءات اللعبة ضمن خدمات ألعاب Play (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات اللعبة)، اختَر إضافة إحصاء > إنشاء إحصاء.
- في صفحة إنشاء إحصائية، املأ النموذج.
- انقر على حفظ التغييرات.
- بعد إنشاء إحصاء، انشر لعبتك.
إحصاءات الاستيراد
لاستيراد الإحصاءات، اتّبِع الخطوات التالية:
- أنشئ ملف ZIP يحتوي على الإحصاءات وملفات الترجمة وملفات الرموز وفقًا لإرشادات ملف ZIP الخاص بالإحصاءات.
- اختَر لعبة في Google Play Console.
- في صفحة إحصاءات اللعبة ضمن خدمات ألعاب Play (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات اللعبة)، اختَر إضافة إحصاء > الاستيراد من خلال ملف ZIP.
- في صفحة إعدادات إحصاءات اللعب، أفلِت ملف ZIP لتحميله.
- بعد تحميل جميع الإحصاءات، انشر لعبتك.
اختبار "إحصاءات اللعب"
للتأكّد من أنّ "إحصاءات الألعاب" تعمل على النحو المطلوب، اتّبِع الخطوات التالية لاختبارها:
- في Play Console، يمكنك إعداد مسار اختبار داخلي.
- أضِف حسابات اختبارية إلى مشروع لعبتك للمختبِرين.
- أنشئ ملفًا شخصيًا على "خدمات ألعاب Play" لأحد الحسابات التجريبية باستخدام تطبيق "ألعاب Play".
- افتح اللعبة باستخدام حساب الاختبار نفسه الذي أنشأت له ملفًا شخصيًا على "خدمات ألعاب Play".
- تأكَّد من ظهور رسالة "الترحيب" من "خدمات ألعاب Play" على الشاشة كإشارة إلى إتمام عملية المصادقة التلقائية بنجاح عند تشغيل اللعبة.
- يمكن لمستخدم الحساب التجريبي تشغيل اللعبة لتفعيل الأحداث. راجِع استجابة واجهة برمجة التطبيقات لمعرفة ما إذا تم تسجيل الأحداث.
إدارة إعدادات ظهور "إحصاءات اللعب" على جهازك لأغراض الاختبار
بعد أن تصبح اللعبة متاحة للمختبِرين في Play Console، اتّبِع الخطوات التالية لعرض إحصاءات اللعب على جهازك:
محو ذاكرة التخزين المؤقت في "متجر Google Play":
- افتح تطبيق الإعدادات على الجهاز.
- انقر على التطبيقات > متجر Google Play.
- انقر على مساحة التخزين وذاكرة التخزين المؤقت، ثم انقر على محو ذاكرة التخزين المؤقت.
افتح تطبيق متجر Google Play.
يمكنك الاطّلاع على إحصاءات اللعب باستخدام قسم تتبُّع مدة اللعب أو ملفّك الشخصي كلّاعب:
الطريقة 1: استخدام قسم "تتبُّع مدة اللعب"
انتقِل إلى قسم تتبُّع وقت اللعب، ثم انقر عليه للاطّلاع على إحصاءات اللعبة.
الطريقة 2: استخدام ملفك الشخصي كلاعب
- انقر على علامة التبويب أنت، ثم على ملفك الشخصي كلاعب.
- انتقِل إلى قسم إحصاءات الألعاب.
- بالنسبة إلى النطاق الزمني، اختَر الكل.
- إذا لم تظهر لعبتك، انقر على عرض كل الألعاب.
- اختَر لعبتك للاطّلاع على إحصاءاتها.
عرض السجلات على جهازك
للتأكّد من أنّ "إحصاءات الألعاب" تعمل على النحو المطلوب، فعِّل السجلّات على جهازك:
فعِّل تصحيح أخطاء adb على جهازك ونفِّذ الأوامر التالية في الوحدة الطرفية:
adb shell setprop log.tag.Games INFO adb logcat -s "PlayGamesServices[GameStatsAgent]:I"
تأكَّد من ظهور رسالة سجلّ ناجحة، كما هو موضّح في المثال التالي:
Successfully uploaded batch of X events.
ملاحظة: بما أنّ واجهة برمجة التطبيقات تتيح عمليات التحميل الجزئية، يشير سجلّ المعلومات هذا إلى أنّه تمت معالجة الدفعة. إذا تعذّر التحقّق من صحة المخطط لأي أحداث فردية ضمن المجموعة، سيسبق هذه الرسالة سجلّ أخطاء.
في حال تعذُّر التحقّق من صحة أي أحداث تم إرسالها، ستظهر لك رسالة خطأ توضّح سبب التعذّر:
BatchRecordEvents validation failed for X event(s): ...
نشر "إحصاءات الألعاب"
بعد الانتهاء من الاختبار، يجب نشر لعبتك. ويتم نشر جميع أحداث اللعبة وإحصاءاتها معها.
لنشرها، اتّبِع الخطوات التالية:
- في Google Play Console، اختَر لعبة.
- في صفحة إحصاءات اللعبة ضمن خدمات ألعاب Play (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات اللعبة)، انقر على المراجعة والنشر.
- في صفحة النشر ضمن "خدمات ألعاب Play" (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > النشر)، راجِع الإجراءات وحلّ المشاكل.
- انقر على نشر. يتم نشر جميع إحصاءات الألعاب.
تعديل "إحصاءات اللعب"
إذا كانت لديك إحصاءات ألعاب حالية وتريد تعديلها:
- اختَر لعبة في Google Play Console.
- انتقِل إلى صفحة إحصاءات اللعبة ضمن "خدمات ألعاب Play" (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات اللعبة).
- لتعديل حدث:
- في قسم إعدادات الأحداث، اختَر حدثًا.
- يمكنك إضافة سمات الأحداث أو حذفها.
- لا يمكنك تعديل اسم الحدث.
- انقر على حفظ التغييرات.
- لتعديل إحصاء:
- في قسم إعدادات إحصاءات اللعبة، اختَر إحصائية.
- يمكنك تعديل حقول اسم الإحصاءات ووصف الإحصاءات واسم ملف الرمز.
- لا يمكنك تعديل معرّف الإحصاءات أو اتجاه التقدّم. وحدة الإحصاء وتفاصيل الحدث المرتبط
- انقر على حفظ التغييرات.
- في صفحة خدمات ألعاب Play - إحصاءات اللعب، تظهر الإحصاءات المعدَّلة بالحالة متاحة للمختبِرين.
- بعد اختبار الإحصاء، انقر على المراجعة والنشر. يؤدي ذلك إلى إعادة نشر اللعبة للجميع، بالإضافة إلى جميع الإحصاءات المعدَّلة.
حذف "إحصاءات الألعاب"
بعد نشر "إحصاءات اللعبة"، لا يمكن حذفها.
يمكنك حذف حدث أو إحصاء في الحالة متاح للمختبِرين.
- اختَر لعبة في Google Play Console.
- انتقِل إلى صفحة إحصاءات اللعبة ضمن "خدمات ألعاب Play" (زيادة عدد المستخدمين > خدمات ألعاب Play > الإعداد والإدارة > إحصاءات اللعبة).
- لحذف حدث، اتّبِع الخطوات التالية:
- في قسم إعدادات الأحداث، اختَر حدثًا.
- انقر على حذف الحدث.
- لحذف إحصاء:
- في إعدادات إحصاءات اللعبة، اختَر الإحصاء الذي تريد حذفه.
- انقر على حذف إحصاءات المباراة.
إرشادات ملفات CSV للأحداث
الصف الأول من ملف CSV هو صف العناوين. يجب استيراد الأحداث باستخدام ملف CSV الخاص بالأحداث، مثل PlayerGameEvent.csv.
تنسيق ملف PlayerGameEvent.csv
يحتوي ملف CSV على الحدث المُعلَن وسماته كقيم مفصولة بفواصل بالترتيب التالي:
Event Name,Property Name,Property Type
إذا أرسلت الحدث progressUpdate للسمة progressionStat، أضِف صفًا لهذا الحدث. يجب أن يحتوي هذا الحدث على سمة currentProgress واحدة على الأقل من النوع INT أو STRING، بالإضافة إلى أي سمات أخرى تريد إرسالها.
يتم وصف هذه الحقول في الجدول التالي:
| عناوين أعمدة CSV | مطلوب أو اختياري | القيم المقبولة |
|---|---|---|
| اسم الحدث | مطلوب | 50 حرفًا كحدّ أقصى يجب أن يتألف من أحرف وأرقام وشرطات سفلية فقط. في حال استخدام اسم الحدث الخاص |
| اسم الموقع | مطلوب | 50 حرفًا كحدّ أقصى يجب أن يتألف من أحرف وأرقام وشرطات سفلية فقط. فريدة لكل حدث: يجب أن تكون أسماء السمات فريدة ضمن الحدث نفسه. لا تستخدِم الكلمات الرئيسية المحجوزة التالية: |
| نوع الموقع | مطلوب | سلسلة تعداد حساسة لحالة الأحرف وتطابق أحد أنواع البيانات المتوافقة:
INT64 أو DOUBLE أو STRING أو BOOL
|
متطلبات ملف PlayerGameEvent.csv:
- يمكن أن يتضمّن الملف 20 اسم حدث فريدًا كحدّ أقصى، مع ما يصل إلى 20 سمة لكل حدث.
- يجب ألا يكون محتوى الملف فارغًا وأن يحتوي على صف واحد على الأقل.
مثال على جدول
| اسم الحدث | اسم الموقع | نوع الموقع |
|---|---|---|
| matchCompleted | المدة | DOUBLE |
| matchCompleted | عمليات الإغلاق | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
إرشادات ملف ZIP الخاص بالإحصاءات
يمكنك استيراد الإحصاءات في آنٍ واحد باستخدام ملف ZIP. اطّلِع على الجدول لمعرفة أسماء الملفات المحددة التي يجب استخدامها في ملف ZIP:
| اسم الملف | مطلوب أو اختياري | القيم المقبولة |
|---|---|---|
RepetitiveStatsConfig.csv
|
مطلوب | يمثّل الإحصاء المتكرّر الإجراءات المتكررة التي ينفّذها اللاعبون داخل اللعبة. |
ProgressionStatConfig.csv
|
مطلوب | تمثّل إحصاءات مستوى التقدّم مستوى تقدّم اللاعب في إحدى الألعاب. |
StatLocalizations.csv
|
اختياري | يوفّر ترجمات لأسماء "إحصاءات الألعاب" وأوصافها. |
| ملفات الرموز | مطلوب | تحتوي على رموز بتنسيق PNG أو JPEG أو JPG بحجم 512 × 512. |
يجب أن يستوفي ملف ZIP المتطلبات التالية:
- الحدّ الأقصى لحجم ملف ZIP: الحدّ الأقصى لإجمالي الحجم غير المضغوط هو 10 ميغابايت.
- الحد الأقصى لعدد الملفات: 53 ملفًا كحد أقصى (3 ملفات CSV و50 رمزًا) داخل أرشيف ZIP.
- الحدّ الأقصى لإجمالي الإحصاءات: 50 إحصاءة كحدّ أقصى في
ProgressionStatConfig.csvوRepetitiveStatsConfig.csv. - ملفات CSV المتوافقة:
ProgressionStatConfig.csvوRepetitiveStatsConfig.csvوStatLocalizations.csv(اختياري). إذا كنت تريد تحميل إحصاءات التقدم فقط، لا تضمِّن ملف CSV الخاص بالإحصاءات المتكررة في ملف ZIP، وإلا ستعرض وحدة التحكّم خطأً. وينطبق الأمر نفسه إذا أردت تحميل إحصاءات متكررة فقط. - ملفات صور الرموز: PNG (.png) أو JPEG (.jpg أو .jpeg)
- يجب أن تكون جميع الرموز المُشار إليها في ملفات CSV متوفّرة في جذر ملف ZIP.
- يجب أن تشير إحصائية واحدة على الأقل إلى جميع ملفات الصور المتوفّرة في ملف ZIP.
- بنية الدليل: يجب أن تكون جميع الملفات في جذر ملف ZIP. لا يُسمح باستخدام الأدلة الفرعية.
تنسيق ملف RepetitiveStatsConfig.csv
يحتوي ملف CSV على الحدث المُعلَن وسماته كقيم مفصولة بفواصل بالترتيب التالي:
Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit
يتم وصف هذه الحقول في الجدول التالي:
| عناوين أعمدة CSV | مطلوب أو اختياري | القيم المقبولة |
|---|---|---|
| رقم تعريف الإحصائية | مطلوب | 100 حرف كحدّ أقصى يجب أن يتألف من أحرف وأرقام وشرطات سفلية فقط. يجب أن يكون المعرّف فريدًا بين جميع الإحصاءات في اللعبة. |
| اسم الحدث | مطلوب | 50 حرفًا كحدّ أقصى يجب أن يشير إلى اسم الحدث المحدّد في تنسيق PlayerGameEvent.csv. |
| اسم سمة الحدث | مطلوب | 50 حرفًا كحدّ أقصى |
| اسم الإحصائية المعروض | مطلوب | 50 حرفًا كحد أقصى الاسم المعروض التلقائي للإحصاء (اللغة التلقائية) يجب أن يكون فريدًا في جميع الإحصاءات. |
| Stat Description | مطلوب | 500 حرف كحدّ أقصى الوصف التلقائي للإحصاء |
| نوع التجميع | مطلوب | 50 حرفًا كحدّ أقصى SUM وMAX وMIN وCOUNT |
| فلترة الموقع | اختياري | 50 حرفًا كحد أقصى يجب أن يكون اسم السمة محدّدًا في الملف PlayerGameEvent.csv. |
| عامل الفلتر | اختياري | =, !=, >, <, >=, <=عوامل تشغيل مقارنة الفلاتر |
| قيمة الفلتر | اختياري | مقارنةً بسمة الفلتر
يجب أن تكون قيمة الفلتر INT64, DOUBLE, BOOL, STRING.
|
| هل هي تنافسية؟ | مطلوب | true, false
|
| الحدّ الأدنى | مطلوبة عندما تكون قيمة "التنافسية" هي "صحيح" | الحدّ الأدنى المسموح به لدرجة الإحصاءات التنافسية. |
| الحدّ الأقصى | مطلوبة عندما تكون قيمة "التنافسية" هي "صحيح" | الحدّ الأقصى المسموح به لنتائج الإحصاءات التنافسية |
| اسم ملف الرمز | مطلوب | اسم ملف صورة الرمز المضمّن في جذر ملف ZIP يجب ألا يتعارض مع أسماء ملفات الرموز المستخدَمة في الإحصاءات المتكرّرة. |
| اتجاه القيمة الجيدة | مطلوب | تحدّد ما إذا كانت القيم الأعلى INCREASING أو القيم الأقل DECREASING أفضل.
|
| وحدة | اختياري | تمثّل هذه السمة وحدة القياس للقيم الرقمية الأولية أو قيم المدة. على سبيل المثال، KILOMETER وSECOND وPERCENTAGE وUNITLESS. |
في حال عدم الرغبة في استخدام شرط الفلتر، اترُك الخلية فارغة.
مثال على جدول
| رقم تعريف الإحصائية | اسم الحدث | اسم الموقع | التجميع | اسم الإحصائية المعروض | Stat Description | سمة الفلتر (اختيارية) | عامل تشغيل الفلتر (اختياري) | قيمة الفلتر (اختيارية) | هل هي تنافسية؟ | minLimit | maxLimit | اسم ملف الرمز | اتجاه القيمة الجيدة | وحدة |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | المدة | MAX | Longest Match Survival | يشير ذلك إلى مدة بقاء اللاعب على قيد الحياة في أي مباراة | isWinner | = | TRUE | TRUE | 0 | 50 | stat1.png | في تراجع | ثانية |
| 2 | matchCompleted | isWinner | COUNT | المباريات التي فاز بها | يشير ذلك إلى عدد المباريات التي فاز بها أحد اللاعبين | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | في تزايد | |
| 3 | matchCompleted | عمليات الإغلاق | SUM | عمليات القتل في مباريات فردية | عدد عمليات القتل التي تم تنفيذها في المباريات الفردية | matchType | = | "1-on-1" | خطأ | stat4.png | في تزايد | |||
| 4 | itemCollected | coinsAmount | SUM | إجمالي الذهب الذي تمّ جمعه | لاعب يجمع العملات المعدنية أثناء اللعب في مباراة | weaponType | = | "سيف" | خطأ | stat2.png | في تزايد |
تنسيق ملف ProgressionStatConfig.csv
يحتوي ملف CSV على الحدث المُعلَن وسماته كقيم مفصولة بفواصل بالترتيب التالي:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
سيتم عرض إحصاءات مستوى التقدّم كأول إحصاءات تظهر للاعب في ملفه الشخصي كلاعب.
يتم وصف هذه الحقول في الجدول التالي:
| عناوين أعمدة CSV | مطلوب أو اختياري | القيم المقبولة |
|---|---|---|
| رقم تعريف الإحصائية | مطلوب | 100 حرف كحدّ أقصى يجب أن يتألف من أحرف وأرقام وشرطات سفلية فقط. يجب أن يكون المعرّف فريدًا بين جميع الإحصاءات في اللعبة. |
| اسم سمة الحدث | مطلوب | 50 حرفًا كحدّ أقصى يجب أن يكون اسم السمة محدّدًا في ملف PlayerGameEvent.csv. |
| اسم الإحصائية المعروض | مطلوب | يجب أن يكون الاسم فريدًا. |
| Stat Description | مطلوب | 50 حرفًا كحدّ أقصى الوصف التلقائي للإحصاء |
| اسم ملف الرمز | مطلوب | اسم ملف صورة الرمز المضمّن في جذر ملف ZIP يجب ألا يتعارض مع أسماء ملفات الرموز المستخدَمة في الإحصاءات المتكرّرة. |
| اتجاه القيمة الجيدة | مطلوب | تحدّد ما إذا كانت القيم الأعلى INCREASING أو القيم الأقل DECREASING أفضل.
|
| وحدة | اختياري | تمثّل هذه السمة وحدة القياس للقيم الرقمية الأولية أو قيم المدة. على سبيل المثال، KILOMETER وSECOND وPERCENTAGE وUNITLESS. |
مثال على جدول
| رقم تعريف الإحصائية | اسم سمة الحدث | اسم عرض الإحصاءات | وصف الإحصاء | اسم ملف الرمز | اتجاه القيمة الجيدة |
|---|---|---|---|---|---|
| 5 | currentProgress | المستوى | يجمع اللاعبون نقاط الخبرة من خلال لعب المباريات والانتقال إلى مستويات أعلى. | Level.png | زيادة |
تنسيق StatLocalizations.csv
يحتوي ملف CSV على الحدث المُعلَن وسماته كقيم مفصولة بفواصل بالترتيب التالي:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
يتم وصف هذه الحقول في الجدول التالي:
| عناوين أعمدة CSV | مطلوب أو اختياري | القيم المقبولة |
|---|---|---|
| رقم تعريف الإحصائية | مطلوب | 100 حرف كحدّ أقصى يجب أن يتألف من أحرف وأرقام وشرطات سفلية فقط. يجب أن يكون المعرّف فريدًا بين جميع الإحصاءات في اللعبة. |
| اسم الإحصائية المعروض | مطلوب | يجب أن يكون الاسم فريدًا. |
| اللغة | مطلوب | رمز اللغة، مثل en-US أضِف ترجمات للعبتك قبل تحديد اللغة. يُرجى العِلم أنّه لا يمكنك تحديد اللغة التلقائية. يمكنك العثور على رموز اللغات المتاحة في قائمة اللغات المتاحة. |
| الاسم المعروض للإحصائية المترجَمة | اختياري | يجب ألا يزيد عدد الأحرف عن 50 حرفًا. الاسم المعروض المترجَم للإحصاءات للّغة المحدّدة. |
| Localized Stat Description | اختياري | 500 حرف كحدّ أقصى وصف الإحصاءات المترجَم للّغة المحدّدة |
مثال على جدول
| رقم تعريف الإحصائية | اسم الإحصائية المعروض | رمز اللغة | اسم الإحصائية المترجَم (UTF-8) | وصف الإحصاءات المترجَم (UTF-8) |
|---|---|---|---|---|
| 1 | Longest Match Survival | es | Supervivencia más larga en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. |
| 1 | Longest Match Survival | fr | Survie du match le plus long | يشير ذلك إلى مدة بقاء اللاعب على قيد الحياة في أي مباراة. |
| 4 | إجمالي الذهب الذي تمّ جمعه | es | Oro total recolectado | La jugadora recoge monedas mientras juega en un partido |
| 4 | إجمالي الذهب الذي تمّ جمعه | fr | Or total collecté | Le joueur collecte des pièces en jouant un match |
ملفات الرموز
يجب أن تكون الرموز التي تشير إليها في ملف CSV متوفّرة في أرشيف ZIP الحالي الذي تستورده.
قواعد التحقّق من صحة الرموز هي:
| سمة التحقّق | قيد أو قاعدة مفروضة |
|---|---|
| الحد الأقصى لحجم الملف | الحد الأقصى لحجم ملف الرمز هو 1 ميغابايت (1,048,576 بايت). |
| الأبعاد | 512 × 512 بكسل بالضبط (العرض = 512، الارتفاع = 512) |
| نسبة العرض إلى الارتفاع | 1:1 (نسبة عرض إلى ارتفاع مربّعة) |
| التنسيقات المسموح بها | PNG (.png) وJPEG (.jpg و.jpeg) |
| موضع الإعلان في ملف ZIP | يجب أن يكون في الدليل الجذر في ملف ZIP. |
| التحقّق من الملفات المرجعية | يجب أن تكون جميع أسماء ملفات الرموز المحدّدة في أعمدة "اسم ملف الرمز" متوفّرة في ملف ZIP. |
| Orphan Check | يجب أن تشير إحصائية واحدة على الأقل إلى جميع ملفات الصور داخل ملف ZIP. |
| التحقّق من وجود تعارض | لا يمكن أن تتعارض أسماء ملفات الرموز في ProgressionStatConfig.csv مع RepetitiveStatsConfig.csv.
|
| الصور المكرّرة | يتم وضع علامة على الرموز المكرّرة. |
إرشادات حول الرموز
يجب إنشاء الرموز بتنسيق PNG أو JPEG أو JPG بحجم 512 × 512 وبخلفيات شفافة.
يُستخدم الرمز نفسه مع جميع اللغات، لذا ننصحك بعدم تضمين أي نص أو محتوى بلغة معيّنة في الرمز.
مواصفات الوحدة
تتحكّم أعمدة Unit في طريقة تنسيق قيم الإحصاءات الأولية وتكييفها مع اللغة المحلية للاعبين.
سمات الإحصاءات الرقمية (INT64 أو DOUBLE)
| قيمة الوحدة المسموح بها | مثال على القيمة الأولية |
| (Empty) / UNITLESS / NONE | 1234567 |
| % / PERCENTAGE / PERCENT | 0.857 |
| المسافة/الطول: سنتيمتر، متر، كيلومتر، قدم، بوصة، ميل، ياردة، مليمتر، نانومتر | 15 (كيلومتر) |
| السرعة: KILOMETER_PER_HOUR وMETER_PER_SECOND وMILE_PER_HOUR | 60 (MILE_PER_HOUR) |
خصائص إحصاءات المدة (DURATION)
| قيمة فئة التنسيق | قيم الوحدات المسموح بها | مثال على القيمة الأولية | مثال على الناتج المنسَّق |
| UNIT_BASED / DURATION | مطلوبة: SECOND وMINUTE وHOUR وDAY وWEEK وMONTH وYEAR | 5400 ثانية (ساعة) | ساعة ونصف |
| COMPONENT_NUMERIC / HH:MM:SS / CLOCK | مستوى التفاصيل (اختياري، القيمة التلقائية هي WHOLE_SECONDS): WHOLE_MINUTES وWHOLE_SECONDS وMILLISECONDS_ONE_DIGIT وMILLISECONDS_TWO_DIGITS وMILLISECONDS_THREE_DIGITS | 3661 ثانية | 01:01:01 |
| COMPONENT_TEXT / TEXT | أصغر وحدة (اختيارية، القيمة التلقائية هي SECONDS): SECONDS أو MINUTES أو HOURS أو DAYS أو MONTHS أو YEARS | 90000 ثانية | 1d 1h |
خصائص الإحصاءات غير الرقمية (STRING وBOOL)
يجب ترك أعمدة الوحدات فارغة.