版本：v3

悬浮窗开发指南

本文介绍如何在游戏中加入 TapTap 悬浮窗。使用悬浮窗功能需依赖 TapTap 登录（TapLogin）以及 TapTap 内嵌动态功能（TapMoment）。

环境要求

Unity
Android
iOS
UE4

TapSDK 3.21.0 及以上版本
Unity 2019.4 或更高版本
iOS 11 或更高版本，Xcode 版本 14.1 或更高版本
Android 5.0（API level 21）或更高版本

集成前准备

参考准备工作创建应用、开启悬浮窗相应设置；

SDK 获取

请先参考 TapTap 登录和内嵌动态完成 SDK 获取，然后在此基础上可以通过下载获得 TapSDK，添加 TapConnect 模块：

Unity
Android
iOS
UE4

"dependencies":{
  ...
  // 悬浮窗
  "com.taptap.tds.connect":"https://github.com/TapTap/TapConnect-Unity.git#3.23.0",
  "com.taptap.tds.login":"https://github.com/TapTap/TapLogin-Unity.git#3.23.0",   // 悬浮窗依赖登录模块-必选
  "com.taptap.tds.moment":"https://github.com/TapTap/TapMoment-Unity.git#3.23.0", // 悬浮窗依赖内嵌动态-必选
  "com.taptap.tds.common":"https://github.com/TapTap/TapCommon-Unity.git#3.23.0",    // 基础模块-必选
  "com.taptap.tds.bootstrap":"https://github.com/TapTap/TapBootstrap-Unity.git#3.23.0", // 基础模块-可选
}

repositories{  
    flatDir {  
        dirs 'libs'  
    }  
}  
dependencies {  
    ... 
    implementation (name:'TapConnect_3.23.0', ext:'aar') // TapTap 悬浮窗
    implementation (name:'TapMoment_3.23.0', ext:'aar') // TapTap 悬浮窗依赖内嵌动态-必选
    implementation (name:'TapLogin_3.23.0', ext:'aar')  // TapTap 悬浮窗依赖登录模块-必选
    implementation (name:'TapCommon_3.23.0', ext:'aar') // 必选：TapSDK 基础库
    implementation (name:'TapBootstrap_3.23.0', ext:'aar') // 可选：TapSDK 基础库
}

// 悬浮窗
TapConnectResource.bundle
TapConnectSDK.framework
// 悬浮窗依赖内嵌动态和登录模块-必选
TapMomentResource.bundle
TapMomentSDK.framework
TapLoginSDK.framework
TapLoginResource.bundle
// 基础模块-必选
TapCommonResource.bundle
TapCommonSDK.framework
// 基础模块-可选
TapBootstrapSDK.framework

PublicDependencyModuleNames.AddRange(new string[] { 
  //...
  "TapConnect"  //必选
  "TapLogin"    //必须-悬浮窗依赖登录模块
  "TapMoment"   //必选-悬浮窗依赖内嵌动态
  "TapCommon"   //必选-基础模块
  "TapBootstrap"//可选-基础模块
});

初始化

信息

以下两种初始化方式任选其一。

TapSDK 初始化

如果你已经完成内建账户系统 Tap 登录的初始化，这里只需要引入悬浮窗模块，不需要其他额外处理。

悬浮窗单独初始化

如果游戏不通过上面提供的 TapBootstrap 方法初始化 TapSDK，悬浮窗可以单独初始化，因为悬浮窗依赖单纯 Tap 认证和内嵌动态，

提示

单独初始化悬浮窗需要优先完成单纯 TapTap 认证 和 内嵌动态 的初始化动作。关于单纯 TapTap 认证初始化参考，关于内嵌动态初始化参考，

下面是单独初始化悬浮窗的示例代码：

Unity
Android
iOS
UE4

using TapTap.Connect; // 命名空间

TapConnect.Init("your_client_id", "your_client_token", (bool)isCN);

//activity 为当前 Activity 实例
TapConnect.init(activity, "clientId", "clientToken", isCN);

[TapConnect initWithClientId:@"clientId" clientToken:@"clientToken" isCN:YES];

FTapConnect::Init("clientId", "clientToken", true);

参数说明

client_id、client_token 信息可在 开发者中心 > 你的游戏 > 游戏服务 > 应用配置 查看, isCN 表示是否为中国大陆地区的应用。

设置悬浮窗入口显示隐藏

有时开发者希望在某些场景下直接控制悬浮窗入口的显示隐藏，比如仅在部分场景显示悬浮窗入口，这时可以调用下面的接口：

Unity
Android
iOS
UE4

TapConnect.SetEntryVisible(bool visible)

TapConnect.setEntryVisible(boolean visible);

[TapConnect setEntryVisible:YES];

FTapConnect::SetEntryVisible(true);

国际化

悬浮窗支持设置语言：

Unity
Android
iOS
UE4

TapCommon.SetLanguage(TapLanguage.AUTO);

支持如下语言：

namespace TapTap.Common
{
    public enum TapLanguage
    {
        AUTO = 0, // 自动
        ZH_HANS = 1, // 简体中文
        EN = 2, // 英文
        ZH_HANT = 3, // 繁体中文
        JA = 4, // 日文
        KO = 5, // 韩文
        TH = 6, // 泰文
        ID = 7, // 印尼语
        DE = 8, // 德语
        ES = 9, // 西班牙语
        FR = 10, // 法语
        PT = 11, // 葡萄牙语
        RU = 12, // 俄语
        TR = 13, // 土耳其语
        VI = 14, // 越南语
    }
}

TapLanguage lang = 0;
TapBootstrap.setPreferredLanguage(TapLanguage.AUTO);

支持如下语言：

AUTO 跟随系统
ZH_HANS 简体中文
EN 英文
ZH_HANT 繁体中文
JA 日文
KO 韩文
TH 泰文
ID 印尼语
DE 德语
ES 西班牙语
FR 法语
PT 葡萄牙语
RU 俄语
TR 土耳其语
VI 越南语

[TapBootstrap setPreferredLanguage:TapLanguageType_Auto];

支持如下语言：

typedef NS_ENUM (NSInteger, TapLanguageType) {
    TapLanguageType_Auto = 0, // 自动
    TapLanguageType_zh_Hans, // 简体中文
    TapLanguageType_en, // 英文
    TapLanguageType_zh_Hant, // 繁体中文
    TapLanguageType_ja, // 日文
    TapLanguageType_ko, // 韩文
    TapLanguageType_th, // 泰文
    TapLanguageType_id, // 印度尼西亚语
    TapLanguageType_de, // 德语
    TapLanguageType_es, // 西班牙语
    TapLanguageType_fr, // 法语 
    TapLanguageType_pt, // 葡萄牙语
    TapLanguageType_ru, // 俄语
    TapLanguageType_tr, // 土耳其语
    TapLanguageType_vi, // 越南语
};

TapUECommon::SetLanguage(ELanguageType::AUTO);

支持如下语言：

UENUM(BlueprintType)
enum class ELanguageType : uint8
{
    AUTO = 0,   // 自动
    ZH,         // 简体中文
    EN,         // 英文，海外默认语言
    ZHTW,       // 繁体中文
    JA,         // 日语
    KO,         // 韩语
    TH,         // 泰文
    ID,         // 印尼文
};

「自动」会尝试根据系统语言设置语言，如果系统语言不在上述支持的语言之中，那么会根据 SDK 初始化时配置的区域设置语言。区域为中国大陆时会设置为简体中文，否则会设置为英文。

环境要求​

集成前准备​

SDK 获取​

初始化​

TapSDK 初始化​

悬浮窗单独初始化​

参数说明​

设置悬浮窗入口显示隐藏​

国际化​

环境要求

集成前准备

SDK 获取

初始化

TapSDK 初始化

悬浮窗单独初始化

参数说明

设置悬浮窗入口显示隐藏

国际化