Android SDK 开发指南

集成前准备

1. 参考 开发者中心配置 创建应用、配置包名与签名证书
2. 参考 Android 集成指南 完成基础接入
3. 已从 TapTap REP 平台 获取需要打开的页面链接

权限说明

该模块需要如下权限：

权限	使用目的	权限申请时机
网络权限	用于打开网页版页面	用户每次使用该功能时会申请权限
设备指定应用信息	获取已安装的 TapTap 客户端信息	用户每次使用该功能时会申请权限

该模块将在应用中添加如下权限：

<uses-permission android:name="android.permission.INTERNET" />
<queries>
        <package android:name="com.taptap" />
</queries>

SDK 获取

在 app module 的 build.gradle 中添加对应依赖：

dependencies {
  implementation 'com.taptap.sdk:tap-core:4.11.1'
  implementation 'com.taptap.sdk:tap-rep:4.11.1'
}

打开链接

Android Java

import com.taptap.sdk.rep.TapTapRep;

// 打开指定 URL
String url = ""; // 替换为实际的 URL
TapTapRep.open(url, (errorCode, errorMessage) -> {
    if (errorCode == 0) {
        // 打开成功
        Log.d("TapRep", "打开成功");
    } else {
        // 打开失败
        Log.e("TapRep", "打开失败: " + errorCode + ", " + errorMessage);
    }
});

Android Kotlin

import com.taptap.sdk.rep.TapTapRep

// 打开指定 URL
val url = "" // 替换为实际的 URL
TapTapRep.open(url) { errorCode, errorMessage ->
    if (errorCode == 0) {
        // 打开成功
        Log.d("TapRep", "打开成功")
    } else {
        // 打开失败
        Log.e("TapRep", "打开失败: $errorCode, $errorMessage")
    }
}

参数说明

参数	说明
openUrl/url	要打开的 URL 地址，必须是完整的链接（包含 http:// 或 https://）。建议使用 TapTap REP 平台 生成的链接
callback/completion	回调函数，返回打开结果。errorCode 为 0 表示成功，其他值表示失败；errorMessage 为错误信息

错误码说明

错误码	说明
0	成功
100002	参数错误（URL 为空或格式不正确）
100003	客户端配置错误（SDK 未初始化）
100004	未知错误

测试

为了保证上线后游戏能够正常使用 TapTap REP 功能，请务必按照以下说明完成自测。

测试步骤

1. 准备测试 URL

   • 访问 TapTap REP 平台 获取测试链接
   • 或使用游戏在 TapTap 上的详情页链接进行测试

2. 已安装 TapTap 客户端的情况

   • 调用 open 方法后，应能正确唤起 TapTap 应用
   • 检查打开的页面内容是否正确

3. 未安装 TapTap 客户端的情况

   • 调用 open 方法后，应能在浏览器中打开对应页面
   • 检查网页版页面内容是否正确显示

4. 错误处理

   • 测试传入空 URL 或错误格式 URL 时的错误处理
   • 测试 SDK 未初始化时调用的错误提示