跳转到内容
IGP Developer Docs

成就

成就用于把游戏内的重要目标同步到 IGP 平台。项目可以直接解锁一次性成就，也可以为累计型成就持续上报进度。

支持范围

Section titled “支持范围”
引擎状态所在包详细操作
UnityPreviewUnity 主包Unity Quick Start
GameMakerPreviewGameMaker 主包GameMaker Quick Start
GodotPreviewGodot CoreGodot Quick Start

三种引擎的成就都通过 Desktop Session 上报。调用前只需要 Desktop Session 和成就 capability 可用，不需要进入房间或等待 realtime 连接。

如何接入

Section titled “如何接入”
  1. 先在平台后台创建成就，确定稳定且不会随显示文案变化的成就 key。
  2. 完成 启动与连接，并确认当前会话支持成就能力。
  3. 在明确的游戏业务节点触发解锁或进度上报，例如关卡结算、收集完成或累计次数变化。
  4. 为可重试的同一业务事件保留相同的幂等标识；网络重试时不要生成新的业务事件。
  5. 读取结果中的成功、重复和错误信息。重复解锁通常表示之前已经成功，不应再次发放游戏内奖励。
  6. 清除成就只用于测试或后台明确允许的重置流程，不要放进普通玩家路径。

设计建议

Section titled “设计建议”
  • 成就 key 和后台配置保持一致，显示名称和描述可以独立本地化。
  • 游戏内奖励以自己的存档状态为准，不要依赖一次网络回调决定是否重复发奖。
  • 离线或断线时保留待上报事件，并在连接恢复后按原幂等标识重试。
  • 累计进度的单位和上报方式应在接入前确定，避免把“当前总值”和“本次增量”混用。

最小验收

Section titled “最小验收”
  • 新成就可以成功解锁，并能在平台侧看到结果。
  • 同一解锁重复提交时不会重复产生业务奖励。
  • 累计型成就按后台定义正确增长。
  • Desktop Session 断开时能得到明确失败或排队结果，恢复后可安全重试。
  • 测试账号的清除操作不会被带入正式玩家流程。