角色相关

WARNING

角色上报接口，请注意调用时机。在创角成功、进入游戏等时机，一定要调用。另不要多次重复调用，否则影响数据的统计。

提交角色信息

当玩家创建角色成功、进入游戏内、角色等级升级时，需要调用角色上报接口。每次调用，角色对象中的必选参数都需要全部设置。

objc

UG_GameRole* role = [[UG_GameRole alloc] init];
role.opType = UG_OP_ENTER_GAME;     //调用时机
role.roleID = @"1";                 //角色ID
role.roleName = @"role_test_1";     //角色名称
role.roleLevel = @"1";              //角色等级
role.serverID = @"1";               //服务器ID
role.serverName = @"server_1";      //服务器名称
role.vip = @"1";                    //VIP等级
role.createTime = 0L;               //角色创建时间，Unix时间戳 秒
role.lastLevelUpTime = 0L;          //角色升级时间, Unix时间戳 秒

[[UGSDKPlatform sharedInstance] submitGameData:role];

dataType主要有如下几种调用时机：

调用时机	dataType值
创建角色成功	1
进入游戏内	2
角色等级升级后	3
玩家点击退出游戏（可选）	4

也就是在创建角色的时候，dataType为1；进入游戏时，dataType为2；等级提升时，dataType为3；退出游戏时，dataType为4。

URoleData数据结构:

参数名称	参数类型	参数说明
dataType	int	调用时机
serverID	String	玩家所在服务器的ID
serverName	String	玩家所在服务器的名称
roleID	String	玩家角色ID
roleName	String	玩家角色名称
roleLevel	String	玩家角色等级
moneyNum	String	当前角色身上拥有的游戏币数量
createTime	long	角色创建时间，从1970年到现在的时间，单位秒,必须传入真实的数据，否则UC审核不过
lastLevelUpTime	long	角色等级变化时间，从1970年到现在的时间，单位秒
vip	String	玩家VIP等级
extraData	String	附加数据，可以不传

补充说明

为了最小化接口调用， SDK内部的一些功能逻辑，会依赖角色上报接口。依赖的功能见下表：

功能	依赖时机	说明
内置埋点	创角/进入游戏/等级升级	SDK的内置埋点
后台角色查询/统计	创建角色/进入游戏	SDK后台提供了角色查询等功能，该功能依赖客户端的角色上报接口
AppStore自动补单	进入游戏	AppStore支付会在进入游戏时机，触发丢单检查，如果有丢单，会尝试自动补单

角色相关 ​

提交角色信息 ​

补充说明 ​

角色相关

提交角色信息

补充说明