XblEventsWriteInGameEvent
Écrit un événement en jeu qui inclut des champs de données « dimensions » et « measurement ».Syntaxe
Paramètres
xboxLiveContext _In_Type : XblContextHandle Handle de contexte XBOX Live. eventName _In_z_
Type : char* Nom de l’événement. Ne doit contenir que des caractères alphanumériques. dimensionsJson _In_opt_z_
Type : char* Champs de données de dimensions. measurementsJson _In_opt_z_
Type : char* Champs de données de mesure.
Valeur de retour
Type : HRESULT Code de retour HRESULT de cette opération d’API.Remarques
Les dimensions incluent des champs d’événement comportant un nombre fini de valeurs numériques ou de chaînes définies. Exemples de dimensions : ID de carte, niveau de difficulté, classe de personnage ou d’arme, mode de jeu, paramètres booléens, etc. Les mesures incluent des champs d’événement qui représentent des métriques numériques scalaires. Exemples de mesures : score, temps, compteurs, position, etc. Exemple : pour un événement en jeu qui suit le score de match le plus élevé pour un niveau de difficulté particulier, le niveau de difficulté doit être inclus dans les dimensions et le score dans les mesures. Le nom de l’événement et les noms des champs de l’événement (dimensions et mesures) doivent correspondre aux noms déclarés dans la configuration de service du titre. Les noms ne respectent pas la casse. Si l’API écrit un événement dont le nom ne correspond à aucun nom de la configuration de service, le service abandonne l’événement sans notification. Lors de l’utilisation de la version PC du GDK, un runtime GRTS comportant la fonctionnalité XGameEvent doit être installé, faute de quoi E_NOTIMPL est renvoyé.Les mesures ne peuvent avoir que des valeurs numériques, tandis que les dimensions peuvent avoir une plus grande variété de types. Si vous le préférez, le champ dimensionsJson peut être utilisé exclusivement pour écrire des événements.