Oyun fikirleri ve özellikleri

Sıradaki özelliğin

Paylaşılan nesneler

Yorumlanmayan oyun verilerini açık erişim ilkeleri, indeksli sorgular ve özgün revizyonlarla paylaşın.

SDK: developOyuncu oturumu gerekli
Godot
Paylaşılan nesneler görseli
Görünür sonuç

Oluşturmadan önce sahip kullanımını okuyun. Oluşturma bu kullanımın revizyonunu, güncelleme ve silme ise nesnenin özgün revizyonunu kullanır. Sahip, grup ve oluşturma sırasında belirlenen sona erme zamanı değişmez.

Video yakında

Bu adımın videosu henüz yok. Rehber ve MCP isteği kullanıma hazır.

Paylaşılan nesneler

Aynı projeyi hazırlayın

  1. Panelde oyun yapılandırmandaki projeyle aynı projeyi seç.

    Paylaşılan nesneler →
  2. Bu test kayıtlarını panel formunda oluşturun veya mevcut olanları kullanın. Bunlar örnek değerlerdir, güncel proje verileri değildir.

    Anahtar
    bases
    Okuma ilkesi
    all
    Yazma ilkesi
    owner
    Izgara konumu
    true
    Nesne başına en fazla bayt
    1024
    Sahip başına en fazla nesne
    1

    Anahtarlar ayrılmış olarak kalır. İlk kullanımdan sonra ilkeler, arama şeması, TTL ve konum değiştirilemez. Arşivleme yeni yazmaları engeller; okuma ve silme kullanılabilir durumda kalır.

    İlk örnek veri okur. Grup, maç veya nesne oluşturmaz. Boş liste geçerli bir ilk yanıttır.

  3. Örneği çalıştırmadan önce kaydedin, yeniden yükleyin ve doğrulayın. Diğer tanımları koruyun.

Bu özelliği ekle

Kılavuzu inceleyebilirsin. Çalıştırmak için etkin bir proje anahtarı gerekir. Projeyi hazırla

SDK kurulu, proje yapılandırması içe aktarılmış ve oyuncu oturum açmış olmalı.

Bu SDK örneği develop kullanır. Gerekli API'lerin kurulu SDK sürümünde bulunduğunu kontrol et.

Hızlı başlangıç bağlantısını ilgili oyuncuyla tamamlayın. read_world_map() çağrısını açık bir düğme veya sahne eyleminden yapın. Dosyayı açmak tek başına istek göndermez.

GDScript
res://scripts/shared_objects.gd
horizOn çağrısı
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.
Tam SDK örneğini aç ↗

Dünya haritası

Sahiplerin üslerini yorumlanmayan baytlar olarak saklayın. Yapılandırılmış tam sayı koordinatlı ızgara dikdörtgenini açıkça sorgulayın; nesnenin özgün revizyonuyla güncelleyin. Konum bir sorgu indeksidir ve oyun kurallarını doğrulamaz.

Asenkron PvP

Sınırlı, eşit dağılımlı olmayan bir tam sayı sorgusuyla rakip seçin. Savunma baytlarını yükleyin ve oyunu sunucunun yönettiği bir Validated Actions çalıştırmasıyla doğrulayın. Yalnızca güvenilir bir backend sonuca karar verir ve değiştirilemez bir Inbox bildirimi gönderir.

Eşleşen oyuncu oturumlarını, kalıcı olarak saklanan özgün yazma niyetini ve açıkça istenen sınırlı okumaları kullanın. Güvenilir sonuç doğrulama ve Inbox teslimi oyun backend’inizde yapılmalıdır; Account Keys asla oyun derlemelerinde yer almamalıdır.

Yeni özelliğini test et.

Oluşturmadan önce sahip kullanımını okuyun. Oluşturma bu kullanımın revizyonunu, güncelleme ve silme ise nesnenin özgün revizyonunu kullanır. Sahip, grup ve oluşturma sırasında belirlenen sona erme zamanı değişmez.

Panelde oyun yapılandırmandaki projeyle aynı projeyi seç.

Uç noktalar
  • 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 referansındaki tüm uç noktalar
Skor Tabloları görseli
Sıradaki adım için önerimiz

Her tura bir yüksek puan ekle.

Turdan sonra puanı kaydet ve kimin önde olduğunu göster. Bağlantını ve oyuncu oturumunu kullanmaya devam et.