游戏角色数据上报
业务场景
该接口会将游戏角色数据上报到 SDK 端
注意事项
- 当用户创建角色并使用该角色进入游戏时，这是两个事件， 因此应该上报角色创建事件和角色登录事件，而不应该只上报角色创建事件。
- 需要在初始化成功后调用
流程图
无
接口介绍
/**
* 上报游戏/角色事件和信息
*
* @param activity Android上下文
* @param info 游戏信息
*/
void reportGameInfo(Activity activity, GameInfo info);
调用示例
GameInfo gameInfo = new GameInfo();
gameInfo.setEventType(GameInfo.EVENT_TYPE_ROLE_LOGIN); // 事件类型, 必传
gameInfo.setExtend("扩展参数json"); // 扩展参数, 可选
gameInfo.setRoleInfo(getRoleInfo()); // 角色信息, 必传
SDKManager.getInstance().reportGameInfo(this, gameInfo)
...
private RoleInfo getRoleInfo() {
RoleInfo info = new RoleInfo();
info.setServerId("99");// 游戏区服ID，需与服务端支付签名时的serverId一致
info.setServerName("测试1服"); // 游戏区服名称
info.setRoleId("101"); // 角色ID
info.setRoleName("角色名称"); // 角色名称
info.setRoleLevel("66"); // 角色等级
info.setRoleVipLevel("3"); // 角色vip等级
info.setRoleCreateTime(""); // 角色创建时间
info.setGameResVersion(""); // 游戏资源版本
info.setProperties(""); // 角色资产
info.setCombatValue(""); // 角色战力
return info;
}
参数说明
【入参】 GameInfo:
| 参数名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| eventType | int | 事件类型(见下表: GameInfo.EventType) | 必传 |
| roleInfo | RoleInfo | 角色相关信息(见下表: RoleInfo) | 必传 |
| extend | String | 扩展字段, 可传入未定义的字段, 建议使用 json 格式, 如无则传空字符串"" | 可选 |
GameInfo.EventType:
| 事件类型 | 字段名称 | 值(int) | 说明 | 备注 |
|---|---|---|---|---|
| 角色登录 | EVENT_TYPE_ROLE_LOGIN | 1 | 角色登录时上报 | 必传 |
| 角色创建 | EVENT_TYPE_ROLE_CREATE | 2 | 创建角色时上报 | 必传 |
| 角色升级 | EVENT_TYPE_ROLE_LEVEL_UP | 3 | 角色升级时上报 | 必传 |
| 角色退出 | EVENT_TYPE_ROLE_EXIT | 4 | 角色退出时上报 | 必传 |
| 角色行为 | EVENT_TYPE_ROLE_AUDIT | 99 | 审核服统一使用该状态上报 | 可选 |
| 新手流程 | EVENT_TYPE_TUTORIAL_FINISHED | 101 | 完成新手流程 | 可选 |
RoleInfo roleInfo
| 参数名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| serverId | String | 游戏区服 Id | 必传 |
| serverName | String | 游戏区服名称 | 必传 |
| roleId | String | 角色 Id | 必传 |
| roleName | String | 角色名称 | 必传 |
| roleLevel | String | 角色等级 | 必传 |
| roleVipLevel | String | 角色 vip 等级，默认传"" | 可选 |
| roleCreateTime | String | 角色创建时间 | 可选 |
| properties | String | 角色资产（例如：金币，钻石），默认传"" | 可选 |
| combatValue | String | 角色战力，默认传"" | 可选 |
| gameResVersion | String | 游戏资源版本号，默认传"" | 可选 |
- 注意事项
- 需在 SDK 初始化成功后调用
错误码
无