在合作伙伴中心中配置 XBOX 事件

本主题描述使用数据平台 2013 在合作伙伴中心服务配置中为产品添加和更改 XBOX 事件的过程。如果产品使用数据平台 2013，则事件是产品发送到 XBOX 服务以更新统计信息和排行榜以及解锁成就的关键数据。 有关 XBOX 服务配置的介绍，请参见服务配置。有关 Data Platform 2013 的介绍，请参见 XDK 主题XBOX Live 数据平台 2013 的工作原理。

​

什么是事件？

事件是游戏过程中发生并可_捕获_的任何事情。玩家获得武器是事件，使用该武器击败敌人也是事件。 事件由事件名称、事件描述和多个包含事件相关数据的字段组成。当产品写入事件时，该事件将存储在本地设备上，直到可以将其发送到 XBOX 服务。XBOX 服务接收该事件，并使用它根据你在服务配置中定义的规则构建和更新统计信息、排行榜、成就以及数据平台 2013 的其他功能。有关详细信息，请参见 XDK 主题游戏事件。

​

配置事件

​

创建事件

1. 在 事件和统计规则 页面上，选择 新建事件。
2. 在对话框中，指定以下字段的值。
   • 基础事件
     在下拉列表中，选择要在其基础上构建新事件的基础事件。所选的基础事件将控制新事件将预填充的默认字段。你可以添加任何其他字段，但不能删除默认字段。
   • 事件名称
     • 提供一个描述事件的名称，且你能轻松记住和识别。
     • 事件名称不必与为新事件选择的基础事件的名称匹配。
     • 事件名称不会显示给玩家，且是代码和游戏工作室内部的。
     • 事件名称在提供者命名空间内必须唯一：单个提供者不能有两个冲突的事件名称。
   • 描述
     提供事件的简短描述。此文本是可选的，且对玩家隐藏。
   • 事件字段
     • 此列表中的字段表示将与新事件一起捕获的数据。
     • 要添加事件字段，请选择 添加事件字段，然后指定 字段 名称和 数据类型。
     • 不同类型字段的字符数限制。
       • 成就名称：44
       • 锁定描述：100
       • 解锁描述：100
       • 成就规则名称：44
       • 应用内奖励名称：57
       • 应用内奖励描述：90
       • 美术奖励名称：57
       • 美术奖励描述：90
       • 丰富的在线状态：44
       • Hero 统计信息名称：44
3. 选择 保存 创建事件并关闭对话框。

你的新事件现在列在 事件和统计规则 页面上。

​

更改事件

1. 在 事件和统计规则 页面上的 事件 下，选择要更改的事件的名称。
2. 在 更新事件 对话框中进行更改。
3. 选择 保存。

​

复制事件

你可以通过复制现有事件并修改其信息来创建新事件。

1. 在 事件和统计规则 页面上的 事件 下，选择要复制的事件的 复制。
2. 为新事件提供 事件名称。
3. 更新描述，然后根据需要添加或删除事件字段。
4. 选择 保存 创建事件并关闭对话框。

​

删除事件

1. 在 事件和统计规则 页面上的 事件 下，选择要删除的事件的 删除。
2. 在 确认 对话框中，选择 删除 或 取消。

​

下载事件清单文件

在完成定义和更改产品的事件后，必须将它们发布到 XBOX Live 并下载事件清单文件，你需要该文件才能开发你的产品。 有关下载事件清单文件的信息，请参见下载事件清单文件。