Spelideeën en functies

Je volgende functie

Vrienden

Vrienden, verzoeken en blokkades in het gekozen project.

SDK: developSpelerssessie vereist
Godot
Illustratie van Vrienden
Je zichtbare resultaat

Ververs na een time-out of conflict en beoordeel de bedoeling. Herhaal nooit automatisch met een nieuwe revisie.

Video volgt

Voor deze stap is nog geen video. De handleiding en MCP-opdracht zijn al bruikbaar.

Vrienden

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Vrienden →
  2. Voor het eerste verzoek is geen extra definitie nodig. Een leeg resultaat is geldig zolang bijpassende spelgegevens ontbreken.

    Gebruik twee afzonderlijke spelersessies in hetzelfde project. Kopieer de exacte UUID van de andere speler uit gebruikersbeheer.

    Gebruik een exacte UUID of canonieke H-code. Namen en e-mails zijn niet toegestaan.

    Alleen bekijken; uitsluitend de eigen spelerssessie wijzigt relaties.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

Dit SDK-voorbeeld gebruikt develop. Controleer of de benodigde API's in je geïnstalleerde SDK bestaan.

Voltooi de Quickstart-verbinding met de bedoelde speler. Roep run_reviewed_action() expliciet aan via een knop of scèneactie. Alleen het bestand openen verstuurt geen verzoek.

GDScript
res://scripts/friends.gd
horizOn-aanroep
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.
Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Ververs na een time-out of conflict en beoordeel de bedoeling. Herhaal nooit automatisch met een nieuwe revisie.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • 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
Alle eindpunten in de API-referentie
Illustratie van Leaderboards
Onze suggestie voor je volgende stap

Geef elke ronde een topscore.

Sla de score na een ronde op en laat zien wie vooropstaat. Blijf je verbinding en de sessie van de speler gebruiken.