Skip to main content
Version: v4

Unity SDK 开发指南

集成前准备​

  1. 参考 开发者中心配置 创建应用、配置包名与签名证书
  2. 参考 Unity 集成指南 完成基础接入
  3. 已从 TapTap REP 平台 获取需要打开的页面链接

权限说明​

Android 权限说明​

该模块在 Android 平台需要如下权限：

权限使用目的权限申请时机
网络权限用于打开网页版页面用户每次使用该功能时会申请权限
设备指定应用信息获取已安装的 TapTap 客户端信息用户每次使用该功能时会申请权限

该模块将在 Android 应用中添加如下权限：

<uses-permission android:name="android.permission.INTERNET" />
<queries>
    <package android:name="com.taptap" />
</queries>

SDK 获取​

远程依赖​

NPMJS 方式：在 Packages/manifest.json 中添加：

"dependencies":{
  "com.taptap.sdk.core":"4.11.1",
  "com.taptap.sdk.rep":"4.11.1"
}

GitHub 方式：在 Packages/manifest.json 中添加：

"dependencies":{
  "com.taptap.sdk.core":"https://github.com/taptap/tapsdk-unity-dist.git?path=/Core#4.11.1",
  "com.taptap.sdk.rep":"https://github.com/taptap/tapsdk-unity-dist.git?path=/Rep#4.11.1"
}

本地文件导入​

在 下载页 下载并导入以下 unitypackage 文件：

  • TapSDK_Core.unitypackage (TapTapSDK 核心模块，必选)
  • TapSDK_Rep.unitypackage（TapTapSDK REP 模块，必选）

打开链接​

using TapSDK.Rep;

// 打开指定 URL
string url = ""; // 替换为实际的 URL
TapTapRep.Open(url, (errorCode, errorMessage) =>
{
    if (errorCode == 0)
    {
        // 打开成功
        Debug.Log("打开成功");
    }
    else
    {
        // 打开失败
        Debug.LogError($"打开失败: {errorCode}, {errorMessage}");
    }
});

参数说明​

参数说明
openUrl/url要打开的 URL 地址，必须是完整的链接（包含 http:// 或 https://）。建议使用 TapTap REP 平台 生成的链接
callback/completion回调函数，返回打开结果。errorCode 为 0 表示成功，其他值表示失败；errorMessage 为错误信息

错误码说明​

错误码说明
0成功
100002参数错误（URL 为空或格式不正确）
100003客户端配置错误（SDK 未初始化）
100004未知错误

测试​

为了保证上线后游戏能够正常使用 TapTap REP 功能，请务必按照以下说明完成自测。

测试步骤​

  1. 准备测试 URL

    • 访问 TapTap REP 平台 获取测试链接
    • 或使用游戏在 TapTap 上的详情页链接进行测试

  2. 已安装 TapTap 客户端的情况

    • 调用 open 方法后，应能正确唤起 TapTap 应用
    • 检查打开的页面内容是否正确

  3. 未安装 TapTap 客户端的情况

    • 调用 open 方法后，应能在浏览器中打开对应页面
    • 检查网页版页面内容是否正确显示

  4. 错误处理

    • 测试传入空 URL 或错误格式 URL 时的错误处理
    • 测试 SDK 未初始化时调用的错误提示