XblEventsWriteInGameEvent
编写一个游戏内事件,其中包含“维度”和“度量”数据字段。
语法
HRESULT XblEventsWriteInGameEvent(
XblContextHandle xboxLiveContext,
const char* eventName,
const char* dimensionsJson,
const char* measurementsJson
)
参数
xboxLiveContext _In_
类型:XblContextHandle
Xbox Live 上下文句柄。
eventName _In_z_
类型:char*
事件名称。 必须仅包含字母数字字符。
dimensionsJson _In_opt_z_
类型:char*
维度数据字段。
measurementsJson _In_opt_z_
类型:char*
度量数据字段。
返回值
类型:HRESULT
此 API 操作的 HRESULT 返回代码。
备注
维度包括具有有限数量的已定义数字或字符串值的事件字段。 维度示例:地图 ID、难度级别、角色或武器类别、游戏模式、布尔设置等。度量包括表示标量数字指标的事件字段。 度量示例:得分、时间、计数器、位置等。示例:对于跟踪特定难度级别的最高匹配分数的游戏内事件:难度级别应包含在维度中,而分数应包含在度量中。 事件的名称以及事件字段的名称(维度和度量)必须与游戏的服务配置中声明的名称匹配。 名称不区分大小写。 如果 API 写入的事件的名称与服务配置中的名称不匹配,则服务将删除该事件而不发出通知。 当使用 GSDK 电脑版时,必须安装具有 XGameEvent 功能的 GRTS 运行时,否则这将 E_NOTIMPL。
要求
头文件:events_c.h
图书馆: Microsoft.Xbox.Services.14x.GDK.C.lib