成就系统功能介绍

开发者可以在开发者中心后台配置并发布游戏成就，玩家在游戏内触发并获得成就，从而提升玩家在游戏中的参与度，鼓励玩家以不同的玩法来玩游戏。TapTap 为游戏增加了点亮「白金成就」荣誉标识，对于那些孜孜不倦完成全部成就的玩家给予奖励。

核心优势

对于游戏开发者：

• 降低开发成本：无需投入开发成本，轻松配置，一键发布。
• 提高用户生命周期价值：建立用户成长体系（精神激励），提升玩家在游戏中的参与度。
• 数据验证：以用户分层来完善用户画像，帮助开发者用数据评估游戏内的玩法设计难易度。
• 支持多端：TapSDK 3.18.2 以上版本支持 iOS、Andriod、Unity、UE4 版本，同时包含 PC 端展示

对于游戏玩家：

• 游戏体验：成就内容的趣味性，提升玩家在游戏内的体验。
• 情绪激发：激发玩家的荣誉感、收集欲望，提升用户粘性。

名词解释

基础信息

名词	释义	规则
成就 ID	向 SDK 上报成就的唯一标识，可以按照游戏自己的要求来定义成就 ID	只允许英文+数字，最多可以包含 100 个字符
名称	成就的简称，例如「驾车高手」	最多可以包含 80 个字符
简介	成就的简要说明，通常用来告诉玩家如何获得成就，例如「驾驶汽车连续躲避 10 个障碍物」	最多可以包含 400 个字符
图标	与成就内容相关的方形图标	图标 UI 规则：只需要提供成就解锁时的 512×512 PNG 或 JPG 彩色图片，TDS 会自动生成未解锁状态时的灰度版本
初始状态	成就的初始化状态，分为隐藏成就和显示成就	一旦初始设置，后续不可再修改
隐藏成就	玩家看不到成就细节	选择后，TDS 会在成就处于隐藏状态时为其提供特殊的描述和图标
显示成就	玩家看得到成就细节	默认选择，发布后展示开发者配置的内容描述
成就分组	将普通成就进行分组	一个普通成就只能归属于一个成就分组，成就待发布状态，可修改成就分组；成就已发布状态，不可修改成就分组
本体成就	游戏发行后最初版本的完整成就，成就分组之一	非特殊情况，通常成就数量 ≥10 个，本体成就的数量是固定的
拓展成就	游戏后期推出 DLC 的新成就，成就分组之一	成就数量不限，随游戏内容增加而增加

分步成就

分步成就会让玩家用更长的时间逐步达成成就。随着玩家逐步取得成就，可以向 TDS 报告玩家的进度。TDS 会记录进度信息，并在玩家达到解锁该成就的必要条件时提醒游戏，同时告知玩家成就达成。

数值范围：创建时必须定义解锁成就所需的步骤总数（此数字必须介于 2 到 100,000,000 之间）。步骤总数达到解锁值后，成就即被解锁（即使它已被隐藏）。开发者无需存储用户的累积进度。

不可重置：分步成就在游戏进程中是累积的，并且进度无法从游戏内删除或重置。例如，「赢得 20 场比赛」将被视为分步成就。而「连续赢得 5 局游戏」则不行，因为当玩家输掉游戏时，其进度将被重置。「拥有 2,000 个金币」也不符合条件，因为玩家在玩游戏时可能会获得、也会失去金币。对于后两项成就，你可以把成就名称设定为「连续获胜」或「金币总数」，并在玩家达成目标时解锁的标准成就。

成就稀有度

获得成就人数的百分比，值越低，获得人数越少，越稀有。

计算公式 = 完成此成就的人数/初始化成就人数。

• 普通：50% ≤ Common ≤ 100%
• 稀有：10% ≤ Uncommon < 50%
• 珍贵：1% ≤ Rare < 10%
• 极为珍贵：Ultra Rare < 1%

成就稀有等级：

解锁状态

当玩家在游戏内触达到开发者设定的目标时，成就状态会发生改变。

• 未解锁：提交成就发布后的初始化状态，即玩家未达成成就；
• 已达成：玩家已达成成就，分为：
  • 非分步成就：当玩家触达成就后，「未解锁」状态直接变为「已达成」状态；
  • 分步成就：当玩家触达到成就某步骤数时，「未解锁」状态上会展示完成度百分比，当完成所有步骤后，状态变为「已达成」状态。

成就卡片状态：

白金成就

对于高品质的游戏，当玩家获得全部本体成就时，会解锁白金成就标识。

定义范围：正式发布的全部本体成就，未发布的成就不算在内。

功能说明

创建普通成就

要为新游戏创建一个成就，你可以在开发者中心、游戏服务下找到云服务标签。选择成就菜单，然后点击创建普通成就。

填写成就的相关信息，点击保存，这个成就进入到待发布状态。

编辑普通成就

成就发布前，要编辑已经创建的成就，请在成就列表里点击编辑。此时，可以看到与第一次创建成就时一样的配置页面，根据需要进行编辑。

成就发布后，成就 ID、分步成就、成就分组和初始状态这四项配置将无法修改。

发布普通成就

完成编辑后，成就将处于待发布状态，开发者对其进行测试，验收正常后，至少要完成创建 5 个普通成就才能发布，点击发布成就，所有成就将发布到正式环境，请谨慎操作。

删除/重置成就

成就发布前，通过点击成就列表末尾的按钮，来删除和重置待发布的成就。

成就发布后，不能被删除和重置。

申请白金成就

为了确保白金成就的质量，在申请白金成就时审核人员会根据游戏质量是否高于平均水品来判断审核结果。

创建白金成就

当开发者申请白金成就资质通过后，点击创建白金成就按钮，此时完成游戏白金成就创建。白金成就需要配置图标、名称和简介。

发布白金成就

为了确保白金成就的挑战性，开发者需要至少创建 10 个本体成就后，才能发布白金成就。 另外，发布白金成就后，无法再创建本体成就，只能创建拓展成就。

多语言设置

进入 开发者中心 > 游戏服务 > 应用配置，在右上方点击多语言设置。

第二步，根据游戏内的成就勾选需要的语言，点击确定生效。另外，在右侧已选框中删除添加错误的语言。

完成以上步骤后，在编辑成就页面里点击语言标签右侧的 + 号，选择刚刚添加的语言。至此，可以为成就添加名称和简介的翻译。成就的图标和配置信息将继承默认语言的配置，不需要重复添加。

游戏内成就展示

• TapSDK：可以在游戏内展示成就面板，玩家根据开发者设计的入口打开成就界面，查看已达成和未解锁的游戏成就。
• API：开发者也可以选择使用游戏自己的成就界面，同时调用 API 的方式向 TapTap 发送成就。

游戏内成就通知

• 当玩家在游戏中触发成就行为，在游戏顶部推送冒泡。界面的成就队列只有 1 条，如同时触发多条成就，则会排队显示。
• 开发者对于游戏内的成就展示页和冒泡通知可以选择显示或隐藏。

TapTap 上展示成就

• TapTap 登录游戏：使用 TapTap 登录的玩家可以直接在 「TapTap 客户端-个人中心-关于」查看已解锁和未解锁的游戏成就。
• 非 TapTap 登录游戏：如果游戏本身存在账号体系，需要游戏自己绘制一个 TapTap 账号绑定入口，将游戏账号和 TapTap 账号关联起来，将成就数据同步到 TapTap 上。

提示

关于绑定 TapTap 账号的两种场景如何处理

• 场景 1：用户有一个非 TapTap 登录账号（账号 A），和一个没登录过游戏的 TapTap 号，需要游戏这里做账号绑定，他们是共用一个 TDS user ID，那 TapTap 上展示的是账号 A 的成就数据
• 场景 2：用户有一个非 TapTap 登录账号（账号 A），和一个已经登录过游戏的 TapTap 号（账号 B），那 TapTap 上展示的是账号 B 的成就数据。那如果用户想要展示账号 A 的数据，那就游戏自身需要有解绑账号的功能，即把账号 B 和 TapTap 账号解除绑定，把 TapTap 账号置换出来和账号 A 进行绑定

接入说明

接入准备

1. 入驻成为 TapTap 的开发者；
2. 在 TapTap 开发者中心创建游戏应用，且需要开通「内建账户」服务；
3. 提交客服工单，申请并开通「成就」权限，若要给子账号添加权限，请至「权限管理」中给该账号设置「游戏管理员」权限；
4. 下载 TapSDK（最低支持版本 v3.2.0）集成到游戏包内。

接入流程

接入指南

见 成就系统 > 开发指南。

测试验收

1. 开发者配置完成就后，可以设置少数正式环境的用户成为测试人员；
2. 测试人员可以体验到「待发布」状态的成就数据，来进行测试；
3. 在进行测试后发现数据不合理，修改了后想重新测试，只需「重置进度」或「删除成就」即可；
4. 如果测试人员的数据在发布前，没有进行重置，是会带到正式环境的，和其他用户的数据共同展示（注：是否需要删档测试，取决于运营需求）。

备注

如果需要添加测试人员体验「待发布」状态的成就，请进入开发者中心通过右上角「工单」联系 TDS 技术支持。

常见问题

游戏上线了，还能再申请「白金成就」吗？

白金成就不受游戏上线的影响。既能在游戏上线前创建好白金成就，也可以在游戏上线后创建。

「白金成就」审核时，还能发布新的普通成就吗？

白金成就的申请和创建并不影响普通成就的发布，可以随时提交已经准备好的普通成就。

在申请「白金成就」资质通过前，玩家已经获得全部成就了，还能补领吗？

如果有玩家在白金成就发布前，已经获得到全部的普通成就，再为游戏创建白金成就时，玩家依然可以自动获得。

如果已经是上架的老游戏了，对于已经使用自建账户登录或者第三方登录的用户，怎么接入使用 TDS「内建账户」呢？

答：针对老用户来说，就使用自建账号/第三方账号登录，登录后需要调用 TapSDK 的绑定接口，对老用户进行绑定。绑定后，在 TDS User（内建账户） 这里都会生成一个玩家的 ID，在使用成就系统后，TapSDK 这边会根据这个 TDS User ID 来确定该玩家身份。如果是新用户的话，直接 TapTap 登录就可以了，就不需要进行绑定这一步骤了。

如果是已经上架的老游戏接成就系统，那老用户已经完成过的成就，还能再触发吗？

老用户已完成的数据有两个方式可以同步：

• 通过服务器 API 的方式提前同步一份数据到 TDS 成就服务；
• 若游戏本身记录了成就达成的数据，那么游戏找合适的时间点把以前记录的数据转化为「成就 ID」通过 SDK 达成一次（注：需要临时关一下通知，不然顶部会有多个提醒通知）。

如果玩家已经达成了全部成就获得「白金成就」，开发者在后台又新增了一个普通成就，玩家的「白金成就」标志会消失吗？

不会，白金成就的范围仅限在分组为本体成就之内，新创建的普通成就是为拓展成就，将不会影响白金成就。

游戏有多个区服或可以创建多个角色，如果重复获得成就，SDK 的逻辑是怎样的？

成就记录跟着账号走，每个成就只记录第一次获得的行为，之后重复获得将不做展示。

调用初始化数据接口时遇到 Empty sign or session 报错，可能的原因是什么？

因为成就系统是基于内建账户系统（TDSUser）的，需要在进行成就系统初始化数据（[TapAchievement initData];）之前接入内建账户功能，并且对 TDSUser 对象进行实例化。如果 TDSUser 为空，会报错 Empty sign or session。