> ## 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 Live 成就服务如何使用数据平台遥测和用户统计信息来解锁成就，而无需直接调用 API。

本主题介绍基于事件的成就服务如何使用数据平台遥测来跟踪玩家成就。

<Note>如果您的作品使用基于事件的成就（以前称为“成就 2013”），并且您希望继续支持多个平台，则必须继续使用基于事件的成就。这是必需的，以便用户可以在所有平台上保留其成就。</Note>

为了帮助开发人员和发行商将其作品作为服务进行管理，成就服务构建于 XBOX 服务的基于事件的数据平台之上。

基于事件的数据平台由单一的事件驱动数据模型和管道组成，作品开发人员可以使用它来收集使用遥测数据，并基于这些数据构建用户体验。数据平台的关键创新之一是一个通用的用户统计信息分类法，该分类法支持共享语义，发行商可以使用它来深入了解玩家的行为。

所有成就都源自用户统计信息，而不需要从作品直接调用 API。这样做有两个原因。

1. 开发人员可以在作品发布后添加成就，而无需额外的代码更改或作品更新。如果作品在发布时已良好地进行了检测，则开发人员可以通过在云中更新作品的服务配置来添加新的成就。

2. 对于相同的作品内用户行为，作品可以进行更少的服务调用。例如，作品可能会记录单个事件，其用户统计信息适用于多个方面。该事件最终可能会为成就、排行榜以及业务智能 (BI) 报告作出贡献。

### 数据管道

以下步骤提供了使用成就服务的关键阶段的高级视图。

1. 配置
   设计并发布作品配置，指定 XBOX 服务应处理或存储的相关数据。

2. 检测
   在作品中实现事件日志记录，以便正确编码和传输数据。

3. 收集
   作品使用客户端日志记录库将事件馈送到数据平台。其服务根据作品配置对事件进行处理，以适当地聚合、关联、路由和存储统计信息。

4. 成就处理
   服务处理传入的统计信息变化，以检测何时满足成就目标。根据作品配置，服务会解锁成就、提醒相应的奖励系统并存储成就记录。

5. 通知
   成就服务将解锁活动传达给用户（通过系统 Toast 通知）、作品、XBOX 客户端和其他 XBOX 服务，以支持其他体验和功能。

6. 分析
   在线报告和 BI 平台，供发行商了解玩家如何使用其作品。

### 成就服务的关键功能

XBOX 服务大大扩展了成就服务，为作品开发人员在如何使用成就来推动用户参与度方面提供了更多的选项和控制。
基于事件的成就服务引入了以下功能：

* 云触发解锁
* 挑战
* 在成就中使用深层链接
* 成就进度

#### 云触发解锁

对于基于事件的成就，作品不会向 XBOX 服务发出针对特定成就的调用来解锁成就。相反，开发人员和发行商现在可以在云中的服务配置中在线配置成就的解锁规则。XBOX 服务在云中实时处理这些规则。这使开发人员和发行商能够在作品发布后添加新的成就和挑战，而无需更新它。

#### 挑战（限时成就）

挑战在更现代化的作品管理成就服务中不再可用，也不再建议使用挑战。有关更多信息，请参阅[基于事件与作品管理的成就](/services/xbox-services/player-data/achievements/live-achievements-eb-vs-tm)。

挑战是有时间限制的成就，用户只能在指定的时间窗口内解锁。它们的配置方式与成就相同，具有图标、解锁规则和可以隐藏的选项，只是它们还需要定义一个有效时间窗口。

当用户完成挑战时，它会作为已解锁的成就存储在用户的成就历史记录中。如果用户参与了挑战，但挑战未在有效时间窗口内解锁，则该记录不会保存在用户的成就历史记录中。

#### 在成就中使用深层链接

作品可以使用成就架构指定在成就详细信息中显示的深层链接。深层链接链接到游戏中可以获得成就的地方。该链接的格式为字符串，在协议激活期间传递给游戏。作品必须解析该字符串以确定在游戏中要转到的位置。例如，与完成游戏中的某个级别相关的成就可以在成就详细信息中包含一个深层链接，该链接向游戏传递一个字符串。这告诉游戏转到该级别。

#### 成就进度

XBOX 成就服务测量成就进度，并提供作品可用于向玩家显示该进度的数据。

成就服务按成就规则提供进度详细信息。如果一个成就有多个必须满足才能解锁的要求，则服务响应包括每个要求的进度详细信息。如果一个成就有一个基于多个统计信息的要求，则服务返回一个组合了基础统计信息的单一进度值。

### 进度对象

查询用户成就列表会返回一个进度对象。它包含有关成就规则（要求）以及用户实现该要求的当前进度状态的详细数据。有关更多信息，请参阅 [XblAchievementProgression](/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression) 参考。


## Related topics

- [基于事件的成就](/zh-CN/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-nav.md)
- [基于事件](/zh-CN/services/xbox-services/player-data/achievements/event-based/index.md)
- [基于事件的成就概念](/zh-CN/services/xbox-services/player-data/achievements/event-based/concepts/live-achievements-eb-concepts-nav.md)
- [基于事件的成就的门户配置](/zh-CN/services/xbox-services/player-data/achievements/event-based/config/live-achievements-eb-portal.md)
- [获取基于事件的成就](/zh-CN/services/xbox-services/player-data/achievements/event-based/how-to/live-getting-event-based-achievements.md)