/Godot-TapTap-SDK

Godot 3 适用的TapTap SDK

Primary LanguageKotlin

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交流群:Godot引擎交流群 或手动搜索:722737499