Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Statistiques joueur

Suivez manches, éliminations et records par lot de session, avec somme, maximum, minimum ou dernière valeur.

SDK : developSession de joueur requise
Godot
Illustration de Statistiques joueur
Votre résultat visible

Votre jeu envoie une session complète en un lot et affiche les compteurs et périodes actuels.

Vidéo à venir

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

Statistiques joueur

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.

    Statistiques joueur →
  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.

    Définitions statistiques
    kills: mode=sum, reset=none; best_score: mode=max, reset=none

    Somme additionne chaque rapport. Maximum et minimum conservent la valeur extrême ; dernière la remplace. Maximum, minimum et dernière sont initialisés au premier rapport. Les valeurs sont des entiers signés dans la plage sûre.

  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 run_reviewed_action() via un bouton ou une action de scène explicite. Ouvrir le fichier seul n’envoie aucune requête.

GDScript
res://scripts/statistics.gd
Appel horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action reports the shown persisted batch.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var snapshot: Dictionary = await Horizon.statistics.getStatistics()
10 if snapshot.is_empty():
11 push_error(Horizon.statistics.getLastErrorCode())
12 return
13 var pending_path: String = "user://statistics_" + snapshot.userId + ".dat"
14 var pending: Dictionary
15 if FileAccess.file_exists(pending_path):
16 var file := FileAccess.open(pending_path, FileAccess.READ)
17 if file == null:
18 return
19 var saved: Variant = file.get_var()
20 file.close()
21 if not saved is Dictionary:
22 return
23 pending = saved
24 else:
25 pending = {"operationId": Horizon.statistics.createOperationId(),
26 "updates": [{"key": "kills", "value": 3}, {"key": "best_score", "value": 250}]}
27 var file := FileAccess.open(pending_path, FileAccess.WRITE)
28 if file == null:
29 return
30 file.store_var(pending, false) # Variant storage preserves int64 values.
31 file.flush()
32 var saved_ok: bool = file.get_error() == OK
33 file.close()
34 if not saved_ok:
35 return
36 var original_bytes: PackedByteArray = FileAccess.get_file_as_bytes(pending_path)
37 if original_bytes.is_empty():
38 return
39 var result: Dictionary = await Horizon.statistics.updateStatistics(pending.updates, pending.operationId)
40 if result.is_empty():
41 # Keep the file and original ID, including after timeout or OPERATION_EXPIRED.
42 push_error(Horizon.statistics.getLastErrorCode())
43 return
44 # A delayed O1 success cannot remove another action's O2 original.
45 if FileAccess.get_file_as_bytes(pending_path) == original_bytes:
46 DirAccess.remove_absolute(ProjectSettings.globalize_path(pending_path))
47 print(result.values)
Ouvrir l’exemple SDK complet ↗

Testez votre nouvelle fonctionnalité.

Votre jeu envoie une session complète en un lot et affiche les compteurs et périodes actuels.

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

Points de terminaison
  • GET/statistics
  • GET/statistics/definitions
  • POST/statistics
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.