成就系统功能介绍

开发者可以在开发者中心后台配置并发布游戏成就，玩家在游戏内触发并获得成就，从而提升玩家在游戏中的参与度，鼓励玩家以不同的玩法来玩游戏。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 个金币」也不符合条件，因为玩家在玩游戏时可能会获得、也会失去金币。对于后两项成就，你可以把成就名称设定为「连续获胜」或「金币总数」，并在玩家达成目标时解锁的标准成就。

成就稀有度

获得成就人数的百分比，值越低，获得人数越少，越稀有。成就稀有度会通过 SDK 面板进行展示，前提是需要达到一定的统计量及人数达到 100 人。TapTap 上展示的成就并不会展示成就稀有度。

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

• 普通：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 上。
• 目前只支持上架中国大陆区域的游戏在 TapTap 上展示成就。

tip

关于绑定 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. 如果测试人员的数据在发布前，没有进行重置，是会带到正式环境的，和其他用户的数据共同展示（注：是否需要删档测试，取决于运营需求）。

note

如果需要添加测试人员体验「待发布」状态的成就，请进入开发者中心通过右上角「工单」联系 TDS 技术支持。「工单」中请提供应用的 Client ID 以及测试账号实现 TapTap 登录后返回的 Object ID。