事件的门户配置

注意

仅在使用基于事件的用户统计信息,而不是游戏管理的用户统计信息时,本主题才适用。

注意

本主题介绍的功能仅当具有适当权限时才能使用。 有关详细信息,请联系 Microsoft 的客户经理或其他联系人。

本主题介绍为作品在合作伙伴中心服务配置中添加和更改事件的过程。 如果游戏在使用基于事件的统计信息,则事件是由游戏发送到 Xbox 服务的关键数据,用于更新统计信息和排行榜并解锁成就。

有关 Xbox 服务配置的简介,请参阅 Xbox 服务概述

本主题涵盖以下内容:

什么是事件?

事件是游戏期间发生的任何事件,可以捕获。 获取武器的玩家是事件,使用武器击败敌人也是事件。

事件由事件名称、事件说明以及一些包含事件相关数据的字段组成。 当游戏写入事件时,在可将其发送到 Xbox 服务之前,它将存储在本地设备上。 它接收事件,并使用它根据在服务配置中定义的规则生成和更新基于事件的统计信息的统计信息、排行榜、成就和其他功能。

有关事件的更多详细信息,请参事件概述

返回到本主题顶部。

配置事件

  1. 登录合作伙伴中心上的帐户。

  2. 选择游戏,然后在左侧导航窗格中选择“Xbox 服务”>“游戏玩法设置”。

  3. 选择链接“玩家统计信息”>“统计信息规则”。

  4. "事件和统计信息规则 "页上,如下所示,根据事件配置事件和统计信息规则。

    合作伙伴中心中“事件和统计信息规则”页的屏幕截图。

返回到本主题顶部。

创建事件

  1. 转到事件和统计信息规则页面,如上面部分所述。

  2. 选择新事件。 将显示添加新事件对话框,如下所示。

    合作伙伴中心中

  3. 指定以下字段的值。

    • Base 事件:从下拉列表中,如下所示,选择要生成新事件的基础事件。 所选基事件控制新事件预填充的默认字段。 可以添加任何其他字段,但不能删除默认字段。

    合作伙伴中心中

    • 事件名称:输入一个用于描述事件的名称,并且可以轻松记住和识别该名称。 事件名称不必与为新事件选择的基本事件的名称匹配。 事件名称不会显示给玩家,并且在代码和游戏工作室内部。 事件名称在提供程序命名空间中必须是唯一的:游戏工作室不能有重复的事件名称。

    • 说明:输入事件的简短说明。 此文本是可选的,对玩家隐藏。 以下屏幕截图显示了添加新事件对话框,其中的信息已添加到其字段中。

    • 事件字段
      • 此列表中的字段如下所示,表示将在与新事件关联时捕获的数据。

      • 若要添加事件字段,请选择 "添加事件 "字段,然后指定字 名称和 DataType

      • 字段类型具有字符限制。 它们是:

        • 成就名称:44
        • 成就规则名称:44
        • 锁定的介绍:100
        • 解除锁定的介绍:100
        • 应用内奖励名称:57
        • 应用内奖励的介绍:57
        • 艺术奖励名称:57
        • 艺术奖励的介绍:90
        • 丰富状态:44
        • Hero stat name:44

    在 合作伙伴中心 中添加事件字段的屏幕截图

  4. 选择保存创建事件并关闭对话框,如下所示。

    合作伙伴中心中包含新基本事件的

新事件现在列在 "事件和统计信息规则 "页上,如下所示。

定义事件后,可以选择Events行的右侧来定义使用该事件的统计信息规则。 有关详细信息,请参阅事件的门户配置

返回到本主题顶部。

更改事件

重要

  • 游戏通过最终认证后,除了添加新事件字段之外,无法更改该游戏中的现有事件。

  • 可以删除自定义事件字段,但 不能 删除创建事件时自动提供的默认事件字段。

  1. "事件和统计信息规则 "页上的" 事件"下,选择要更改的事件的名称。

  2. "更新事件 "对话框中进行更改。

  3. 选择“保存”。

返回到本主题顶部。

复制事件

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

  1. "事件和统计信息规则 "页上的 "事件"下,为要复制的事件选择" 复制 "。

  2. 为新事件提供事件名称

  3. 更新说明,然后根据需要添加或删除事件字段。

  4. 单击保存以创建事件并关闭对话框。

返回到本主题顶部。

删除事件

重要

  • 游戏通过最终认证后,无法删除该游戏中的现有事件。

  • 删除事件会删除它可能具有的任何链接依赖项。 在删除事件之前,请确保还希望删除其所有依赖项。

  • 可以在游戏处于开发阶段时删除事件,但不能在它退出最终认证后(即在发布游戏后)删除。

  1. 事件和统计信息规则页面上的事件下,对要删除的事件单击删除

  2. "确认 "对话框中,选择 "删除 "或 "取消"。

下图显示了删除事件如何删除链接的依赖项。

显示删除事件如何删除链接的依赖项的关系图的图像。

返回到本主题顶部。