通过

基于事件的统计信息规则概述

  • 项目

本主题介绍用户统计信息规则的工作原理。 统计信息规则用于基于事件的统计信息，不适用于游戏管理的统计信息。

每个统计信息规则包含四个部分。

  • 制作者事件
  • 名称
  • 运营商
  • 参数

事件

每个统计信息规则都将由游戏记录的特定事件名称触发。 请注意，单个事件可以触发多个统计信息规则。

命名要求

  • 规则名称具有“根”名称。 可以选择后跟一个或多个“字段”。

  • 根是字母数字字符串。 最多可包含 32 个字符。

  • 统计信息实例名称的总长度不得超过 128 个字符。

  • 名称必须以字母字符开头，并且必须仅包含字母、数字和连字符 (-)。 不允许使用空格、逗号、句点、下划线或任何其他特殊字符。 一些名称示例：“EnemiesDefeated”、“BestScoreUnder2Minutes”和“Total-Collectibles-Jewels”。

  • 字段由点字符 (.) 分隔。

  • 字段名称必须与属于制作者事件一部分的字段名称完全匹配。

重要

当一个或多个字段包含在统计规则名称中时，此规则成为统计信息模板。 在运行时，来自制作者事件的字段的实际值将插入到统计信息实例名称中。

  • 一些有效的模板名称示例：“EnemiesDefeated.WeaponID”、“BestScoreUnder2Minutes.TrackId.DifficultyID”和“Total-Collectibles-Jewels.Found”。

  • 一些有效的实例名称示例：“EnemiesDefeated.WeaponID.17”、“BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane”和“Total-Collectibles-Jewels.Found.1”。

数据类型建议

  • 建议属于统计信息模板名称一部分的事件字段使用整数数据类型。

  • 如果事件字段的数据类型为布尔值，则插入的值为“1”表示 true，为“0”表示 false。

  • 如果事件字段数据类型为 Unicode 字符串，则必须确保该字段的潜在值仅包含有效字符（如前所述）。

运算符

统计信息实例的值是在处理制作者事件时在运行时计算的。 统计信息规则使用指定的参数执行运算。 支持的运算选项如下所示。

  • SUM
  • MAX
  • MIN
  • REPLACE

参数

参数可以是生成事件的常量值或字段名称，如下表所示。

运算符 参数
SUM 常量或字段
MIN 字段
MAX 字段
REPLACE 常量或字段

生成的统计信息实例的数据类型由参数的数据类型确定。

所有运算符都支持整数、浮点数和布尔值数据类型。

Unicode 字符串数据类型仅受 REPLACE 运算符支持。

下表显示了统计信息和参数数据类型。

统计信息数据类型 参数数据类型 说明
整型 Int32、Int64、UInt32、UInt64、布尔值 支持的最大整数值为 56 位。 布尔值从 TRUE 转换为 1，从 FALSE 转换为 0。
浮点 浮点数、双倍 64 位浮点数。
字符串 UnicodeString，GUID 最大字符串长度为 50 个字符。