supersdk

文档中心

文档中心

下载文档

游族 SDK


游族 SDK 主要为游戏发行国内提供登录功能。

一、手机号绑定

注意:接口调用时机必须在登录成功之后。

返回值 code:1:已绑定手机,0:未绑定,xxx:其他错误,code 没有可忽略。

1、查询绑定状态

接口描述:查询该用户是否已绑定手机,

接口调用:

SuperSDK.invoke("platform", "isBindPhone", null);

接口回调:

// OnSuperSDKListener 监听内 onSuperSDK 方法回调,结果判断和解析
if("platform".equals(moduleName) && "isBindPhone".equals(funcName)) {
    isBindPhone(result);
}

// 这里是处理方法
public void isBindPhone(String result) {
    JSONObject json = JsonUtils.parseObject(result);
    int code = json.getIntValue("code");
    if(1 == code) {
        Log.e("result", "已绑定");
    } else {
        String msg = json.getString("msg");
        Log.e("result", "未绑定: "+msg);
    }
}

日志打印:

moduleName:platform
funcName:isBindPhone
result:
{
    code : 1             // 1/0/xxx ,1 已绑定手机,0 未绑定,xxx 其他错误 code 没有可忽略
    msg  : xxx
}

2、打开绑定手机页面

接口描述:弹出绑定手机页面接口。

接口调用:

// 打开游客绑定
// 不需要回调,参数传 null 即可、以下是需要传参数的方式
Map<String, String> params = new HashMap<String, String>();
params.put("isNeedCallBack", "true"); 
SuperSDK.invoke("platform", "bindPhone", params);

接口回调:

// OnSuperSDKListener 监听内 onSuperSDK 方法回调,结果判断和解析
if("platform".equals(moduleName) && "bindPhone".equals(funcName)) {
    bindPhone(result);
}

// 这里是处理方法
public void bindPhone(String result) {
    JSONObject json = JsonUtils.parseObject(result);
    int code = json.getIntValue("code");
    if(1 == code) {
        Log.e("result", "绑定手机号成功");
    } else {
        String msg = json.getString("msg");
        Log.e("result", "绑定手机号失败: "+msg);
    }
}

日志打印:

moduleName:platform
funcName:bindPhone
result:
{
    code : 1             // 绑定手机号成功/失败 ,xxx 其他错误 code 没有可忽略
    msg  : xxx
}

二、辅助接口

1、游族打开二维码扫描页面

接口描述:打开二维码扫描页面、扫描登录或支付二维码,从而完成相关功能。

接口调用:

SuperSDK.invoke("platform", "scanQRCode", null);

2、福利中心

接口描述:提供游戏自己调用福利中心 web 页面的接口。

接口调用:

SuperSDK.invoke("platform", "showGiftPackCenter", null);

3、设置社区监听

接口描述:如果开启了社区,需设置监听,如游戏需要关闭或恢复游戏声音。

接口调用:

SuperSDK.invoke("platform", "gameSoundListener", null);

接口回调:

// 该接口不会马上回调,当打开社区或者关闭社区时会回调相应的 data 值
// OnSuperSDKListener 监听内 onSuperSDK 方法回调,结果判断和解析
if("platform".equals(moduleName) && "gameSoundListener".equals(funcName)) {
    gameSoundListener(result);
}

// 这里是处理方法
public void gameSoundListener(String result) {
    JSONObject json = JsonUtils.parseObject(result);
    String data = json.getString("data");
    if(data.equals("stopGameSound")) {
        Log.e("result", "游戏需要关闭游戏声音");
    } else if(data.equals("recoverGameSound")){
        Log.e("result", "游戏需要恢复游戏声音");
    }
}

日志打印:

moduleName:platform
funcName:gameSoundListener
result:
{
    code : 1,// 无需判断 code
    msg  : xxx // 游戏需要关闭游戏声音 / 游戏需要恢复游戏声音
    data : "stopGameSound" / "recoverGameSound" // 游戏需要关闭游戏声音 / 游戏需要恢复游戏声音
}

三、TapTap相关

1、唤起 TapTap 检查更新

接口描述:唤起 TapTap 检查更新页面。

接口调用:

SuperSDK.invoke("platform", "tapTapUpdateGame", null);

日志打印:

moduleName:platform
funcName:tapTapUpdateGame
result:
{
    code : 1,// 无需判断 code
    msg  : "onCancelCallback" // 当点击「取消」按钮时取消更新的回调方法才会执行。
}

2、打开 TapTap 游戏评论区

接口描述:打开 TapTap 游戏评论区页面。

注意:只有本地安装了 taptap 社区 app 才可调用,否则无法拉起页面。

接口调用:

SuperSDK.invoke("platform", "openTapTapCommentArea", null);

日志打印:

moduleName:platform
funcName:openTapTapCommentArea
result:
{
    code : 1 / -1,
    msg  : "onOpenSuccess" / "onOpenFailed"
}