登录回调信息(AuthResult)
数据结构
警告
业务如需使用 FirstLogin 字段判断是否为新用户。则业务在清档的时候,也需要提醒 Player Network SDK 方清除相关的数据。
FINTLAuthResult:继承自 FINTLBaseResult,包含了登录信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| OpenID | FString | Player Network SDK 用户唯一标识 |
| Token | FString | Player Network SDK 用户 token |
| TokenExpire | int64 | token 过期时间戳 例如,1600844518 |
| FirstLogin | int32 | 是否首次登录 未知:-1 否:0 是:1 |
| UserName | FString | 昵称 |
| Gender | int32 | 性别 0:未定义 1:男 2:女 |
| Birthdate | FString | 返回为空,因合规要求不允许采集玩家出生年月日 |
| PictureUrl | FString | 头像链接 |
| Pf | FString | pf 值 用于 Midas 支付 |
| Pfkey | FString | pf key 用于 Midas 支付 |
| NeedRealNameAuth | bool | 是否需要实名认证 |
| ChannelID | int32 | 渠道号 |
| ChannelName | EINTLLoginChannel | 渠道名 |
| ChannelInfo | FString | 第三方渠道登录信息 JSON 数据,不同渠道取值不同 |
| BindList | FString | 绑定信息 JSON 数据,数组类型 |
| LegalDocumentsAcceptedVersion | FString | 法务文件版本信息 |
| DeleteAccountStatus | int32 | 删号状态信息 更多信息,请参见 DeleteAccountStatus。 |
| DeleteAccountInfo | String | 如果需要 `DeleteAccountInfo',请联系 Player Network 助手 注销账号信息,JSON 数据。 更多信息,请参见 DeleteAccountInfo。 |
| TransferCode | FString | 特殊地区游客引继码 |
| TransferCodeExpireTime | int32 | 特殊地区游客引继码过期时间 |
| DeleteLIAccountStatus | int | LEVEL INFINITE PASS 账号注销状态 更多信息,请参见 DeleteLIAccountStatus。 |
| string | 邮件地址 |
其中 FINTLAuthResult 里的 ExtraJson 中包含了后台查询到的用户的协议版本和合规状态的 JSON 字符串。
DeleteAccountStatus
警告
需要返回 DeleteAccountStatus 的业务请联系 Player Network 助手进行配置,否则 DeleteAccountStatus 会返回 -1。
| 值 | 说明 | 备注 |
|---|---|---|
| 0 | 没有进行删号或者删号已取消 | 允许玩家进入游戏 |
| 1 | 删号静默期 | 阻拦玩家登录,提示玩家选择是否要撤回删号进入游戏 |
| 2 | 删号完成 | 不允许玩家进入游戏 |
| 3 | 正在删号 | 不允许玩家进入游戏 |
| 4 | 删号失败 | 不允许玩家进入游戏 |
| -1 | 后台没有返回删号状态 | 建议允许玩家进入游戏 |
| -2 | 删号状态服务网络异常 | 建议允许玩家进入游戏 |
| -3 | DMCS 响应数据格式不对(JSON 中缺 返回状态或 err_code 字段) | 建议允许玩家进入游戏 |
| -4 | 内部错误(参数验证不正确或配置验证不等于内部授权逻辑) | 建议允许玩家进入游戏 |
| -10 或 -11 | 删号状态服务内部错误 | 建议允许玩家进入游戏 |
| >= 5 | 未定义 | 建议允许玩家进入游戏 |
注意
游戏侧需评估返回值为负数时,如果允许玩家进入是否会对游戏数据有其他影响。
返回值为负数时不允许玩家进入游戏可能会对其他玩家造成影响,因此不建议将此作为删号关键路径。
DeleteAccountInfo
JSON 数据:
{
"ret": 0, // int, 返回代码,0 表示正常。
"err_code": -10, // int,Player Network SDK 的错误代码,游戏不需要注意
"msg": "", // 错误信息,请求成功时为空
"status": 0, // int, 0: 没有记录或账号注销被取消;1: 冷却期;2: 账号注销成功;3: 注销账号;4: 账号注销失败
"created_at": 12345678, // int64, 账号注销请求被创建的时间戳(当状态为 0 时,时间戳为 0)
"target_destroy_at": 12345678, //执行账号注销的时间戳(当状态为 0 时,时间戳为 0)。
"destroy_at": 12345679 // int64,账号实际被删除的时间戳(当状态不是 2 时,时间戳为 0)
}
DeleteLIAccountStatus
| 值 | 说明 |
|---|---|
| -1 | 账号注销状态查询失败或后端没有返回状态 |
| 0 | 没有注销账号记录或删除请求已被撤回 |
| 1 | 要求注销账号 |
| 2 | 账号注销成功 |
| 3 | 注销账号中 |
| 4 | 注销账号失败 |