SakuyaCN / Godot-TapTap-SDK

Godot 3 适用的TapTap SDK

tags	title	created	modified
Import-8d9d	Godot TapTap SDK 使用说明	2024-01-08T08:15:14.247Z	2024-01-09T03:14:31.867Z

Godot TapTap SDK 使用说明

此源码包括sdk与godot两部分的完整项目，下载后导入到3.5.x版本的引擎中便可使用，3.5以下的版本没有测试过，应该都是通用的。

• 支持引擎版本：Godot 3.5.x
• TapTap SDK版本：3.27.0

包含以下功能：

• 一键登录
• 一键防沉迷认证
• 内嵌动态
• 激励广告

---

安装方法

1. 复制项目本目录下android/plugins文件内全部内容到你的项目中或者自行编译android/build/godot_taptap模块，将编译好的aar复制到你的项目中。
2. 复制GodotTapTap.gd文件到你的项目中，并添加到自动加载中作为单例存在。
3. 项目导出时在自定义构建 中勾选启动，以及插件中勾选Godot TapTap SDK，将最小SDK设置为21（3.5默认为19）。

---

使用方法

初始化插件：

修改GodotTapTap.gd中的三个参数，改成自己taptap游戏的，具体在tap开发者后台查看

singleton.init('client_id','client_token','server_url')

监听信号

来自登录的信号，code为200是登录成功，400为登录失败,json为登录成功后返回的信息字符串
signal onLoginResult(code,json)

来自防沉迷的信号
code == 500;   // 登录成功
code == 1000;  // 用户登出
code == 1001;  // 切换账号
code == 1030;  // 用户当前无法进行游戏
code == 1050;  // 时长限制
code == 9002;  // 实名过程中点击了关闭实名窗
signal onAntiAddictionCallback(code)

来自内嵌动态的信号
10000	动态发布成功
10100	动态发布失败
10200	关闭动态发布页面
20000	获取新消息成功
20100	获取新消息失败
30000	动态页面打开
30100	动态页面关闭
50000	取消关闭所有动态界面（弹框点击取消按钮）
50100	确认关闭所有动态界面（弹框点击确认按钮）
60000	动态页面内登录成功
70000	场景化入口回调
signal onTapMomentCallBack(code)

来自激励广告的信号
500 == 广告加载失败
200 == 广告加载成功 可以播放
201 == 激励广告已显示
202 == 激励广告已经关闭
203 == 视频播放结束
204 == 视频出错
205 == 激励任务已完成，游戏可以选择在此时进行玩家奖励
206 == 激励广告中玩家点击了跳过视频的按钮
207 == 激励广告点击事件
signal onRewardVideoAdCallBack(code)

函数说明

登录模块

func tap_login()

tap登录功能

• 调用后触发onLoginResult信号

func isLogin()

判断是否登录

• 返回布尔值

func getCurrentProfile()

获取登录用户信息

• 返回字符串，如果未登录返回null

func logOut()

退出登录

• 无返回值

---

防沉迷模块

func quickCheck(id)

快速防沉迷认证

• id 玩家的唯一ID，不传则默认为android_id
• 调用后触发onAntiAddictionCallback信号

func antiExit()

退出当前用户的防沉迷认证

• 无返回值

func setTestEnvironment(enable)

切换防沉迷模块是否为测试环境

• enable bool值

---

动态模块

func setEntryVisible(enable)

是否打开悬浮窗

• enable bool值

func momentOpen(ori)

打开内嵌动态

• ori int类型，-1默认，0横屏，1竖屏，2随陀螺仪旋转

---

广告模块

func initAd(mediaId,mediaName,mediaKey)

初始化广告sdk

• mediaId,mediaName,mediaKey 应用位信息

func initRewardVideoAd(spaceId,rewardName,extraInfo,userId)

加载激励广告

• spaceId 广告位ID
• rewardName 奖励名称
• extraInfo 附加信息
• userId 用户id

func showRewardVideoAd()

播放激励广告

点击加入Godot交流群： 或手动搜索：722737499