> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 使用数据平台 2013 在合作伙伴中心中添加和更改 XBOX 事件，以发送游戏玩法数据来更新统计信息、排行榜和成就。

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

有关 XBOX 服务配置的介绍，请参见[服务配置](/services/xbox-services/fundamentals/portal-config/live-service-config-ids-mp)。有关 Data Platform 2013 的介绍，请参见 XDK 主题**XBOX Live 数据平台 2013 的工作原理**。

<a id="ID4EKB" />

## 什么是事件？

事件是游戏过程中发生并可\_捕获\_的任何事情。玩家获得武器是事件，使用该武器击败敌人也是事件。

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

<a id="ID4EYM" />

## 配置事件

<Steps>
  <Step title="使用你的帐户登录 [合作伙伴中心](https://developer.microsoft.com...">
    使用你的帐户登录[合作伙伴中心](https://developer.microsoft.com/dashboard/windows/overview)。
  </Step>

  <Step title="选择你的产品，然后转到 **服务** > **XBOX Live**。">
    选择你的产品，然后转到 **服务** > **XBOX Live**。
  </Step>

  <Step title="选择指向 **统计规则** 的链接。">
    选择指向 **统计规则** 的链接。
  </Step>

  <Step title="在 **事件和统计规则** 页面上，配置事件以及根据事件的统计规则...">
    在 **事件和统计规则** 页面上，根据事件配置事件和统计规则。
  </Step>
</Steps>

<a id="ID4EUB" />

## 创建事件

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

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

<a id="ID4EYE" />

## 更改事件

<Warning>
  * 在产品通过最终认证后，除了添加新事件字段外，无法再更改该产品中的现有事件。
  * 可以删除自定义事件字段，但不能删除创建事件时自动提供的默认事件字段。
</Warning>

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

<a id="ID4EBG" />

## 复制事件

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

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

<a id="ID4EBL" />

## 删除事件

<Warning>
  * 在产品通过最终认证后，无法再删除该产品中的现有事件。
  * 删除事件会删除它可能具有的任何链式依赖项。删除事件之前，请确保你还想删除其所有依赖项。
  * 你可以在游戏开发期间删除事件，但在退出最终认证后（即在你启动产品后）无法删除。
</Warning>

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

<img src="https://mintcdn.com/microsoft-4404708b/66WJ_HwgXG1cFJFn/publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png?fit=max&auto=format&n=66WJ_HwgXG1cFJFn&q=85&s=18f149e565417485187df9a2a9ae1fab" alt="删除依赖事件" width="624" height="297" data-path="publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png" />

<a id="ID4ERH" />

## 下载事件清单文件

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

有关下载事件清单文件的信息，请参见[下载事件清单文件](/publishing/game-publishing/how-to/data-platform-2013/how-to-download-events-manifest)。


## Related topics

- [在合作伙伴中心中配置 XBOX 数据平台 2013](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-data-platform-2013.md)
- [在合作伙伴中心中配置 XBOX 统计信息和统计规则](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-stats.md)
- [在合作伙伴中心中配置成就](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-achievements-2013.md)
- [在合作伙伴中心中配置挑战](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-challenges.md)
- [在合作伙伴中心中配置排行榜](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-leaderboards-2013.md)