正版验证开发指南
正版验证适用于在 TapTap 上架的付费下载游戏。
游戏集成 TapSDK 的正版验证之后,当玩家第一次启动游戏时(包含卸载后再次安装),SDK 会前往 TapTap 查询玩家是否已购买游戏:
- 如已购买,则可正常进入游戏。
- 如查询到未购买,将出现「游戏未激活,请前往 TapTap 购买此游戏」弹窗,玩家必须选择「打开 TapTap」购买之后才能游玩。
仅提供内购、不做付费下载的游戏不需要接入正版验证,参考 DLC 文档接入即可。
SDK 获取
可以在 下载页 获得 TapSDK,添加以下依赖:
- Unity
- Android
- iOS
- UE4
SDK 可以通过 Unity Package Manager 导入或手动导入,二者任选其一。请根据项目需要选择。
方法一:使用 Unity Package Manager
NPMJS 安装
从 3.25.0 版本开始,TapSDK 支持了 NPMJS 安装,优势是只需要配置版本号,并且支持嵌套依赖。
在项目的 Packages/manifest.json
文件中添加以下依赖:
"dependencies":{
"com.taptap.tds.dlc":"3.28.2",
"com.taptap.tds.common":"3.28.2",
}
但需要注意的是,要在 Packages/manifest.json
中 dependencies
同级下声明 scopedRegistries
:
"scopedRegistries": [
{
"name": "NPMJS",
"url": "https://registry.npmjs.org/",
"scopes": ["com.tapsdk", "com.taptap", "com.leancloud"]
}
]
GitHub 安装
在项目的 Packages/manifest.json
文件中添加以下依赖:
"dependencies":{
"com.taptap.tds.common":"https://github.com/TapTap/TapCommon-Unity.git#3.28.2",
"com.taptap.tds.dlc":"https://github.com/TapTap/TapLicense-Unity.git#3.28.2",
"com.leancloud.storage":"https://github.com/leancloud/csharp-sdk-upm.git#storage-2.3.0",
}
在 Unity 顶部菜单中选择 Window > Package Manager 可查看已经安装在项目中的包。
方法二:手动导入
在 下载页 找到 TapSDK Unity 和 LeanCloud C# SDK 下载地址,分别下载
TapSDK-UnityPackage.zip
和LeanCloud-SDK-Realtime-Unity.zip
。在 Unity 项目中依次转到 Assets > Import Packages > Custom Packages,从解压后的
TapSDK-UnityPackage.zip
中,选择希望在游戏中使用的 TapSDK 包导入,其中:TapTap_Common.unitypackage
TapSDK 基础库,必选。TapTap_License.unitypackage
TapTap 正版验证库,必选。
解压后的
LeanCloud-SDK-Realtime-Unity.zip
为 Plugins 文件夹,拖拽至 Unity 即可。
将 SDK 包导入到项目 project/app/libs
目录下。打开项目的 project/app/build.gradle
文件,添加:
repositories{
flatDir {
dirs 'libs'
}
}
dependencies {
implementation name:'TapCommon_3.28.2', ext:'aar'
implementation name:'TapLicense_3.28.2', ext:'aar'
}
// 暂不支持
将插件 TapLicense 、 TapCommon 拷贝到项目的插件目录,并在项目模块的 build.cs 文件中添加依赖:
PublicDependencyModuleNames.AddRange(new string[] {
"Json",
"JsonUtilities",
"SlateCore",
"TapCommon",
"TapLicense",
});
设置授权回调
- Unity
- Android
- iOS
- UE4
// 需要引入 `License` 库
using TapTap.License;
// 默认情况下 SDK 会弹出不可由玩家手动取消的弹窗来避免未授权玩家进入游戏,如果需要回调来触发流程,请添加如下代码
TapLicense.SetLicencesCallback(ITapLicenseCallback callback);
public interface ITapLicenseCallback
{
// 授权成功回调
void OnLicenseSuccess();
}
// 默认情况下 SDK 会弹出不可由玩家手动取消的弹窗来避免未授权玩家进入游戏,如果需要回调来触发流程,请添加如下代码
TapLicenseHelper.setLicenseCallback(new TapLicenseCallback() {
@Override
public void onLicenseSuccess() {
// 授权成功回调
}
});
// 暂不支持
// 需要引入 `License` 库
#include "TapLicense.h"
// 默认情况下 SDK 会弹出不可由玩家手动取消的弹窗来避免未授权玩家进入游戏,如果需要回调来触发流程,请添加如下代码
FTapLicense::SetLicenseCallback(FSimpleDelegate::CreateLambda([]() {
// 本体授权成功
}));
检查是否购买游戏
Check 方法中参数默认值为 false,表示为 SDK 首次触发以及在距离首次触发的第 5 天之后再一次会通过 TapTap 客户端来确认当前登录用户是否购买游戏,如果使用 true 的话,则每次接口调用都会通过 TapTap 客户端来确认当前登录用户是否购买过游戏。
- Unity
- Android
- iOS
- UE4
TapLicense.Check();
TapLicense.Check(true);
TapLicenseHelper.check(Activity activity);
TapLicenseHelper.check(Activity activity, boolean forceCheck);
// 暂不支持
FTapLicense::Check();
FTapLicense::Check(true);
Android 11 及更高版本的适配
Android 11(API level 30)之后加强了隐私保护策略,引入了大量变更和限制,其中一个重要变更——软件包可见性,将会导致第三方应用无法拉起 TapTap 客户端,从而影响 TapTap 相关功能的正常使用,包括但不限于更新唤起 TapTap、购买验证等功能。
如果没有完成适配,Android 版本为 11 及更高版本的客户端打开游戏会提示「本游戏需要最新版 TapTap 服务支持」,无法正常进入游戏。异常呈现如下图所示:
对此提供如下两种适配方案:
方案一:
编译时将 targetSdkVersion
改为 29(目前设置成 >= 30 会触发该问题)。
方案二:
将 gradle build tools 改为 4.1.0+:
classpath 'com.android.tools.build:gradle:4.1.0'
在 AndroidManifest.xml 里添加
<queries>
标签中的内容:<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="string">
<application
. . .
</application>
<!--添加如下 queries 标签的内容,直接在 manifest 标签下-->
<queries>
<package android:name="com.taptap" />
<package android:name="com.taptap.pad" />
<package android:name="com.taptap.global" />
</queries>
</manifest>
测试
为了保证上线后,正版验证服务能够正常生效,请务必按照以下说明完成自测。
1. 上传 APK
前往开发者中心选择需要测试的游戏,依次转入游戏服务 > 开发与构建 > 正版验证 > 游戏配置 > 包名。
上传需要测试的 APK 至开发者中心,等待审核通过。
2. 添加测试用户
前往开发者中心 > 游戏服务 > 开发与构建 > 正版验证 > 游戏配置 > 测试用户管理,填写测试用户的 TapTap ID。
3. 售卖设置
在开发者中心 > 商店 > 售卖设置中为游戏设置测试价格,建议测试价格设置为 0.01 元,提交并等待审核通过。
4. 开始测试
打开 TapTap 客户端,使用上面填写的测试用户账号登录,从游戏商店页面开始正版验证的测试。
测试用户可在 TapTap 购买这个付费游戏,购买后才能顺利下载并进入游戏。
如果测试用户未购买,通过其他途径安装游戏 APK,进入游戏后会弹出不可由玩家手动取消的弹窗,显示「游戏未激活,请前往 TapTap 购买此游戏」。
正式售卖
完成上面的测试环节后,游戏可以开始售卖。按照以下步骤操作:
1. 完善应用信息
前往开发者中心,填写应用信息,等待审核通过。
2. 设置售卖价格
前往开发者中心 > 商店 > 售卖设置,开启售卖开关,设置游戏正常售卖金额,提交审核,并同步对接的 TapTap 运营相关信息。
3. 正式上线
所有流程都确保顺利后,游戏可正式上线。