Idee e funzionalità per il gioco

La tua prossima funzionalità

Amici

Amici, richieste e blocchi del progetto selezionato.

SDK: developSessione del giocatore richiesta
Godot
Illustrazione di Amici
Il risultato visibile

Dopo timeout o conflitto, ricarica e verifica l’intento. Mai ritentare automaticamente con una nuova revisione.

Video in arrivo

Questo passaggio non ha ancora un video. La guida e la richiesta MCP sono già utilizzabili.

Amici

Preparare lo stesso progetto

  1. Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

    Amici →
  2. La prima richiesta non richiede altre definizioni. Un risultato vuoto è valido finché mancano i dati del gioco.

    Usate due sessioni distinte nello stesso progetto. Copiate l’UUID esatto dell’altro giocatore dalla gestione utenti.

    Usa un UUID esatto o un codice H canonico. Nomi ed email non sono accettati.

    Sola lettura; solo la sessione del giocatore modifica le relazioni.

Integra questa funzionalità

Puoi consultare la guida. Per eseguirla serve una chiave di progetto attiva. Prepara il progetto

SDK installato, configurazione del progetto importata e giocatore connesso.

Questo esempio del SDK usa develop. Verifica che le API necessarie siano disponibili nel SDK installato.

Completate la connessione rapida con il giocatore scelto. Chiamate run_reviewed_action() tramite un pulsante o un’azione esplicita della scena. Aprire il file non invia richieste.

GDScript
res://scripts/friends.gd
Chiamata horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var loaded: Dictionary = await Horizon.friends.getFriends(user_id)
10 if not loaded.success:
11 push_warning(loaded.errorCode)
12 return
13 print(loaded.data.friendCode) # Public identifier, not a credential.
14 for friend in loaded.data.friends:
15 print(friend.display.name, ": ", friend.lastActiveAt) # null means unknown, not offline.
16​
17 # Examples for explicit player actions, never run these as an automatic sequence:
18 # var found = await Horizon.friends.findPlayer(user_id, exact_uuid_or_h_code)
19 # var r = await Horizon.friends.sendRequest(user_id, target_id, reviewed_revision)
20 # var r = await Horizon.friends.acceptRequest(user_id, target_id, reviewed_revision, original_request_id)
21 # var r = await Horizon.friends.declineRequest(user_id, target_id, reviewed_revision, original_request_id)
22 # var r = await Horizon.friends.cancelRequest(user_id, target_id, reviewed_revision, original_request_id)
23 # var r = await Horizon.friends.removeFriend(user_id, target_id, reviewed_revision)
24 # var r = await Horizon.friends.blockPlayer(user_id, target_id, reviewed_revision)
25 # var r = await Horizon.friends.unblockPlayer(user_id, target_id, reviewed_revision)
26 # Success: replace the entire snapshot with r.data. Do not patch one side locally.
27 # Timeout/REVISION_CONFLICT: refresh and reconcile; never silently substitute a new revision.
28 # Keep original incoming requestId for accept/decline, outgoing requestId for cancel.
29 # Inbox notices are hints; only the current snapshot authorizes a request action.
30 # Refresh explicitly on reconnect/metadata invalidation; no hidden polling timer.
Aprire l’esempio SDK completo ↗

Prova la tua nuova funzionalità.

Dopo timeout o conflitto, ricarica e verifica l’intento. Mai ritentare automaticamente con una nuova revisione.

Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

Endpoint dell'API
  • GET/friends
  • GET/friends/find
  • POST/friends/request
  • POST/friends/accept
  • POST/friends/decline
  • POST/friends/cancel
  • POST/friends/remove
  • POST/friends/block
  • POST/friends/unblock
Tutti gli endpoint nel riferimento API
Illustrazione di Classifiche
Il nostro suggerimento per il prossimo passo

Dai un record a ogni partita.

Salva il punteggio dopo una partita e mostra chi è in testa. Continua a usare la connessione e la sessione del giocatore.