跳到主要内容
版本:v2

开发指南

TapTap 开发者服务为游戏和玩家提供唤起 TapTap 客户端进行游戏更新的功能。当游戏发布了新版本,且需要玩家进行更新才能体验新版本时,在游戏内绘制一个界面告知玩家,需要进行新版本更新,并且提供一个更新的按钮。玩家点击后,会跳转到 TapTap 客户端内的游戏详情页面,进行更新。

Unity

检查 TapTap 是否安装

在项目的 Packages/manifest.json 文件中添加以下依赖:

"dependencies":{
// 公共库,{version} 为具体版本号
"com.taptap.tds.common":"https://github.com/TapTap/TapCommon-Unity.git#{version}",
}
TapCommon.IsTapTapInstalled(installed =>
{
if (installed) {
Debug.Log("TapTap 已经安装");
}
});

唤起 TapTap 检查更新

TapCommon.UpdateGameInTapTap("appid", callSuccess =>
{
if (callSuccess) {
Debug.Log("TapTap 唤起成功");
}
});

appid: 游戏在 TapTap 商店的唯一身份标识
例如:https://www.taptap.cn/app/187168 ,其中 "187168" 是 appid

打开游戏评论区

TapCommon.OpenReviewInTapTap(appId, openSuccess =>
{
if (openSuccess) {
Debug.Log("打开游戏评论区成功");
}
});

Android

检查 TapTap 是否安装

接口在 TapGameUtil 里面,import com.tds.common.utils.TapGameUtil;

if(TapGameUtil.isTapTapInstalled(this)){
Log.d(TAG, "已经安装 TapTap 客户端");
}

唤起 TapTap 检查更新

if(TapGameUtil.updateGameInTapTap(this,"appid")){
Log.d(TAG, "唤起 TapTap 客户端成功");
}

appid: 游戏在 TapTap 商店的唯一身份标识
例如:https://www.taptap.cn/app/187168 ,其中 "187168" 是 appid

打开游戏评论区

if(TapGameUtil.openReviewInTapTap(this,"appid")){
Log.d(TAG, "打开评论区成功");
}

常见问题

关于 Android 11 无法拉起 TapTap 客户端的解决方案

Android 11 加强了隐私保护策略,引入了大量变更和限制,其中一个重要变更 —— 软件包可见性 ,将会导致第三方应用无法拉起 TapTap 客户端,从而影响 TapTap 相关功能的正常使用 ,包括但不限于更新唤起 TapTap 、购买验证等功能。 特别需要注意的是,Android 11 的该变更只会影响到升级 targetSdkVersion=30 的应用,未升级的应用暂不受影响。

方案一:

编译时将 targetSdkVersion 改为 29(目前 =30 会触发该问题)

方案二:

  1. 将 gradle build tools 改为 4.1.0+
classpath 'com.android.tools.build:gradle:4.1.0'
  1. 在 AndroidManifest.xml 里添加如下内容
<queries>
<package android:name="com.taptap" />
<package android:name="com.taptap.pad" />
<package android:name="com.taptap.global" />
</queries>