GHOME SDK 文档 - 支付中心

# GHome手游国内版sdk接入文档（Android）Version说明

# 特别说明

  • 2024年11月前SDK版本，当更新最新版本时，需要注意入参 roleCreateTime、roleLevelUpdateTime 修改为 UTC 时间。

# 2024-11-29 Ver:10.3.0.1

更新内容：

  • 更新doExtend接口入参里的时间传入格式

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

  • 文档11.4章节上报角色信息传入的角色信息时间格式传入单位：秒。(本就是传入的秒则无需进行接入代码变动)

      jsonExData.put("roleCreateTime", "1488264008");        // 格式为：北京时间1970.01.01 00:00:00到现在的秒数，或者 （unix时间戳+8小时）（秒）
  jsonExData.put("roleLevelUpdateTime", "1488264008");        // 格式为：北京时间1970.01.01 00:00:00到在的秒数，或者 （unix时间戳+8小时）（秒）
    1
    2

# 2024-11-27 Ver:10.3.0.0

更新内容：

  • 依赖的三方sdk(oaid sdk) 版本更新

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可
  • 删除如下这条在线库依赖:
implementation 'com.hihonor.mcs:ads-identifier:1.0.2.301' //荣耀
1

# 2024-11-25 Ver:10.2.0.1

更新内容：

  • 支付接口入参字段更新

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

  • 按照游戏接入的支付方式，根据支付章节9.1的示例代码进行支持点券的支付方式入参的更新

                JSONObject dianquanPayParams = new JSONObject();
            dianquanPayParams.put("appid", "791000008");
            dianquanPayParams.put("pc", "3"); 
            dianquanPayParams.put("oa", "10"); 
            dianquanPayParams.put("area", "2");
            dianquanPayParams.put("group", "1");
    1
    2
    3
    4
    5
    6

# 2024-11-21 Ver:10.2.0.0

更新内容：

  • sdk内部新增一种支付方式

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

  • 新增的支付方式接入请看接入文档支付章节9.1的示例代码

# 2024-11-05 Ver:10.0.0.9

更新内容：

  • sdk内部优化更新
  • 根据文档 11.5节，调用确认退出app接口
  • 根据接入文档第11.4.1节，在上报信息接口入参信息新增一个groupId 字段信息

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源

  • 新增模块级build.gradle 的一个在线依赖：

    implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.61'
    1

  • 确认退出app接口：

    GHome.getInstance().doExtend(ctx.get(), IGHomeApi.EXTEND_COMMAND_CONFIRM_EXIT_APP, new HashMap<String, String>(), null);
    1

  • 上报信息相关接口新增groupId, 示例：

    ....
jsonExData.put("groupId", "1");       // 当前登录的游戏组ID
....
    1
    2
    3

  • 在app module级别的build.gradle中defaultConfig，添加url scheme:manifestPlaceholders.put("APPLOG_SCHEME","rangersapplog.byAx6uYt".toLowerCase()),

    示例如下：

    android {
    compileSdk 33

    defaultConfig {
        applicationId "com.ghome.sdk.demo"
        minSdk 23

.....

        manifestPlaceholders.put("APPLOG_SCHEME", "rangersapplog.byAx6uYt".toLowerCase())
    }

...
}
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14

  • 可能出现的问题：# AndroidManifest 合并出错 tools:replace="android:allowBackup",

    解决方案：在游戏工程的Androidmanifest内添加如下配置：

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:tools="http://schemas.android.com/tools">

<application
        tools:replace="android:allowBackup">
</manifest>
    1
    2
    3
    4
    5
    6
    7

  • 注意事项：

    1.游戏包targetSdkVersion需要>=26

    2.每次出新游戏包Apk时需要升高版本号（versionCode），不可降低

# 2024-10-22 Ver:10.0.0.8

更新内容：

  • sdk内部优化更新

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-09-26 Ver:10.0.0.7

更新内容：

  • sdk内部依赖的三方sdk更新

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

  • 分享模块：适配target34+的情况下分享录制视频出现的问题，需添加以下权限：

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION"
        android:minSdkVersion="34"/>
    1
    2

  • 更新在线依赖库okhttp版本（3.10.0 -> 3.14.9）:

    implementation 'com.squareup.okhttp3:okhttp:3.14.9'
    1

  • 删除app模块级的build.gradle如下三条在线库依赖：

    def bdVersion = "6.15.4"
implementation "com.bytedance.applog:RangersAppLog-Lite-cn:$bdVersion"
implementation "com.bytedance.applog:RangersAppLog-All-convert:$bdVersion"
implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.61'
    1
    2
    3
    4

  • 删除项目级build.gradle 的插件依赖(如果之前接入过程有添加过的话，否则无需关注)：

    classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:2.0.0-Beta2'
    1

# 2024-09-13 Ver:10.0.0.6

更新内容：

  • sdk内部更新优化

更新方式：

  • 把sdk zip包libs下的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-06-21 Ver:10.0.0.5

更新内容：

  • 新增接口 isTapTapChannel（详情请看接入文档7.2节）

更新方式：

  • 把sdk zip包内的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-06-14 Ver:10.0.0.4

更新内容：

  • 更新第三方sdk-腾讯人脸识别sdk
  • 新增接口 tapTapUpdateGame（详情请看接入文档7.2节）

更新方式：

  • 把sdk zip包内的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-06-05 Ver:10.0.0.3

更新内容：

  • ghome sdk登录界面优化更新 以及部分设备信息采集补充优化

更新方式：

  • 把sdk zip包内的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-05-30 Ver:10.0.0.2

更新内容：

  • ghome sdk登录界面优化更新

更新方式：

  • 把sdk zip包内的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-05-11 Ver:10.0.0.1

更新内容：

  • 日志采集组件内部合规优化

更新方式：

  • 把sdk zip包内的所有aar资源拷贝进游戏项目libs更新或覆盖已接入aar资源即可

# 2024-05-10 Ver:10.0.0.0

更新内容：

  • sdk内部登录功能扩展以及优化
  • ghomesharesdk内部优化
  • 日志采集组件内部优化

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar，ghomegshare_v XXX.aar, greport.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖

# 2024-04-15 Ver:9.8.0.2

更新内容：

  • sdk内部优化

  • 更新阿里 以及 微信 sdk 依赖方式（根据文档接入步骤的在线库依赖部分 删除如下两条依赖：）

    implementation 'com.alipay.sdk:alipaysdk-android:x.x.x'
implementation 'com.tencent.mm.opensdk:wechat-sdk-android:x.x.x'
    1
    2

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖

  • 根据接入文档首部的更新提示做部分配置更新

# 2024-04-10 Ver:9.8.0.1

更新内容：

  • sdk内部优化
  • 更新极验 sdk（根据文档接入步骤的在线库依赖部分 添加implementation 'com.geetest.sensebot:sensebot:4.4.2.1' 即可）

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖

  • 根据接入文档首部的更新提示做部分配置更新

# 2024-02-20 Ver:9.8.0.0

更新内容：

  • sdk内部优化
  • 更新QQ sdk

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖

# 2024-01-29 Ver:9.7.0.0

更新内容：

  • sdk内部登录方式更新优化
  • 一些依赖库的引入方式优化

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 删除工程 libs/weiboSDKCore_12.5.0.aar

  • 删除工程 libs/alipaysdk-15.8.03.210428205839.aar

  • 删除工程 libs/wechat-sdk-android-6.8.0.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖

  • 根据文档3.1章节 更新远程依赖库配置

# 2023-11-17 Ver:9.6.0.1

更新内容：

  • 修复在某些模拟器上闪退问题

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖即可

# 2023-11-14 Ver:9.6.0.0

更新内容：

  • 更新三方sdk: 热云 sdk;
  • 内部优化

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖即可

# 2023-11-10 Ver:9.5.0.0

更新内容：

  • 更新三方sdk: 头条，热云，oaid，支付宝sdk;

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 删除工程libs内alipaysdk-15.8.03.210428205839.aar

  • 修改 游戏app 级gradle 依赖的 头条sdk版本 为 6.15.4

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖即可

# 2023-10-17 Ver:9.4.0.0

更新内容：

  • 更新微博，微信，QQ三方sdk;

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 删除工程libs内weiboSDKCore_12.5.0.aar

  • 删除工程libs内wechat-sdk-android-6.8.0.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖即可

# 2023-07-25 Ver:9.3.1.0

更新内容：

  • 更新一部分第三方SDK;

  • 优化ghome sdk内的部分提示语的结束标点符号;

  • 短信& 静态密码登录页增加版本号显示;

更新方式：

  • 删除工程libs内tkdna_v1.0.1.aar，MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖即可

# 2023-06-14 Ver:9.3.0.0

更新内容：

  • sdk内部分功能代码优化兼容targetVersion 31+;

更新方式：

  • 删除工程libs内MY_GHOME_SDK_vXXX_XXXX.aar

  • 把sdk zip包内的所有aar资源拷贝进libs更新覆盖即可

# 2023-02-01 Ver:9.1.0.0

更新内容：

  • sdk接入形式优化，游戏无需再分别拷贝libs,res 各类资源，只需把所有aar文件放入游戏libs目录，并添加部分库在线依赖即可（具体请阅读最新接入文档）
  • 游戏需要增加一个oaid的相关证书文件的放入到assets文件夹下的操作（具体请阅读最新接入文档）
  • 注意获取隐私协议相关接口的接入变更操作。具体请阅读接入文档 第13节-获取用户条款和隐私政策
  • 部分代码优化

更新方式：

  • 删除工程res/ 下各类gl开头的ghome相关资源

  • 删除assets内 ghome相关的资源

  • 删除工程libs 下 各个cpu架构下ghome 相关的so库，

  • 删除AndroidManifest.xml内 添加的无需配置参数的activity 等配置项，具体可参考demo 内的配置

  • 把sdk zip包内的所有aar资源拷贝进libs即可

Last Updated: 2024/11/29 09:30:04