لوحات الصدارة الجديدة - داخلية

المواد ذات الصلة

مقدمة إلى وحدات تخزين البيانات التاريخية

وحدة تخزين البيانات

توفر معلومات مفصلة في المواد المذكورة أعلاه؛ فيما يلي نبذة موجزة عن وحدة تخزين البيانات.وحدة تخزين البيانات هي وحدة اختيارية. عند تمكينها، تسمح لمطوري الخرائط باستخدام جداول البيانات المستندة إلى الخادم لتخزين البيانات، وتخدم بشكل أساسي مزامنة المعلومات عبر الخرائط والمطابقة عبر الخرائط، ولوحات المتصدرين، والوظائف المماثلة. تركز هذه المقالة بشكل خاص على تطبيق جداول تخزين البيانات الجديدة لوظيفة لوحة المتصدرين.

نقطة الوصول

قم بتحميل وحدة تخزين البيانات من قائمة الوحدات لبدء تكوين أنواع أعمدة جدول البيانات الأربعة:

مقدمة عن الجدول الجديد

كما هو الحال مع جميع جداول البيانات، يتطلب كل جدول تحديد عمود ”مفتاح“، والذي يعمل كمفتاح أساسي للجدول. يجب أن تكون البيانات الموجودة في عمود المفتاح فريدة من نوعها وتعمل كعمود فهرس للجدول بأكمله. من خلال الاستعلام عن المفتاح، يمكنك تحديد صف بيانات معين داخل الجدول المحدد. عند تحرير صفوف البيانات التي تحتوي على نفس المفتاح عدة مرات عبر المحرر، ستحل التعديلات اللاحقة محل البيانات السابقة دائمًا.

ورقة بيانات الترتيب

ورقة بيانات الترتيب هي جدول متعدد القوائم متخصص. يمكنك تخصيص عدة أعمدة لتخزين معلومات إضافية، مثل النقاط ومدة البقاء وإجمالي وقت اللعب وما إلى ذلك. ومع ذلك، يجب أن تحتوي ورقة بيانات الترتيب على عمود بيانات واحد (عمود القيمة) للفرز التصاعدي أو التنازلي.

سيؤدي تحديد UID كمفتاح إلى تحويل عمود المفتاح تلقائيًا إلى بطاقات لاعبين:

مثال على ورقة البيانات

ورقة بيانات الترتيب 1

جدول بيانات متعدد الأعمدة

تدعم الجداول متعددة الأعمدة أعمدة بيانات متعددة (بخلاف جداول البيانات أحادية العمود السابقة). يمكنك تخزين بيانات متنوعة تحت مفتاح واحد. يوفر البرنامج النصي للعنصر واجهات برمجة تطبيقات لتحرير جداول الترتيب والجداول متعددة الأعمدة المرتبطة بها. عندما تتطابق المفاتيح (على سبيل المثال، كلاهما UUID للاعبين)، يمكن لعناصر محددة تحرير جداول الترتيب وجداول البيانات متعددة الأعمدة في وقت واحد.

توضيح الجدول

جدول بيانات متعدد الأعمدة1

وظيفة لوحة المتصدرين

تمكين الميزة

لتنشيط وظيفة لوحة المتصدرين، يجب تمكين وحدة تخزين البيانات داخل مشروعك وإنشاء جدول بيانات لوحة المتصدرين واحد على الأقل.

بمجرد الانتهاء من الإعداد، قم بتحرير الخريطة التي تنوي نشرها في واجهة نشر الخرائط Creator Centre للوصول إلى الإعدادات المتعلقة بلوحة المتصدرين:

سيؤدي تمكين هذه الميزة إلى عرض زر ”لوحة المتصدرين“ على صفحة تفاصيل الخريطة، مما يسمح للاعبين بعرض معلومات لوحة المتصدرين التي قمت بتحريرها:

محرر الترتيب

ضمن واجهة محرر الترتيب للخرائط المنشورة، يمكنك حاليًا تحديد جدول بيانات واحد فقط لعرض معلومات الترتيب. (على الرغم من أنه يمكن استخدام جداول متعددة لتخزين البيانات داخل المشروع)

يمكنك تعديل جوانب أخرى من لوحة المتصدرين: بما في ذلك ما إذا كنت تريد عرضها خارج اللعبة، والأعمدة التي تريد استخدامها لتصميم لوحة المتصدرين، وترتيبها.

يتيح لك تحديد لغات متعددة تعديل المعلومات متعددة اللغات لعنوان لوحة المتصدرين يدويًا:

اللغات التي لم يتم ملؤها ستستخدم أسماء أعمدة الجدول الافتراضية.

بعد التحرير، سيتم عرض معاينة لوحة المتصدرين الحالية على صفحة معلومات الخريطة. لن يظهر النص متعدد اللغات في المعاينة:

البيانات الوصفية

استخدم العنصر الرسومي في المواقف المناسبة — مثل عندما يسجل اللاعب نقاطًا أو عند انتهاء كل مباراة — لتخزين البيانات في قاعدة بيانات لوحة المتصدرين.

لاحظ أن المعلمة SheetName لن تقرأ من ورقة بيانات لوحة المتصدرين التي تم إنشاؤها إلا إذا كان العنصر الرسومي مرتبطًا بشكل خاص بـ ورقة بيانات لوحة المتصدرين.

لتسهيل تحرير تنسيقي القوائم المتعددة المقدمين في هذا البرنامج التعليمي، تمت إضافة نوع قائمة متخصص يسمى Tuple. يتعرف نوع Tuple تلقائيًا على القيم من أوراق البيانات المحددة أو أوراق بيانات لوحة المتصدرين، مكونًا قائمة متخصصة حيث يلتزم كل عنصر بنوع البيانات المحدد.

تقوم البدائية التوبولية تلقائيًا بقراءة جميع الجداول وتبني أنواع بيانات أعمدة الجدول كأنواع بيانات لعناصر القائمة:

بالنسبة لجداول بيانات التصنيف، بمجرد إنشاء عمود بيانات مخصص، ستحتوي القيمة فعليًا على N أعمدة من البيانات، وبالتالي تشكل مجموعة:

وبالتالي، في الاستخدام العملي، قد تصبح التوافيق متداخلة:

لا تقوم العناصر الأولية للمجموعات بتحديث أسماء أعمدة الجدول أو المعلومات ذات الصلة تلقائيًا. وبالتالي، فإن أي تعديلات تتطلب تحديث العنصر الأولي للمجموعة يدويًا.

كود

مثال على الكود:

1. كتابة

WriteDBLeaderboardAssociationValue(``”rank“``, ``’test_uid_1‘``, {``60``, ``”1:00“``}, ``”“``, out var c, out var d)
go

2. قراءة

ReadDBLeaderboardAssociationValue(``”rank“``, ``’test_uid_1‘``, out var data, ``”“``, out var a, out var b)``var data_normal List<object> = data[``2``] as List<object>``LogWarning(data_normal[``1``])
go

قائمة واجهات برمجة التطبيقات ذات الصلة

1. SetTuple
2. GetTuple
3. WriteDBLeaderboardAssociationValue
4. RemoveFromLeaderboardDataStoreByKey
5. ReadDBLeaderboardAssociationValue
6. WriteToLeaderboardDataStore
7. RemoveFromLeaderboardDataStoreByKey
8. ReadFromLeaderboardDataStore

على وجه التحديد، بالنسبة للوظيفة: ReadDBLeaderboardAssociationValue، فإن قيمة الإرجاع هي مجموعة:

النتيجة: النوع هو {rankname_value}Tuple

• {rank, key, value}
• rank: int
• key: string
• value: tuple
• {value, GameCompletionTime}

بالنسبة للوظيفة: WriteDBLeaderboardAssociationValue، المعلمات Key و Value:

• Key: يوصى بتحويل UID اللاعب إلى سلسلة كالمفتاح، بحيث يمكن عرض رمز اللاعب في Craftland
• Value: النوع هو {rankname} Tuple. بعد تحديد SheetName، انقر نقرًا مزدوجًا فوق Value لإضافة الكتلة المقابلة بسرعة
  لمزيد من التفاصيل حول معلمات API والوثائق، يرجى الرجوع إلى: الوثائق الرسمية

التصحيح المحلي

أثناء تحرير الخريطة، لا يمكن الوصول إلى بيانات اللاعبين الحية. ومع ذلك، يوفر Craftland Studio PC طريقة لعرض بيانات التصحيح المخزنة عبر ملفات JSON المحلية.

بعد تخزين البيانات أثناء التصحيح، سيؤدي النقر فوق الخيار الموضح في الصورة إلى الانتقال إلى مجلد JSON المحلي. يتم تخزين معلومات جدول البيانات بتنسيق JSON، مما يتيح للمطورين التحقق من صحة المنطق.