游戏角色数据上报
业务场景
用户角色在创角、登录、升级、退出的时候，CP 需要调用本接口上报角色数据
流程图
无
接口介绍
SDKManager.reportGameInfo(GameInfo info)
调用示例
var info = {
eventType: 1, //数据类型 1=角色登录，2=创建角色，3=角色升级，4=角色退出
roleInfo: {
serverId: '100', //登录所属的服务器Id
serverName: '100', //登录所属的服务器名称
roleId: '100', //角色Id
roleName: '100', //角色名称
roleLevel: '100', //角色等级
roleVipLevel: '100', //角色VIP等级
roleCreateTime: '2022/10/28', //角色创建时间
properties: '100', //角色资产, 如钻石、金币等
combatValue: '100', //角色战力
gameResVersion: '1.0.0', //游戏资源版本
roleCurrency: 10,
},
extend: '20221028',
};
SDKManager.reportGameInfo(info);
参数说明
入参：GameInfo info
| 参数名称 | 类型 | 说明 | 必传/可选 |
|---|---|---|---|
| eventType | Number | 事件类型(见下表: GameInfo.EventType) | 必传 |
| roleInfo | RoleInfo | 角色相关信息(见下表: RoleInfo) | 必传 |
| extend | String | 扩展字段, 可传入未定义的字段, 建议使用 json 格式, 如无则传空字符串 | 可选 |
GameInfo.EventType:
| 事件类型 | 值(Number) | 说明 | 必传/可选 |
|---|---|---|---|
| 角色登录 | 1 | 角色登录时上报 | 必传 |
| 角色创建 | 2 | 创建角色时上报 | 必传 |
| 角色升级 | 3 | 角色升级时上报 | 必传 |
| 角色退出 | 4 | 角色退出时上报 | 必传 |
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 | 游戏资源版本号，默认传"" | 可选 |
错误码
无