跳到主要内容

接入必读

选择 SDK 接入的原则​

  • TapSDK 是面向所有游戏厂商提供服务的，心动游戏当然可以接入。
  • 如果是买断制游戏，没有内购，隐私协议也不以心动公司为主体，可以直接接入 TapSDK。
  • 如果需要使用心动主体的隐私协议，那么接入 XDSDK。

SDK 接入准备​

TapSDK 接入准备​

首先，需要去 DC 上自助创建一个游戏 Client:

其次，集成 TapSDK 的最新版本（参考文档：快速开始）。

之后，可以参照 TapSDK 的文档说明，接入具体的功能模块即可。

XDSDK 接入准备​

XDSDK 目前还不能自助操作，要创建应用，需按照如下流程进行人工处理：

申请 XDSDK 的 Client ID 流程完成后，可以请求下面的校验链接来验证是否开通成功。接口返回 200 表示请求成功，可以查看到应用的相关配置信息。此外，XDSDK 的初始化配置文件 XDConfig.json 中需要配置的 Appid 参数亦包含在接口的返回中。链接中的 clientId 是 TapTap 开发者中心 > 游戏服务 > 应用配置处的 Client ID。

  • 海外版校验链接：https://xdsdk-intnl-6.xd.com/api/init/v1/config?clientId=hn5RcJ******CYlS0&countryCode=DF&sdkLang=cn
  • 国内版校验链接：https://xdsdk-6.xd.cn/api/init/v1/config?clientId=d4bjgw******k84wk&countryCode=CN&sdkLang=cn

创建完应用后，可参考本文档进行接入，其他流程可参考：XDSDK 流程及规范。

提示
  • 开通第三方登录（例如苹果、谷歌登录），需要平台部同学手动去完成第三方账号申请，建议游戏项目组提前一个月开始沟通；
  • 开通网页支付以及苹果、谷歌支付，需要联系 PMO 获取相关配置信息，也需要平台部同学去各支付渠道完成开通认证，流程较长，建议游戏项目组提前 2-3 个月开始申请。

注意事项​

自行接入防沉迷​

从 XDSDK v6.4.0 开始，XDSDK 不再内置防沉迷 SDK 及其逻辑调用。游戏需要自行参考 TapSDK 中 实名认证和防沉迷开发指南 的内容来完成国内防沉迷的接入。建议游戏预留一定的时间来完成接入和测试！

TapDB 版本注意​

在国内版开发者中心（DC）上架的海外游戏（应用在国内 DC，但游戏在海外发行、游戏服务-应用配置中选择的适用地区也为海外），在升级 XDSDK 时需要注意 TapDB 最高使用版本只能 <= 3.6.1 版本。

自 TapDB 3.6.3 起，统计数据会报到海外集群，导致在国内开发者中心看数据分析（TapDB）的时候看不到任何数据。

如果要升级至 3.6.3 及更高版本，我们建议先把应用迁移到海外 DC，同时联系 DB 同事迁移旧数据至海外版。

强烈建议在国内 DC 上架的海外游戏尽快把应用迁移到海外 DC 上，具体迁移方式请联系 XDSDK 产品经理。详细信息参考 TapDB 说明文档。