XblEventsWriteInGameEvent
Grava um evento no jogo que inclui os campos de dados “dimensions” e “measurement”.Sintaxe
Parâmetros
xboxLiveContext _In_Tipo: XblContextHandle Identificador de contexto do XBOX Live. eventName _In_z_
Tipo: char* Nome do evento. Deve conter apenas caracteres alfanuméricos. dimensionsJson _In_opt_z_
Tipo: char* Campos de dados de dimensões. measurementsJson _In_opt_z_
Tipo: char* Campos de dados de medidas.
Valor retornado
Tipo: HRESULT Código de retorno HRESULT para esta operação de API.Comentários
As dimensões incluem campos de evento com um número finito de valores numéricos ou de cadeia de caracteres definidos. Exemplos de dimensões: ID do mapa, nível de dificuldade, classe de personagem ou arma, modo de jogo, configurações booleanas etc. As medidas incluem campos de evento que representam métricas numéricas escalares. Exemplos de medidas: pontuação, tempo, contadores, posição etc. Exemplo: para um evento no jogo que rastreia a maior pontuação de partida em um determinado nível de dificuldade, o nível de dificuldade deve ser incluído nas dimensões e a pontuação deve ser incluída nas medidas. O nome do evento e os nomes dos campos do evento (tanto dimensões quanto medidas) devem corresponder aos nomes declarados na configuração de serviço do título. Os nomes não diferenciam maiúsculas de minúsculas. Se a API gravar um evento com um nome que não corresponda a um nome na configuração de serviço, o serviço descartará o evento sem notificação. Ao usar a versão do GDK para PC, um runtime GRTS com o recurso XGameEvent deve estar instalado; caso contrário, esta chamada retornará E_NOTIMPL.As medidas só podem ter valores numéricos, enquanto as dimensões podem ter uma variedade maior de tipos. Se preferir, o campo dimensionsJson pode ser usado exclusivamente para gravar eventos.