谷歌游戏相关功能接入说明

谷歌游戏相关功能接入说明

文档说明

此文档主要是用于在游戏及应用开发商需要接入海外SDK各地区特殊功能时的补充文档。

**请各位根据接入的地区查看需要的接口使用。

1.1 阅读对象

接入海外SDK的游戏及应用的android客户端开发者。

1.2 功能回调

因为此文档内接口回调接口为一个，根据接口内ID区分，所以建议在初始化就注册回调，回调接口使用在每个接口内有具体说明。

 MIDBaseSDK.getInstance(this).MIDBaseSDKSetExtendListener(mBaseExtendListener);

1.3 功能说明

谷歌游戏解锁成就、打开成就弹窗、打开排行榜弹窗、增加排行榜积分功能

1.4 解锁谷歌成就

解锁成就，谷歌成就key在谷歌后台获取。样式举例:”CgkIopmSrtYdEAIQAw”

1.4.1 接口定义


/**
* @param value0 解锁成就固定值
* @param value1 谷歌成就key
*/
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend("GLoginMethodName_Unlock", "CgkIr-GG-IwUEAIQAg");

1.4.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID
Value1	必传	String	谷歌成就key

1.4.3 谷歌成就回调说明

extendListener 接口说明

参数	类型	说明
id	String	解锁成就固定值”GLoginMethodName_Unlock”
values	String数组	values[0] == “0” 解锁成功， values[0] != “0” 解锁失败

// 设置扩展功能回调
MIDBaseSDK.getInstance(this).MIDBaseSDKSetExtendListener(mBaseExtendListener);
/**
* 扩展功能回调
* @param id  功能接口id
* @param values 返回数据
*              values[0] == "0"  解锁成功
*              values[0] !=  "0"  解锁失败
*/
   private MIDBaseExtendListener mBaseExtendListener = new MIDBaseExtendListener() {
        @Override
        public void extendListener(String id, String... values) {
            Logs.i(LOGTAG, "  id:" + id + "  strings[0]:" + values[0]);
            if (id.equals("GLoginMethodName_Unlock")) {
                if (values[0].equals("0")) {
                    Toast.makeText(LTBase_Demo_GoogleGame.this, "解锁成就完成", Toast.LENGTH_SHORT).show();
                } else {
                    Toast.makeText(LTBase_Demo_GoogleGame.this, "解锁成就失败", Toast.LENGTH_SHORT).show();
                }
            }
        }
    };

1.5 成就进度累加

针对有进度的成就系统，累加成就进度。
设置的进度为累加的。
谷歌成就key在谷歌后台获取。样式举例:”CgkIopmSrtYdEAIQAw”

1.5.1 接口定义


/**
* @param value0 解锁成就固定值
* @param value1 谷歌成就key
* @param value1 本次需要增加的进度
*/
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend("GLoginMethodName_Increment", "CgkIr-GG-IwUEAIQAg"，"10");

1.5.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID
Value1	必传	String	谷歌成就key
Value2	必传	String	本次需要增加的进度字符串串类型的数字

1.5.3 谷歌成就回调说明

extendListener 接口说明

参数	类型	说明
id	String	解锁成就固定值”incrementEvent”
values	String数组	values[0] == “0” 解锁成功， values[0] != “0” 解锁失败

// 设置扩展功能回调
MIDBaseSDK.getInstance(this).MIDBaseSDKSetExtendListener(mBaseExtendListener);
/**
* 扩展功能回调
* @param id  功能接口id
* @param values 返回数据
*              values[0] == "0"  解锁成功
*              values[0] !=  "0"  解锁失败
*/
   private MIDBaseExtendListener mBaseExtendListener = new MIDBaseExtendListener() {
        @Override
        public void extendListener(String id, String... values) {
            Logs.i(LOGTAG, "  id:" + id + "  strings[0]:" + values[0]);
            if (id.equals("incrementEvent")) {
                if (values[0].equals("0")) {
                    Toast.makeText(LTBase_Demo_GoogleGame.this, "累加成就完成", Toast.LENGTH_SHORT).show();
                } else {
                    Toast.makeText(LTBase_Demo_GoogleGame.this, "累加成就失败", Toast.LENGTH_SHORT).show();
                }
            }
        }
    };

1.6 打开成就页面

打开成就弹窗

1.6.1 接口定义


/**
* @param value0 打开成就固定值
*/
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend("GLoginMethodName_showAchievements");

1.6.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID

1.7 打开排行榜页面

打开排行榜弹窗

1.7.1 接口定义


/**
* @param value0 打开排行榜固定值
* @param value1 排行榜ID
*/
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend("GLoginMethodName_showLeaderboards", "谷歌游戏后台申请的排行榜id");

1.7.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID
Value1	必传	String	排行榜id

1.8 设置指定排行榜积分

设置指定排行的积分功能。
是修改积分，不是增加.
排行榜积分只能是数字，不带小数点。运营可以在谷歌后台设置积分到小数点后几位。
举例说明：
运营在谷歌后台设置小数点后扩展到4位。游戏想为玩家排行积分设置为：100.0001 需要传入 1000001 中间小数点由谷歌自定添加。

1.8.1 接口定义


/**
* @param value0 修改排行榜接口id
* @param value1 排行榜ID
* @param value2 排行榜积分（只能是数字）
*/
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend("GLoginMethodName_submitScore", "谷歌游戏后台申请的排行榜id","1000001");

1.8.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID
Value1	必传	String	排行榜id
Value2	必传	String	排行积分

1.9 游戏事件，累加事件进度，用于GooglePlay活动

累加指定活动的进度/积分。
对应文档 https://developer.android.com/games/pgs/android/events
eventId 在 Play Console 定义事件时生成。

1.9.1 接口定义


/**
* @param value0 固定值
* @param value1 谷歌游戏后台申请的活动事件id
* @param value2 活动的进度/积分
*/
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend("GLoginMethodName_incrementEvent", "谷歌游戏后台申请的活动事件id","1000001");

1.9.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID 固定值
Value1	必传	String	谷歌游戏后台申请的活动事件id
Value2	必传	String	活动的进度/积分

1.10 上报自定义游戏事件，用于GooglePlay 数据统计

游戏需要根据运营在谷歌后台配置的事件信息，和运营沟通好上报的事件key 和事件值类型。
对应文档 https://developer.android.com/games/pgs/gamestats
用于把游戏内自定义事件（可带属性）上报给 Google 做统计分析。属性 JSON 的值类型自动识别（boolean / 整数 / 小数 / 字符串）。

1.10.1 接口定义

举例 登录事件
/**
* @param value0 固定值
* @param value1 活动名称- 运营配置到谷歌后台的名称
* @param value2 事件属性 - 运营配置到谷歌后台的属性要求
*/
String eventName = "login";
String properties = "{\"userid\":\"user123\",\"username\":\"Player_ABC\"}";
MIDBaseSDK.getInstance(this).MIDBaseSDKChannelExtend(
                "GLoginMethodName_recordGameEvent", eventName, properties);

1.10.2 参数说明

参数名称	重要性	类型	说明
Value0	必传	String	接口ID 固定值
Value1	必传	String	活动名称- 运营配置到谷歌后台的名称
Value2	必传	String	事件属性 - 运营配置到谷歌后台的属性要求

Table of Contents