Skip to main content
本主题包括以下内容:

解锁成就

在通过合作伙伴中心配置成就并发布到您的开发沙盒后,您的作品可以通过调用 XblAchievementsUpdateAchievementAsync API 来解锁它们。 有关更多信息,请参阅下一节中的示例代码。 要解锁成就,请将 percentComplete 设置为 100。 如果用户处于联机状态,则请求会立即发送到 XBOX 服务成就服务,并触发以下用户体验。
  • 用户收到成就已解锁通知。
  • 指定的成就在用户的作品成就列表中显示为已解锁。
  • 已解锁的成就将添加到用户的活动源中。
无论使用基于事件的成就还是作品管理的成就,成就的用户体验在视觉上是相同的。
如果用户处于脱机状态,则解锁请求会在用户设备上本地排队。 当它重新建立网络连接时,请求会自动发送到成就服务(游戏无需采取任何操作来触发此操作),并且发生前面所述的用户体验。

更新成就的完成进度

要更新用户在解锁成就方面的进度,请调用 XblAchievementsUpdateAchievementAsync。将 percentComplete 参数设置为 1-100 之间的整数。 有关更多信息,请参阅以下示例代码。 成就的进度只能增加。 如果 percentComplete 设置为小于成就的上次 percentComplete 值的数字,则更新将被忽略。 例如,如果成就的 percentComplete 之前已设置为 75,则发送值为 25 的更新将被忽略。成就仍然显示为完成 75%。 如果 percentComplete 设置为 100,则成就将被解锁。 如果 percentComplete 设置为大于 100 的数字,则 API 的行为就像您将数字精确设置为 100 一样。

更新当前作品的成就

您可以通过按如下所示调用 XblAchievementsUpdateAchievementAsync 来更新当前作品的成就。 Flat C API
有关更多信息,请参阅以下内容:

更新其他作品的成就

您可以使用 XblAchievementsUpdateAchievementForTitleIdAsync 更新其他 titleId 的成就,如下所示。 Flat C API
有关更多信息,请参阅以下内容: 返回到本主题顶部。
最后修改于 2026年8月25日