Pomysły i funkcje gry

Twoja następna funkcja

Mecze

Gry turowe z jawnymi rewizjami, nieprzetwarzanym stanem i osobnymi raportami wyników.

SDK: developWymagana sesja gracza
Godot
Ilustracja funkcji Mecze
Widoczny rezultat

Koordynuj lobby, naprzemienne tury i niezależne raporty końcowe z dwiema sesjami graczy.

Wideo pojawi się później

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

Mecze turowe

Przygotuj ten sam projekt

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

    Mecze →
  2. Pierwsze żądanie nie wymaga dodatkowej definicji. Pusty wynik jest poprawny, dopóki nie powstaną odpowiednie dane gry.

    Użyj dwóch oddzielnych sesji: utwórz lobby, dołącz, rozpocznij w jawnej kolejności, wysyłaj naprzemiennie stany bajtowe i niezależnie zgłoś ten sam wynik końcowy.

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

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_my_matches() jawnym przyciskiem lub akcją sceny. Samo otwarcie pliku nie wysyła żądania.

GDScript
res://scripts/matches.gd
Wywołanie horizOn
1extends Node
2​
3# Explicit action after restoring the SAME existing player identity.
4func read_my_matches() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.matches.getMatches(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 print("Ledger revision: ", result.data.revision)
13 for row in result.data.recent:
14 print(row.id, " ", row.status) # May still be active after this player's forfeit.
15 # Respect result.data.pollAfterSeconds. No background poll.
16# Full two-player, durable-original example in the verified SDK:
17# addons/horizon_sdk/examples/features/matches_example.gd
18# read_matches()/create_reviewed(options), read_match(id), perform_reviewed(kind, body).
19# Each is an explicit player action. Original project+player intent survives host changes.
20# SDK methods: joinMatch(userId,id,originalRevision), startMatch(userId,id,originalRevision,order),
21# submitTurn(userId,id,originalRevision,PackedByteArray,finish),
22# reportResult(userId,id,originalFinalRevision,PackedByteArray,sortedWinnerIds).
23# Unknown create: recovery reads and explicit reconciliation, never a replacement create.
24# Report agreement is ordinary consensus, not validated combat or an automatic reward.
Otwórz pełny przykład SDK ↗

Dwóch graczy, jedna pierwotna tura

Użyj dwóch oddzielnych sesji: utwórz lobby, dołącz, rozpocznij w jawnej kolejności, wysyłaj naprzemiennie stany bajtowe i niezależnie zgłoś ten sam wynik końcowy.

Zapisz dokładne żądanie przed wysłaniem. Po przekroczeniu czasu odczytaj stan i uzgodnij. Nie zastępuj po cichu rewizji ani pierwotnej intencji.

Raporty używają niezmiennej rewizji końcowej. Zgodność nie dowodzi wiarygodnego zwycięstwa; sprzeczne lub brakujące raporty nie wyznaczają zwycięzcy.

Przebiegi rankingowe wymagają potwierdzonego meczu rankingowego i istniejącego procesu Validated Actions. Zwykłe raporty nie przyznają nagród.

PHP obsługuje zwykłe trasy REST meczów. Walidacja rankingowa i czas rzeczywisty są niedostępne i zwracają FEATURE_NOT_SUPPORTED, gdy wymagane.

Przetestuj nową funkcję.

Koordynuj lobby, naprzemienne tury i niezależne raporty końcowe z dwiema sesjami graczy.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • GET/matches
  • GET/matches/limits
  • GET/matches/open
  • GET/matches/{matchId}
  • POST/matches
  • POST/matches/{matchId}/join
  • POST/matches/{matchId}/decline
  • POST/matches/{matchId}/start
  • POST/matches/{matchId}/turn
  • POST/matches/{matchId}/timeout
  • POST/matches/{matchId}/leave
  • POST/matches/{matchId}/cancel
  • POST/matches/{matchId}/result
  • POST/matches/{matchId}/ranked-run
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.