跳到主要内容
版本：v4

TapTap PC 端集成

本文介绍如何快速通过 TapSDK 接入 TapTap PC 端。

提示

注意：目前如需接入，请先联系对接运营申请开启白名单。

环境要求​

  • Unity 2019.4 或更高版本

项目配置​

1. 添加 SDK 所需的外部依赖​

SDK 内部使用的 JSON 解析库为 Newtonsoft-json，如果当前工程已接入该依赖库，则不需额外处理，否则需在 Packages/manifest.json 添加如下依赖：

"com.unity.nuget.newtonsoft-json":"3.2.1"

由于 SDK 默认支持移动端及 PC 平台， 所以编译时需添加 com.google.external-dependency-manager 的移动端依赖，如果当前工程已接入该依赖库，则不需额外处理，否则需在 Packages/manifest.json 添加如下依赖：

{
   "dependencies": {
      "com.google.external-dependency-manager": "1.2.179"
   },
   "scopedRegistries": [
      {
         "name": "package.openupm.com",
         "url": "https://package.openupm.com",
         "scopes": [
            "com.google.external-dependency-manager"
         ]
      }
  ]
}

2. 添加 SDK 依赖​

SDK 支持远程依赖 (Unity Package Manager) 及本地文件导入两种集成方式，开发者根据需求选择其中一种即可，推荐使用远程依赖。

远程依赖​

SDK 支持通过 NPMJS 及 GitHub 两种方式，开发者选择其中一种即可。

1. NPMJS 接入​

在项目的 Packages/manifest.json 文件中添加以下依赖：

"dependencies":{
  "com.taptap.sdk.core":"4.5.9"
}

但需要注意的是，需在 Packages/manifest.json 中 dependencies 同级下声明 scopedRegistries：

"scopedRegistries":[
  {
    "name": "NPMJS",
    "url": "https://registry.npmjs.org/",
    "scopes": ["com.taptap"]
  }
]
2. GitHub 接入​

在项目的 Packages/manifest.json 文件中添加以下依赖：

"dependencies":{
  "com.taptap.sdk.core":"https://github.com/taptap/TapSDKCore-Unity.git#4.5.9"
}

在 Unity 顶部菜单中选择 Window > Package Manager 可查看已经安装在项目中的包。

本地文件导入​

  1. 在 下载页 下载下列模块对应 unitypackage 文件，并在 Unity 项目中依次通过 Assets > Import Packages > Custom Packages 进行导入，包括：
  • TapSDK_Core.unitypackage TapTapSDK 核心模块，必选
  1. 如果当前项目已集成 Newtonsoft.Json 依赖，则忽略该步骤，否则在 NuGet.org Newtonsoft.Json 页面中通过点击右侧 「Download package」 下载库文件，并将下载的文件后缀从.nupkg 修改为 .zip，同时解压该文件并复制内部的 Newtonsoft.Json.dll 文件拷贝到工程 Assets 的 Plugins 目录下，另外为了避免导出 IL2CPP 平台时删除必要数据，需在 Assets 目录下创建 link.xml 文件（如果已有该文件，则添加如下内容），其内容如下：
<linker>
  <assembly fullname="System.Core">
    <type fullname="System.Linq.Expressions.Interpreter.LightLambda" preserve="all" />
  </assembly>
</linker>

初始化​

根据 TapTap 开发者中心的应用配置信息，调用如下接口完成初始化

using TapSDK.Core;

// 核心配置
TapTapSdkOptions coreOptions = new TapTapSdkOptions
{
   // 客户端 ID，开发者后台获取
   clientId = "游戏 clientId",
   // 客户端令牌，开发者后台获取
   clientToken = "游戏 clientToken",
   // 地区，仅支持 CN 国内
   region = TapTapRegionType.CN,
   // 是否开启日志，Release 版本请设置为 false
   enableLog = true,
   // 客户端公钥，开发者后台获取
   clientPublicKey = "游戏 clientPublicKey"
};
// TapSDK 初始化
TapTapSDK.Init(coreOptions);

// 当需要添加其他模块的初始化配置项，例如合规认证等， 请使用如下 API
TapTapSdkBaseOptions[] otherOptions = new TapTapSdkBaseOptions[]
{
    // 其他模块配置项
};
TapTapSDK.Init(coreOptions, otherOptions);

启动校验​

为了保证游戏能够通过 TapTap PC 端获取必要的应用和授权信息，开发者在调用初始化接口后，必须调用该接口来完成前置启动校验，当返回值为 true 时，游戏可进行后续登录等其他业务流程，当返回结果为 false 时，SDK 会通过弹窗的形式引导用户重新通过 TapTap PC 端启动游戏或下载 TapTap PC 端，游戏需停止进行后续业务流程 。

由于校验过程属于异步操作，所以调用该接口前建议游戏先显示加载（Loading）弹窗， 当 SDK 返回结果后，再关闭该弹窗。调用示例如下：

using TapSDK.Core;

bool IsSuccess = await TapTapSDK.IsLaunchedFromTapTapPC();
if (IsSuccess)
{
    UnityEngine.Debug.Log(" TapTap PC 端校验通过");
    // TODO: 继续后续登录等其他业务流程
}
else
{
    UnityEngine.Debug.Log(" TapTap PC 端校验未通过");
    // 停止执行后续业务流程
}

登录及获取用户信息​

接入 TapTap PC 端的游戏在登录流程上与未接入的游戏存在显著差异，游戏接入后，在用户登录时，SDK 会基于当前 TapTap PC 端已登录的账号信息自动完成静默登录，无需用户进行额外操作，从而显著提升登录体验。

由于该流程为异步操作，建议开发者在发起登录前显示加载（Loading）弹窗，并在登录流程完成后关闭该弹窗，以提升用户体验。具体接入方式请参考 TapTap 登录开发指南。

合规认证​

通过 TapTap PC 端完成登录后，SDK 将会通过 TapTap PC 端获取用户的实名信息并进行后续合规认证检查，避免了用户额外授权。

具体接入方式请参考 合规认证开发指南。

开发调试方式​

在游戏尚未发布期间，开发者可参照以下流程完成本地调试配置，配置完成后，即可在调试阶段无需依赖 TapTap PC 端启动游戏，直接运行游戏可执行文件进行测试。

1. 下载及配置调试文件​

在 TapTap 开发者中心游戏「商店」的 「PC 游戏管理」 -> 「开放能力」 页面下载调试文件 (taptap_client_id.txt)，如图所示：

点击 「taptap_client_id.txt」 后，浏览器会下载一个对应名称的文本文件，开发者需将该文件移动到游戏可执行文件所在目录下。

2. 添加测试用户白名单​

在上一步骤同一页面中，选择 「设置自测用户」，将弹出设置自测用户窗口，如下图：

点击「添加用户」，输入用户 TapTap ID 并点击右侧的搜索按钮，待搜索结果返回后，选择对应用户并点击「提交」按钮，即可完成添加操作。

3. 下载 TapTap PC 端并登录​

下载 TapTap PC 端，并登录已配置的自测用户账号，即可在本地启动游戏，开始测试相关业务功能。

提示

注意：当发布游戏时，请务必删除游戏目录中的 taptap_client_id.txt 调试文本文件