# 成就系统
推荐您先阅读成就系统功能介绍 (opens new window),了解游戏成就服务的配置说明,再按照下文接入针对小游戏的成就 api
# 一、集成前准备
- 参考 准备工作 (opens new window) 创建应用、开启成就服务。
- 根据 后台功能说明 (opens new window) 依次创建并编辑游戏成就
- 根据 [小游戏成就接入文档](https://developer.taptap.cn/minigameapidoc/开发小游戏/小游戏 API/open-api/achievements/tap.createAchievementManager.html) 在Tap小游戏内接入相应api
# 二、小游戏API说明
# 注册监听回调
小游戏成就 api 中包含多个监听回调,分别会在初始化数据成功、初始化数据失败以及成就进度更新时被调用。
# 解锁某个成就
当玩家达成某一成就时,可以使用以下方式解锁成就,解锁成功后会触发 callback 的 OnAchievementSuccess
回调。 解锁失败会触发 callback 的 OnAchievementFailure
回调。具体错误码请参考 错误码详情 (opens new window)
# 分步成就增长步数
如果成就是增量类型(即,需要几个步骤才能解锁它)请使用以下API。SDK 会自动计算当前全量步数。 解锁成功后会触发 callback 的 OnAchievementSuccess
回调。 解锁失败会触发 callback 的 OnAchievementFailure
回调。具体错误码请参考 错误码详情 (opens new window)
# 设置冒泡开关
默认情况下,成就达成时 TapTap 会自行展示一个冒泡浮窗提示玩家已达成相应成就。需要关闭请调用如下接口或者在初始化的时候设置 TapTapAchievementOptions.enableToast 为 false。 详见 成就初始化配置 (opens new window)
# 打开成就展示页
使用该 api 后,TapTap将会在游戏上层展示当前玩家在您游戏中的成就列表展示页,当其关闭页面时,将会返回游戏。