XblEventsWriteInGameEvent
写入包含 “dimensions” 和 “measurement” 数据字段的游戏内事件。语法
参数
xboxLiveContext _In_类型：XblContextHandle XBOX Live 上下文句柄。 eventName _In_z_
类型：char* 事件名称。必须仅包含字母数字字符。 dimensionsJson _In_opt_z_
类型：char* Dimensions 数据字段。 measurementsJson _In_opt_z_
类型：char* Measurement 数据字段。
返回值
类型：HRESULT 此 API 操作的 HRESULT 返回代码。备注
Dimensions 包含具有有限数量的已定义数字或字符串值的事件字段。Dimensions 的示例：地图 ID、难度级别、角色或武器类别、游戏模式、布尔设置等。Measurements 包含表示标量数字指标的事件字段。Measurements 的示例：分数、时间、计数器、位置等。示例：对于跟踪特定难度级别下最高比赛分数的游戏内事件：难度级别应包含在 dimensions 中，而分数应包含在 measurements 中。事件的名称以及事件字段(dimensions 和 measurements)的名称必须与在标题的服务配置中声明的名称匹配。名称不区分大小写。如果 API 写入的事件名称与服务配置中的名称不匹配，则服务会静默丢弃该事件。使用 GDK PC 版本时，必须安装带有 XGameEvent 功能的 GRTS 运行时，否则将返回 E_NOTIMPL。Measurements 只能具有数值，而 Dimensions 可以具有更多种类型。如果需要，可以专门使用 dimensionsJson 字段来写入事件。