- 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.
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.
- 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
truee “0” parafalse. - 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.SUMMAXMINREPLACE
Parâmetro
O parâmetro pode ser um valor constante ou um nome de campo do evento produtor, conforme mostrado na tabela a seguir.
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. |