أفكار وميزات للعبة

ميزتك التالية

الكائنات المشتركة

شارك بيانات اللعبة غير المفسرة باستخدام سياسات وصول صريحة واستعلامات مفهرسة ومراجعات أصلية.

SDK: فرع developتتطلب جلسة لاعب
Godot
رسم توضيحي لميزة الكائنات المشتركة
النتيجة المرئية

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

الفيديو قادم لاحقًا

لا يوجد فيديو لهذه الخطوة بعد. الدليل وطلب MCP متاحان للاستخدام.

الكائنات المشتركة

جهّزوا المشروع نفسه

  1. اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

    الكائنات المشتركة →
  2. أنشئوا إدخالات الاختبار هذه أو أعيدوا استخدام الموجود منها في نموذج لوحة التحكم. القيم أمثلة وليست بيانات المشروع الحالية.

    المفتاح
    bases
    سياسة القراءة
    all
    سياسة الكتابة
    owner
    الموضع في الشبكة
    true
    الحد الأقصى للبايتات لكل كائن
    1024
    الحد الأقصى للكائنات لكل مالك
    1

    تبقى المفاتيح محجوزة. بعد أول استخدام، لا يمكن تغيير السياسات أو مخطط البحث أو TTL أو الموضع. تمنع الأرشفة عمليات الكتابة الجديدة؛ وتظل القراءة والحذف متاحين.

    يقرأ المثال الأول البيانات. لا ينشئ مجموعة أو مباراة أو كائناً. القائمة الفارغة استجابة أولى صالحة.

  3. احفظوا الإدخالات وأعيدوا تحميلها وتحققوا منها قبل المثال. احتفظوا بالتعريفات الأخرى.

أضف هذه الميزة

يمكنك الاطلاع على الدليل. يتطلب التنفيذ مفتاح مشروع نشطًا. تجهيز المشروع

SDK مُثبّت وإعداد المشروع مُستورد واللاعب مسجّل الدخول.

يستخدم مثال SDK هذا فرع develop. تحقّق من وجود واجهات API المطلوبة في SDK المثبّت.

أكملوا اتصال البدء السريع باللاعب المقصود. استدعوا read_world_map() بزر أو إجراء مشهد صريح. فتح الملف وحده لا يرسل طلباً.

GDScript
res://scripts/shared_objects.gd
استدعاء horizOn
1extends Node
2​
3# Verified SDK Develop API. Call explicitly after restoring the existing player.
4func read_world_map() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.sharedObjects.queryObjects(user.userId, "bases", {
9 "mode": "rectangle", "minX": -10, "maxX": 10,
10 "minY": -10, "maxY": 10, "limit": 20
11 })
12 if not result.success:
13 push_warning(result.errorCode)
14 return
15 for object in result.data.objects:
16 var bytes: PackedByteArray = object.data
17 print(object.id, " bytes=", bytes.size())
18 # Respect result.data.pollAfterSeconds; no automatic poll or page loop.
19 # Keep dataBase64 and lossless search-string wrappers unchanged on metadata edits.
20 # Mutations need durable original bytes, IDs and If-Match revision before one send.
21 # An unknown create is reconciled through getRecoveryUsage/queryRecoveryObjects.
22 # No new identity, replacement revision or automatic create retry.
فتح مثال SDK الكامل ↗

خريطة العالم

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

PvP غير متزامن

اختر خصمًا باستعلام أعداد صحيحة محدود وغير منتظم التوزيع. حمّل بايتات دفاعه وتحقق من اللعب باستخدام تشغيل Validated Actions يديره الخادم. وحده خادم خلفي موثوق يقرر النتيجة ويرسل إشعار Inbox غير قابل للتغيير.

استخدم جلسات اللاعبين المطابقة، ونية الكتابة الأصلية المحفوظة بشكل دائم، وقراءات صريحة ومحدودة. يجب أن ينفذ خادم اللعبة الخلفي التحقق الموثوق من النتائج وتسليم Inbox؛ ويجب ألا تتضمن إصدارات اللعبة Account Keys مطلقًا.

اختبر ميزتك الجديدة.

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

اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

نقاط النهاية
  • GET/shared-objects/collections
  • GET/shared-objects/{collection}/usage
  • GET/shared-objects/{collection}/objects/{objectId}
  • POST/shared-objects/{collection}/query
  • POST/shared-objects/{collection}/objects
  • PUT/shared-objects/{collection}/objects/{objectId}
  • DELETE/shared-objects/{collection}/objects/{objectId}
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

أضف رقمًا قياسيًا لكل جولة.

احفظ النتيجة بعد الجولة وأظهر المتصدر. واصل استخدام اتصالك وجلسة اللاعب.