Pomysły i funkcje gry

Twoja następna funkcja

Obiekty współdzielone

Udostępniaj nieinterpretowane dane gry przy użyciu jawnych zasad dostępu, indeksowanych zapytań i pierwotnych rewizji.

SDK: developWymagana sesja gracza
Godot
Ilustracja funkcji Obiekty współdzielone
Widoczny rezultat

Przed utworzeniem odczytaj wykorzystanie właściciela. Tworzenie używa rewizji tego wykorzystania; aktualizacja i usuwanie używają pierwotnej rewizji obiektu. Właściciel, grupa i termin wygaśnięcia ustalony przy tworzeniu pozostają niezmienione.

Wideo pojawi się później

Ten krok nie ma jeszcze wideo. Instrukcja i polecenie MCP są już dostępne.

Obiekty współdzielone

Przygotuj ten sam projekt

  1. Wybierz w panelu ten sam projekt co w konfiguracji gry.

    Obiekty współdzielone →
  2. Utwórz lub wykorzystaj te wpisy testowe w formularzu panelu. To wartości przykładowe, nie aktualne dane projektu.

    Klucz
    bases
    Zasady odczytu
    all
    Zasady zapisu
    owner
    Pozycja w siatce
    true
    Maksymalna liczba bajtów na obiekt
    1024
    Maksymalna liczba obiektów na właściciela
    1

    Klucze pozostają zarezerwowane. Po pierwszym użyciu zasady, schemat wyszukiwania, TTL i pozycja są niezmienne. Archiwizacja blokuje nowe zapisy; odczyt i usuwanie pozostają dostępne.

    Ten pierwszy przykład odczytuje dane. Nie tworzy grupy, meczu ani obiektu. Pusta lista jest poprawną pierwszą odpowiedzią.

  3. Zapisz, wczytaj ponownie i sprawdź wpisy przed uruchomieniem przykładu. Zachowaj pozostałe definicje.

Dodaj tę funkcję

Możesz przeglądać poradnik. Uruchomienie wymaga aktywnego klucza projektu. Przygotuj projekt

Zainstalowany SDK, zaimportowana konfiguracja projektu i zalogowany gracz.

Ten przykład SDK korzysta z develop. Sprawdź, czy wymagane API istnieją w zainstalowanym SDK.

Połącz wybranego gracza zgodnie z szybkim startem. Wywołaj read_world_map() jawnym przyciskiem lub akcją sceny. Samo otwarcie pliku nie wysyła żądania.

GDScript
res://scripts/shared_objects.gd
Wywołanie 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.
Otwórz pełny przykład SDK ↗

Mapa świata

Przechowuj bazy właścicieli jako nieinterpretowane bajty. Jawnie odpytuj skonfigurowany prostokąt siatki o współrzędnych całkowitych; aktualizuj z pierwotną rewizją obiektu. Pozycja jest indeksem zapytań i nie waliduje zasad gry.

Asynchroniczne PvP

Wybierz przeciwnika przez ograniczone zapytanie liczb całkowitych o rozkładzie niejednostajnym. Wczytaj jego bajty obrony i zweryfikuj rozgrywkę przy użyciu przebiegu Validated Actions kontrolowanego przez serwer. Tylko zaufany backend rozstrzyga wynik i wysyła niezmienne powiadomienie Inbox.

Używaj odpowiednich sesji graczy, trwale zachowanego pierwotnego zamiaru zapisu oraz jawnych, ograniczonych odczytów. Zaufana walidacja wyników i dostarczanie przez Inbox należą do backendu gry; Account Keys nigdy nie mogą trafiać do buildów gry.

Przetestuj nową funkcję.

Przed utworzeniem odczytaj wykorzystanie właściciela. Tworzenie używa rewizji tego wykorzystania; aktualizacja i usuwanie używają pierwotnej rewizji obiektu. Właściciel, grupa i termin wygaśnięcia ustalony przy tworzeniu pozostają niezmienione.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • 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}
Wszystkie punkty końcowe w dokumentacji API
Ilustracja funkcji Rankingi
Nasza propozycja następnego kroku

Daj każdej rundzie najlepszy wynik.

Zapisz wynik po rundzie i pokaż, kto prowadzi. Nadal korzystaj z połączenia i sesji gracza.