接入必读

选择 SDK 接入的原则

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

SDK 接入准备

TapSDK 接入准备

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

• 国内版（参考文档：创建应用）。
• 海外版（参考文档：创建应用）。

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

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

XDSDK 接入准备

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

• 国内版 游戏 开通流程：前期准备-国内、XD Client ID 申请流程-国内
• 海外版 游戏 开通流程：前期准备、XD Client ID 申请流程

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

• 海外版校验链接：

https://xdsdk-os-prod-gateway.xd.com/api/init/v1/config?clientId=hn5RcJ******CYlS0&countryCode=DF&sdkLang=cn

• 国内版校验链接：

https://xdsdk-cn-prod-gateway.xd.cn/api/init/v1/config?clientId=d4bjgw******k84wk&countryCode=CN&sdkLang=cn

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

提示

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

注意事项

自行接入防沉迷

从 XDSDK v7.0.0 开始，XDSDK 内置防沉迷 SDK 及其逻辑调用。游戏需要自行移除相关逻辑代码。建议游戏预留一定的时间来完成接入和测试！