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

另请参阅

events_c