XblEventsWriteInGameEvent
Escribe un evento dentro del juego que incluye campos de datos de “dimensions” y “measurement”.Sintaxis
Parámetros
xboxLiveContext _In_Tipo: XblContextHandle Identificador de contexto de XBOX Live. eventName _In_z_
Tipo: char* Nombre del evento. Debe contener solo caracteres alfanuméricos. dimensionsJson _In_opt_z_
Tipo: char* Campos de datos de dimensiones. measurementsJson _In_opt_z_
Tipo: char* Campos de datos de mediciones.
Valor devuelto
Tipo: HRESULT Código de retorno HRESULT para esta operación de API.Comentarios
Las dimensiones incluyen campos de evento con un número finito de valores numéricos o de cadena definidos. Ejemplos de dimensiones: id. de mapa, nivel de dificultad, clase de personaje o de arma, modo de juego, configuraciones booleanas, etc. Las mediciones incluyen campos de evento que representan métricas numéricas escalares. Ejemplos de mediciones: puntuación, tiempo, contadores, posición, etc. Ejemplo: para un evento dentro del juego que realiza un seguimiento de la puntuación más alta de una partida para un nivel de dificultad determinado: el nivel de dificultad debe incluirse en las dimensiones y la puntuación debe incluirse en las mediciones. El nombre del evento y los nombres de los campos del evento (tanto dimensiones como mediciones) deben coincidir con los nombres declarados en la configuración de servicio del título. Los nombres no distinguen mayúsculas de minúsculas. Si la API escribe un evento con un nombre que no coincide con un nombre de la configuración de servicio, el servicio descarta el evento sin ninguna notificación. Cuando se usa la versión para PC del GDK, debe estar instalado un runtime de GRTS con la característica XGameEvent o esto devolverá E_NOTIMPL.Las mediciones solo pueden tener valores numéricos, mientras que las dimensiones pueden tener una variedad más amplia de tipos. Si lo prefiere, el campo dimensionsJson puede usarse exclusivamente para escribir eventos.