Spelideeën en functies

Je volgende functie

Gedeelde objecten

Deel niet-geïnterpreteerde spelgegevens via expliciet toegangsbeleid, geïndexeerde query’s en oorspronkelijke revisies.

SDK: developSpelerssessie vereist
Godot
Illustratie van Gedeelde objecten
Je zichtbare resultaat

Vraag vóór het maken het gebruik van de eigenaar op. Maken gebruikt de revisie van dat gebruik; bijwerken en verwijderen gebruiken de oorspronkelijke objectrevisie. Eigenaar, groep en de bij het maken ingestelde vervaltijd blijven ongewijzigd.

Video volgt

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

Gedeelde objecten

Hetzelfde project voorbereiden

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

    Gedeelde objecten →
  2. Maak of hergebruik deze testgegevens in het dashboardformulier. Dit zijn voorbeeldwaarden, geen huidige projectgegevens.

    Sleutel
    bases
    Leesbeleid
    all
    Schrijfbeleid
    owner
    Rasterpositie
    true
    Maximumaantal bytes per object
    1024
    Maximumaantal objecten per eigenaar
    1

    Sleutels blijven gereserveerd. Na het eerste gebruik zijn beleid, zoekschema, TTL en positie onveranderlijk. Archiveren blokkeert nieuwe schrijfbewerkingen; lezen en verwijderen blijven mogelijk.

    Dit eerste voorbeeld leest gegevens. Het maakt geen groep, wedstrijd of object. Een lege lijst is een geldig eerste antwoord.

  3. Sla de gegevens op, laad ze opnieuw en controleer ze vóór het voorbeeld. Behoud andere definities.

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 read_world_map() expliciet aan via een knop of scèneactie. Alleen het bestand openen verstuurt geen verzoek.

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

Wereldkaart

Sla bases van eigenaren op als niet-geïnterpreteerde bytes. Vraag expliciet een geconfigureerde rasterrechthoek met gehele coördinaten op; werk bij met de oorspronkelijke objectrevisie. Positie dient als query-index en valideert geen spelregels.

Asynchrone PvP

Kies een tegenstander via een begrensde, niet-uniforme integerquery. Laad diens verdedigingsbytes en valideer de partij met een door de server beheerde Validated Actions-run. Alleen een vertrouwde backend bepaalt de uitkomst en verstuurt een onveranderlijk Inbox-bericht.

Gebruik bijpassende spelersessies, een duurzaam bewaarde oorspronkelijke schrijfintentie en expliciete, begrensde leesbewerkingen. Betrouwbare resultaatvalidatie en Inbox-bezorging horen op de backend van je spel; Account Keys horen nooit in spelbuilds.

Test je nieuwe functie.

Vraag vóór het maken het gebruik van de eigenaar op. Maken gebruikt de revisie van dat gebruik; bijwerken en verwijderen gebruiken de oorspronkelijke objectrevisie. Eigenaar, groep en de bij het maken ingestelde vervaltijd blijven ongewijzigd.

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

Eindpunten
  • 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}
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.