游戏角色数据上报
业务场景
该接口会将游戏角色数据上报到SDK端
注意事项
- 新角色创建时，需要先上报角色创建、再上报角色登录
- 需要在登录成功后调用
流程图
无
接口介绍
/**
* 上报游戏/角色事件和信息
*
* @param gameInfo 游戏信息
*/
- (void)reportGameInfo:(GameInfo *)gameInfo;
调用示例
RoleInfo *roleInfo = [[RoleInfo alloc] init];
roleInfo.serverId = @"99"; // 游戏区服ID
roleInfo.serverName = @"测试1服"; // 游戏区服名称
roleInfo.roleId = @"101"; // 角色ID
roleInfo.roleName = @"只好简化"; // 角色名称
roleInfo.roleLevel = @"66"; // 角色等级
roleInfo.combatValue = @""; // 角色战力
roleInfo.roleVipLevel = @""; // 角色vip等级
roleInfo.roleCreateTime = @""; // 角色创建时间
roleInfo.properties = @""; // 角色资产
roleInfo.gameResVersion = @""; // 游戏资源版本
GameInfo *gameInfo = [[GameInfo alloc] init];
gameInfo.eventType = EVENT_TYPE_ROLE_LOGIN; //1-登录角色 2-创建角色 3-角色升级 4-角色退出 99-审核状态 101-完成新手引导
gameInfo.roleInfo = roleInfo; // 角色信息
gameInfo.extend = @""; // 扩展字段
[SDKManager.getInstance reportGameInfo:gameInfo];
参数说明
【入参】 GameInfo:
| 参数名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| eventType | NSInteger | 事件类型(见下表: GameInfo.EventType) | 必传 |
| roleInfo | RoleInfo | 角色相关信息(见下表: RoleInfo) | 必传 |
| extend | NSString | 扩展字段, 可传入未定义的字段, 建议使用json格式, 如无则传空字符串"" | 可选 |
GameInfo.EventType:
| 事件类型 | 字段名称 | 值(NSInteger) | 说明 | 备注 |
|---|---|---|---|---|
| 角色登录 | 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:
| 参数名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| serverId | NSString | 游戏区服Id | 必传 |
| serverName | NSString | 游戏区服名称 | 必传 |
| roleId | NSString | 角色Id | 必传 |
| roleName | NSString | 角色名称 | 必传 |
| roleLevel | NSString | 角色等级 | 必传 |
| roleVipLevel | NSString | 角色vip等级，默认传"" | 可选 |
| roleCreateTime | NSString | 角色创建时间 | 可选 |
| properties | NSString | 角色资产（例如：金币，钻石），默认传"" | 可选 |
| combatValue | NSString | 角色战力，默认传"" | 可选 |
| gameResVersion | NSString | 游戏资源版本号，默认传"" | 可选 |
- 注意事项
- 需在SDK登录成功后调用
错误码
无
FAQ
无