> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral das regras de estatística baseadas em eventos

> Como funcionam as regras de estatística de usuário baseadas em eventos do XBOX Live, incluindo eventos produtores, nomenclatura, operadores, parâmetros e modelos de estatística para estatísticas de jogador.

Este tópico descreve como funcionam as regras de estatística de usuário. Elas são usadas para estatísticas baseadas em eventos, não para estatísticas gerenciadas pelo título.

Cada regra de estatística tem quatro partes.

* O evento produtor
* O nome
* Um operador
* Um parâmetro

## Evento

Cada regra de estatística é disparada por um nome de evento específico registrado pelo título. Observe que várias regras de estatística podem ser disparadas por um único evento.

## Requisitos de nomenclatura

* O nome de uma regra tem um nome "raiz". Ele é opcionalmente seguido por um ou mais "campos".

* A *raiz* é uma string alfanumérica. Ela pode ter até 32 caracteres.

* O comprimento total do nome da instância de estatística não deve exceder 128 caracteres.

* O nome deve começar com uma letra e deve conter somente letras, números e o caractere hífen (-). Não são permitidos espaços, vírgulas, pontos, sublinhados ou qualquer outro caractere especial. Alguns nomes de exemplo são "EnemiesDefeated", "BestScoreUnder2Minutes" e "Total-Collectibles-Jewels".

* Os campos são separados pelo caractere ponto (.).

* Os nomes dos campos devem corresponder exatamente aos nomes dos campos que fazem parte do evento produtor.

<Info>Quando um ou mais campos são incluídos como parte do nome da regra de estatística, essa regra se torna um modelo de estatística. Em tempo de execução, o valor real dos campos do evento produtor é inserido no nome da instância de estatística.</Info>

* Alguns exemplos de nomes de modelo válidos são "EnemiesDefeated.WeaponID", "BestScoreUnder2Minutes.TrackId.DifficultyID" e "Total-Collectibles-Jewels.Found".

* Alguns exemplos de nomes de instância válidos são "EnemiesDefeated.WeaponID.17", "BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane" e "Total-Collectibles-Jewels.Found.1".

## Recomendações de tipos de dados

* Recomendamos que você use o tipo de dados inteiro para campos de evento que fazem parte do nome de um modelo de estatística.

* Se o tipo de dados do campo de evento for Boolean, o valor inserido será "1" para `true` e "0" para `false`.

* Se o tipo de dados do campo de evento for string Unicode, você deve garantir que os valores possíveis desse campo contenham somente caracteres válidos (conforme descrito anteriormente).

## Operador

O valor da instância de estatística é calculado em tempo de execução quando o evento produtor está sendo processado. A regra de estatística executa uma *operação* com o *parâmetro* especificado. As opções de operação com suporte são as seguintes.

* `SUM`
* `MAX`
* `MIN`
* `REPLACE`

## Parâmetro

O parâmetro pode ser um valor constante ou um nome de campo do evento produtor, conforme mostrado na tabela a seguir.

| Operador | Parâmetro |
| - | - |
| `SUM` | Constante ou campo |
| `MIN` | Campo |
| `MAX` | Campo |
| `REPLACE` | Constante ou campo |

O tipo de dados da instância de estatística resultante é determinado pelo tipo de dados do parâmetro.

Os tipos de dados Integer, Float e Boolean têm suporte em todos os operadores.

O tipo de dados string Unicode tem suporte somente no operador `REPLACE`.

Os tipos de dados de estatística e de parâmetro são mostrados na tabela a seguir.

\| Tipo de dados da estatística | Tipo de dados do parâmetro | Observações |
\| --- | --- |
\| Integer | Int32, Int64, UInt32, UInt64, Boolean | O maior valor inteiro com suporte é de 56 bits. Boolean é convertido de `TRUE` para 1 e de `FALSE` para 0. |
\| Float | Float, Double | Float de 64 bits. |
\| String | UnicodeString, GUID | O comprimento máximo da string é de 50 caracteres. |


## Related topics

- [Visão geral das estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [Configuração no portal de estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [Configuração no portal de estatísticas e leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [Visão geral das conquistas baseadas em eventos](/pt-BR/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-overview.md)
- [Visão geral das estatísticas em destaque](/pt-BR/services/xbox-services/player-data/stats-leaderboards/featured-stats/live-featuredstats-overview.md)