版本：v4

UE5 SDK 开发指南

集成前准备

在 REP 平台创建置换活动并获取跳转短链
参考 UE5 集成指南完成 TapSDK 基础接入

权限说明

Android 权限说明

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

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

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

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

SDK 获取

参考 UE5 集成指南完成 TapCore 基础接入。再从下载页下载相同版本的 TapRep，放入项目的 Plugins 目录并启用。

添加模块依赖

在游戏模块的 <GameModule>.Build.cs 中添加：

PublicDependencyModuleNames.AddRange(new string[]
{
    "TapCore",
    "TapRep",
});

修改 Build.cs 后重新生成项目文件并编译。

打开链接

初始化成功后，调用 UTapRep::Open 打开 REP 平台生成的完整链接。通过原生单播 Delegate 返回 Code 和 Message，其中 Code=0 表示成功。此接口仅支持 C++ 调用。

#include "TapRep.h"

UTapRep::Open(
    TEXT("your_rep_url"), // 替换为 REP 平台生成的完整链接
    FTapRepCallback::CreateLambda([](int32 Code, const FString& Message)
    {
        if (Code == 0)
        {
            UE_LOG(LogTemp, Log, TEXT("REP 打开成功"));
        }
        else
        {
            UE_LOG(LogTemp, Error, TEXT("打开失败: %d, %s"), Code, *Message);
        }
    }));

测试

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

测试步骤

准备测试 URL
- 访问 TapTap REP 平台获取测试链接
- 或使用游戏在 TapTap 上的详情页链接进行测试
已安装 TapTap 客户端的情况
- 调用 Open 方法后，应能正确唤起 TapTap 应用
- 检查打开的页面内容是否正确
未安装 TapTap 客户端的情况
- 调用 Open 方法后，应能在浏览器中打开对应页面
- 检查网页版页面内容是否正确显示
错误处理
- 测试传入空 URL 或错误格式 URL 时的错误处理
- 测试 SDK 未初始化时调用的错误提示

集成前准备​

权限说明​

Android 权限说明​

SDK 获取​

添加模块依赖​

打开链接​

测试​

测试步骤​