Name Last Update
app Loading commit data...
gradle Loading commit data...
.gitignore Loading commit data...
README.md Loading commit data...
build.gradle Loading commit data...
gradle.properties Loading commit data...
gradlew Loading commit data...
gradlew.bat Loading commit data...
settings.gradle Loading commit data...

README.md

UnionSDK for Android接入文档

V6.0.4
2020年03月27日

版本概述

此版本为使用AndroidStudio开发的版本,使用aar的方式提供sdk接入包,并使用gradle在线依赖方式,aar内别并不包含依赖包,请按此文档描述接入.

此SDK适用android api>=16 的系统,编译器jdk8+.

1.依赖导入

配置gradle,以下为必须项

repositories{
    maven{
        url "http://117.50.8.198:8081/nexus/content/repositories/sdk"
    }
}

dependencies {
    implementation 'com.gt.union.sdk:GameSDK:6.0.4'

}

2.向Gump平台索要游戏ID(AppID),完成代码接入

  • ActionCallback为通用的异步回调接口,所有的异步方法都是用此接口做回调. 此接口只有一个回调方法onCallback(String event, Object... payload) 其中参数event为当前回调的事件类型,用于区别不同的方法回调;payload为不同的回调负载,包含回调时需要传输的数据

1.获取SDKAgent对象,并执行初始化配置。

SDKAgent.object(Activity,appId).channel(channelId);   

2.调用SDKAgent的登录方法,将执行登录流程,需要一个Activity实例作参数和一个ActionCallback对象做登录结果接收

sdkAgent.login(Activity,ActionCallback); 

payload[0]为Boolean类型表示登录结果,成功登录后收到payload[1]为SessionKey对象,可以获取以下信息

sessionKey.getUid();//获取用户的userid,此Id标识唯一用户!  
sessionKey.getToken();//当前session的token 
sessionKey.getExpires();//sessionKey的过期时间,类型Date  

3.支付功能

支付分为google play 官方Iab支付和三方支付,情况有两种:1)根据云端配置调用不同的支付方法 2)自行构建逻辑调用不同的支付方法

  • 获取云端配置

sdkAgent.judgePayment(Activity, serverId, roleId, ActionCallback);

payload[0]为boolean类型,true时应使用三方支付,false应使用iab支付

  • 调用Google Play Iab支付
    OrderForm order = new OrderForm()
    .setServerId(serverId)//游戏服id
    .setRoleId(roleId)//角色id
    .setExtraInfo("orderId")//订单号
    .setAmount(0.99f)//金额
    .setCurrency("USD")//货币
    .setProduct("gro.udc.mig.99");//商品id

    sdk.launchIap(MainActivity.this, order,ActionCallback);

payload[0]为boolean类型,标明支付是否完成;payload[1]为错误描述

  • 三方支付
    OrderForm order = new OrderForm()
    .setServerId(serverId)//游戏服id
    .setRoleId(roleId)//角色id
    .setExtraInfo("orderId")//订单号
    .setAmount(0.99f)//金额
    .setCurrency("USD")//货币
    .setProduct("gro.udc.mig.99");//商品id

    sdkAgent.goRecharge(MainActivity.this, order, ActionCallback);

payload[0]为boolean类型,true支付完成,false支付异常

4.注销登录

sdkAgent.logout(ActionCallback);

当此方法调用后,用户退出登录,为了便于用户切换登录账户,请在游戏内提供用户注销的触发按钮