解锁成就
在通过合作伙伴中心配置成就并发布到您的开发沙盒后,您的作品可以通过调用 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
