一、简介
开发者通过SDK接入“成就系统”后，可以快速配置游戏内的成就体系。玩家在达到开发者设定的条件后，可开启相应的成就，并且玩家取得的成就可以在小米游戏中心集中展示。
通过接入成就系统，开发者可以丰富游戏玩法，提升与玩家的互动，提升玩家的游戏体验。游戏玩家可以通过展示成就，在社区/个人主页进行分享，获得社交满足感。
二、名词解释
1、成就基础属性
| 名词 | 释义 | 规则 |
| 成就 ID | 向SDK上报成就的唯一标识，可以按照游戏自己的要求来定义成就 ID。 | 英文/数字，不超过20个字符 |
| 名称 | 成就的简称，例如“曲库达人”。 在成就详情页及触发成就后所的弹出提示中展示。 | 不超过32个字符 |
| 简介 | 成就的简要说明，用于告知用户如何获得成就等信息。在成就详情页中展示。 | 不超过100个字符 |
| 图标 | 与成就内容相关的方形图标。在成就详情页及触发成就后所弹出提示中展示。 | 支持PNG/JPG格式，尺寸512×512，图片大小在2M内 |
2、成就类型
| 类型 | 定义 | 举例 |
| 非分步成就 | 用户的单次行为即可触发成就获得 | 获得过1次MVP |
| 分步成就 | 用户通过多次重复事件的累积来逐步解锁成就，其进程开始后则不能重置或减少进度。分步成就步数由开发者在配置时设置，介于 2 到 1,000,000 之间。 | 获得5次MVP。值得注意的是，“连续获得5次MVP”这类成就，则不符合“分步成就”不能重置或减少进度的要求，因用户输掉游戏后，其连续状态则不再成立；可将该类成就设置为“非分步成就”，在游戏内累计达成后，进行成就达成上报。 |
3、成就解锁状态
当玩家在游戏内触达到开发者设定的目标时，成就状态会发生改变。
| 状态 | 说明 | |
| 未解锁 | 提交成就发布后的初始化状态，即玩家未达成成就 | |
| 解锁中 | 当玩家触发“分步成就”的一定步数且小于总步数时，当前成就处于“解锁中”状态 | |
| 已解锁 | 非分步成就 | 当玩家触达成就后，“未解锁”状态直接变为“已解锁”状态 |
| 分步成就 | 当玩家完成步数达到开发者所设置的步数时，状态变为“已解锁“状态 | |
三、功能配置说明
1、初期测试入口
开发者可以在“小米开放平台”-“游戏详情页”-“游戏服务下”，找到“运营物料申请”，步骤如下图：
2、创建成就
点击“添加成就系统”，即可进入添加页面；
填写成就的相关信息，点击保存草稿，这个成就进入到待发布状态。
3、编辑成就
成就发布前，要编辑已经创建的成就，请在成就体系里点击编辑。
提交审核并发布成功后，平台会有专人进行审核，审核期间不支持开发者进行操作。若有问题可联系平台人员，若审核不通过，开发者可进行修改并重新提交。
4、发布成就
完成编辑后，成就将处于待发布状态，对用户不可见。开发者对其进行测试，可通过填写fuid下发到测试手机中，验收正常后，点击发布，所有成就将发布到正式环境。
5、游戏内成就通知
当玩家在游戏中触发成就行为，在游戏顶部推送弹窗。界面的成就队列只有 1 条，如同时触发多条成就，则会排队显示。
6、其他常见问题
问：如果是已经上架的游戏接成就系统，那老用户已经完成过的成就，还能再触发吗？
答：若游戏本身记录了成就达成的数据，则可以在游戏内把以前记录的数据转化为「成就 ID」通过SDK上报达成（注：若短时间上报多条历史达成数据，可设置对用户临时关闭冒泡通知，避免顶部会有多个提醒通知）。
问：游戏有多个区服或可以创建多个角色，如果重复获得成就，SDK的逻辑是怎样的？
答：成就记录跟着账号（fuid），每个成就只记录第一次获得的行为，之后重复获得将不重复计入与展示。
四、接入说明
1、接入准备
a、按照联运流程，入驻成为小米游戏联运开发者；
b、在小米开放平台创建联运游戏；
c、成就系统需通过指定的小米联运游戏SDK（最低支持版本 v3.2.9）集成到游戏包内。