角色相关

WARNING

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

提交角色信息

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

var roleData = {
    type: 1,
    serverID: '1',
    serverName: 'H5演示服务器',
    roleID: '100',
    roleName: '角色_&#@!%^_+·~|{}[]',
    roleLevel: '1',
    vip: '1',
    moneyNum: 0,
    createTime: parseInt("" + new Date().getTime()/1000),
    lastLevelUpTime: parseInt("" + new Date().getTime()/1000)
};

window.XSDKApi.submit(roleData, function(result) {

    if (result && result.code == 0) {
        console.log('role submit success')
    } else {
        console.log('role submit failed')
    }

});

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

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

roleData结构说明：

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

补充说明

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

功能	依赖时机	说明
内置埋点	创角/进入游戏/等级升级	SDK的内置埋点
后台角色查询/统计	创建角色/进入游戏	SDK后台提供了角色查询等功能，该功能依赖客户端的角色上报接口

角色相关 ​

提交角色信息 ​

补充说明 ​

角色相关

提交角色信息

补充说明