Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Objets partagés

Partagez des données de jeu opaques avec des politiques d’accès explicites, des requêtes indexées et les révisions initiales.

SDK : developSession de joueur requise
Godot
Illustration de Objets partagés
Votre résultat visible

Consultez l’utilisation du propriétaire avant toute création. La création utilise la révision de cette utilisation ; la mise à jour et la suppression utilisent la révision initiale de l’objet. Le propriétaire, le groupe et l’expiration définie à la création restent inchangés.

Vidéo à venir

Cette étape n’a pas encore de vidéo. Le guide et la demande MCP sont utilisables.

Objets partagés

Préparer le même projet

  1. Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

    Objets partagés →
  2. Créez ou réutilisez ces entrées de test dans le formulaire du tableau de bord. Ce sont des exemples, pas les données actuelles.

    Clé
    bases
    Politique de lecture
    all
    Politique d’écriture
    owner
    Position sur la grille
    true
    Octets maximum par objet
    1024
    Objets maximum par propriétaire
    1

    Les clés restent réservées. Après la première utilisation, les politiques, le schéma de recherche, le TTL et la position sont immuables. L’archivage bloque les nouvelles écritures ; la lecture et la suppression restent possibles.

    Ce premier exemple lit les données. Il ne crée ni groupe, ni partie, ni objet. Une liste vide est une première réponse valide.

  3. Enregistrez, rechargez et vérifiez les entrées avant l’exemple. Conservez les autres définitions.

Intégrer cette fonctionnalité

Vous pouvez consulter le guide. Son exécution nécessite une clé de projet active. Préparer le projet

SDK installé, configuration du projet importée et joueur connecté.

Cet exemple du SDK utilise develop. Vérifiez que les API nécessaires existent dans votre SDK installé.

Terminez la connexion du démarrage rapide avec le joueur choisi. Appelez read_world_map() via un bouton ou une action de scène explicite. Ouvrir le fichier seul n’envoie aucune requête.

GDScript
res://scripts/shared_objects.gd
Appel 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.
Ouvrir l’exemple SDK complet ↗

Carte du monde

Stockez les bases des propriétaires sous forme d’octets opaques. Interrogez explicitement un rectangle configuré de grille à coordonnées entières ; utilisez la révision initiale de l’objet pour la mise à jour. La position sert d’index de requête et ne valide pas les règles du jeu.

PvP asynchrone

Choisissez un adversaire par une requête d’entiers bornée et non uniforme. Chargez ses octets de défense et validez la partie avec une exécution Validated Actions contrôlée par le serveur. Seul un backend de confiance décide du résultat et envoie une notification Inbox immuable.

Utilisez les sessions de joueur correspondantes, une intention initiale d’écriture conservée durablement et des lectures explicites et bornées. La validation fiable du résultat et la livraison Inbox relèvent du backend du jeu ; les Account Keys ne doivent jamais figurer dans les builds du jeu.

Testez votre nouvelle fonctionnalité.

Consultez l’utilisation du propriétaire avant toute création. La création utilise la révision de cette utilisation ; la mise à jour et la suppression utilisent la révision initiale de l’objet. Le propriétaire, le groupe et l’expiration définie à la création restent inchangés.

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

Points de terminaison
  • 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}
Tous les points de terminaison dans la référence API
Illustration de Classements
Notre suggestion pour la suite

Donnez un meilleur score à chaque partie.

Enregistrez le score après une partie et montrez qui est en tête. Continuez avec votre connexion et la session du joueur.