游戏角色数据上报
业务场景
用户角色在创角、登录、升级、退出的时候，CP 需要调用本接口上报角色数据
流程图
无
接口介绍
public void ReportGameInfo(GameInfo info)
调用示例
private void reportGameInfo()
{
GameInfo info = new GameInfo();
info.eventType = 1;
info.extend = "xxxxx";
info.roleInfo = getRoleInfo();
SDKManager.GetInstance().ReportGameInfo(info);
}
private RoleInfo getRoleInfo()
{
RoleInfo info = new RoleInfo();
info.serverName = "serverName";
info.serverId = "serverId";
info.roleId = "roleId";
info.roleName = "roleName";
info.roleLevel = "roleLevel";
info.roleVipLevel = "roleVipLevel";
// 创角需要填
info.roleCreateTime = "";
return info;
}
参数说明
入参：GameInfo info
| 参数名称 | 类型 | 说明 | 必传/可选 |
|---|---|---|---|
| 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 | 游戏资源版本号，默认传"" | 可选 |
错误码
无