XblEventsWriteInGameEvent
Écrit un événement en jeu qui inclut les 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 mesures.
Valeur de retour
Type : HRESULT Code de retour HRESULT de cette opération d’API.Remarques
Les dimensions comprennent les champs d’événement ayant 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 comprennent les 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 partie le plus élevé pour un niveau de difficulté donné, le niveau de difficulté doit être inclus dans les dimensions et le score doit être inclus dans les mesures. Le nom de l’événement et les noms des champs d’é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 doté de la fonctionnalité XGameEvent doit être installé, sinon cette fonction renverra E_NOTIMPL.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.