跳到主要内容

SDK 概览

简述​

XDSDK 是面向心动发型的游戏的中台 SDK，主要提供以下功能：

  1. 平台的账户管理。 支持多种平台的登录，登录后会得到心动平台账户，支持绑定和解绑其他平台的账号以及完整的注销账号流程。
    • 国内支持 TapTap、Apple、Steam
    • 海外（以及港澳台）支持 TapTap（海外）、Apple、Google、Steam、Facebook、Twitter、Line
    • 以上平台在 Android、iOS 、Windows、Mac 上都已支持且对同一个应用数据互通
  2. 隐私协议管理。XDSDK 会在初始化调用时先进入隐私协议流程，未同意过或者有新版本协议时会主动弹出协议弹窗提示用户签署，同意后返回初始化成功即可进入游戏，如果不同意则会在二次确认后自动结束游戏进程。且 XDSDK 可以管理不同国家和地区的隐私协议，帮助游戏合法合规运营。
  3. 内购支付。 在各个平台都支持对应类型的支付渠道，方便游戏完成变现流程。
    • 移动端
      • 国内支持 Apple 和微信、支付宝支付
      • 海外支持 Apple、Google 和网页支付（Coda，Unipin，Razer，PayPal 等第三方支付，费率相对较低）
    • PC 支持网页支付和 Steam 支付
  4. 数据分析。XDSDK 在海外集成了 Firebase、Adjust、Appsflyers 和 TapDB 的 SDK，国内集成了 TapDB，默认支持付费事件，帮助游戏收集运营数据。同时海外包含 Firebase Crashlytics，可通过 Firebase 控制台查看崩溃报告。
  5. 多语言。XDSDK 支持 13 中语言：简中，繁中，英文，法文，德文，印尼文，泰文，西班牙文，葡萄牙文，土耳其文，韩文，日文，俄文，越南语。也支持针对用户进行国家/地区信息判断，游戏可以通过接口获取该信息，便于游戏进行全球化运营。

其他功能目前由 TapSDK 承担，比如内嵌动态、实名与防沉迷、内建账户、排行榜、云存档、成就、好友等，文档链接 国内 海外。

  • 防沉迷。XDSDK 从 6.4.0 的版本开始不在内置防沉迷的逻辑，需要游戏自行接入 TapSDK 的防沉迷，了解详情。
  • 客服。目前客服更推荐游戏接入 TapSDK 中的客服系统，了解详情 国内 海外。
  • 推送。虽然 XDSDK 支持海外 Firebase Cloud Messaging 的应用消息推送。但是 TapSDK 中有更全面的推送 SDK，了解详情 国内 海外。

XDSDK/TapSDK 关系说明​

TDS（TapTap Developer Services，即 TapTap 开发者服务），为开发者提供全套游戏基础服务，这些服务绝大部分被包含在 TapSDK 里面。针对心动自己研发和发行的游戏，我们还提供了 XDSDK 这样一个组件，那这两套 SDK 他们关系如何？游戏方究竟该如何接入呢？

首先，XDSDK 和 TapSDK 并不是包含关系，他们是两个平行的模块，各自承担不同的功能。

XDSDK 主要承接了心动内部的定制化需求，主要功能如上面简述所述。

TapSDK 则面向所有的游戏厂商和开发者，主要提供的服务/模块有：TapTap 登录和内建账号、内嵌动态、篝火测试、正版验证和 DLC、实名认证和防沉迷、TapDB 数据分析、游戏好友、成就、排行榜、云存档、客服系统（迭代中）、即时通讯、实时语音、消息推送、数据存储、云引擎、内购与支付以及 TapCanary 等功能。

我们第一方游戏肯定会在 Developer Center（DC，海外为 developer.taptap.io）上创建一个游戏，这样才会在 TapTap 商店上有一个游戏自己的页面，也才能开通 TapTap 登录并使用其他生态服务的功能。第一方游戏大多会接入 XDSDK，并且为了简化流程，XDSDK 接入配置中默认包含了部分 TapSDK 模块来实现自己的功能，所以游戏开发者可能会以为 XDSDK 包含了 TapSDK，但实际上只是部分模块有依赖关系。

在实现上，两个 SDK 都采用了模块化的方式来开发和发布，所以游戏不必接入所有模块/功能才能使用，按自己的需求选择对应的模块接入即可。并且，由于两个 SDK 发布的时间不同步，所以游戏也可以单独更新 TapSDK 版本——例如 XDSDK 近期没有发布新版本，而 TapSDK 有 bugfix 的话，游戏接入方是可以单独来更新依赖的 TapSDK 版本的。

除非特别说明，TapSDK 和 XDSDK 都会保证大版本内接口兼容，所以这种升级是可行的。