跳到主要内容

登录回调信息(AuthResult)

数据结构

警告

业务如需使用 FirstLogin 字段判断是否为新用户。则业务在清档的时候,也需要提醒 Player Network SDK 方清除相关的数据。

FINTLAuthResult:继承自 FINTLBaseResult,包含了登录信息。

名称类型说明
OpenIDFStringPlayer Network SDK 用户唯一标识
TokenFStringPlayer Network SDK 用户 token
TokenExpireint64token 过期时间戳
例如,1600844518
FirstLoginint32是否首次登录
未知:-1
否:0
是:1
UserNameFString昵称
Genderint32性别
0:未定义
1:男
2:女
BirthdateFString出生年月日
例如,1987-02-23
PictureUrlFString头像链接
PfFStringpf 值
用于 Midas 支付
PfkeyFStringpf key
用于 Midas 支付
NeedRealNameAuthbool是否需要实名认证
ChannelIDint32渠道号
ChannelNameEINTLLoginChannel渠道名
ChannelInfoFString第三方渠道登录信息
JSON 数据,不同渠道取值不同
BindListFString绑定信息
JSON 数据,数组类型
LegalDocumentsAcceptedVersionFString法务文件版本信息
DeleteAccountStatusint32删号状态信息
更多信息,请参见 DeleteAccountStatus
DeleteAccountInfoString如果需要 `DeleteAccountInfo',请联系 Player Network 助手
注销账号信息,JSON 数据。
更多信息,请参见 DeleteAccountInfo
TransferCodeFString特殊地区游客引继码
TransferCodeExpireTimeint32特殊地区游客引继码过期时间
DeleteLIAccountStatusintLEVEL INFINITE PASS 账号注销状态
更多信息,请参见 DeleteLIAccountStatus
Emailstring邮件地址

其中 FINTLAuthResult 里面的 ExtraJson 中包含了后台查询到的用户的 协议版本合规状态 的 JSON 字符串。

协议版本

协议版本的模版字符串为:

"need_notify_rsp": {
"has_bind_li": true,
"is_receive_email": 1,
"is_receive_email_in_night": 0,
"user_agreed_game_dma": "",
"user_agreed_game_pp": "36",
"user_agreed_game_tos": "36",
"user_agreed_li_dt": "",
"user_agreed_li_pp": "1",
"user_agreed_li_tos": "",
"need_notify": false
}
关键参数类型说明
user_agreed_game_tosstring玩家同意的服务条款版本,若未同意则传入空值
user_agreed_game_ppstring玩家同意的隐私协议版本,若未同意则传入空值
user_agreed_li_ppstring玩家同意的 LEVEL INFINITE PASS 隐私协议版本,若未同意则传入空值
user_agreed_li_dtstring玩家同意的数据传输协议版本,若未同意则传入空值
user_agreed_li_tosstring玩家同意的 LEVEL INFINITE PASS 服务条款版本,若未同意则传入空值
is_receive_emailint是否接收营销邮件
is_receive_email_in_nightint是否接收营销邮件(韩国)
need_notifybool是否升级 LI PASS 协议
has_bind_libool当前渠道是否已绑定了 LI PASS

合规状态

未成年认证状态的模版字符串为:

"get_status_rsp": {
"adult_age": 18,
"adult_age_map": "{\"1\":18,\"10\":18,\"11\":18,\"2\":18,\"3\":14,\"4\":14,\"5\":18,\"6\":18,\"7\":18,\"8\":18,\"9\":18}",
"adult_check_status": 1,
"adult_check_status_expiration": "0",
"certificate_type": 0,
"email": "",
"eu_user_agree_status": 0,
"game_grade": 0,
"game_grade_map": "{\"1\":14,\"2\":14,\"5\":14}",
"is_dma": false,
"is_eea": false,
"is_need_li_cert": false,
"msg": "success",
"need_parent_control": 0,
"need_realname_auth": 0,
"parent_certificate_status": 0,
"parent_certificate_status_expiration": "0",
"parent_control_map": {},
"qr_code_ret": 0,
"realname_auth_status": 0,
"region": "344",
"ret": 0,
"ts": "1712112893"
}
关键参数类型描述
adult_check_statusnumber是否已经成年
-1:还未成年
0:还未设置
1:已经成年
adult_check_status_expirationstring未成年状态下次需要认证时间
parent_certificate_statusnumber是否已经通过家长认证
-1:家长拒绝认证
0:家长未进行认证
1:家长通过认证
10:家长认证之中(仅限邮箱认证)
parent_certificate_status_expirationstring家长拒绝认证之后,下次可以认证时间
eu_user_agree_statusnumber欧盟玩家是否同意在非欧盟地区存储数据
-1:拒绝
0:未设置
1:同意
tsstring当前时间戳
adult_agenumber入参国家/地区的成年标准
查询不到使用默认成年标准
game_gradenumber入参国家/地区的游戏分级标准
查询不到使用默认分级标准
adult_age_mapstring韩国的分端成年标准
game_grade_mapstring韩国的分端游戏分级标准
certificate_typenumber入参国家/地区的认证方式
查询不到使用默认认证方式
0:不需要认证
1:自我认证
2:使用信用卡支付认证
3:邮箱认证
regionstringISO 3166-1 国家或地区的数字代码
例如 156 代表中国,040 代表奥地利

韩国年龄标准

由于韩国政府要求分端区分年龄标准,在查询合规状态信息时,需判断当前玩家是否属于韩国地区。因此需要用 AdultAgeMapGameGradeMap 来读取当前设备对应端的年龄标准。

OS
1Android
2iOS
5PC
6Switch
10PS5
11Xbox

例如 PC 端的成年标准为 AdultAgeMap[5],PC 端的游戏分级标准为 GameGradeMap[5]

int adultAgeInPC = AdultAgeMap[5]
int gameGradeInPC = GameGradeMap[5]

DeleteAccountStatus

警告

需要返回 DeleteAccountStatus 的业务请联系 Player Network 助手进行配置,否则 DeleteAccountStatus 会返回 -1。

说明备注
0没有进行删号或者删号已取消允许玩家进入游戏
1删号静默期阻拦用户登录,提示用户选择是否要撤回删号进入游戏
2删号完成不允许玩家进入游戏
3正在删号不允许玩家进入游戏
4删号失败不允许玩家进入游戏
-1后台没有返回删号状态建议允许玩家进入游戏
-2删号状态服务网络异常建议允许玩家进入游戏
-3DMCS 响应数据格式不对(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注销账号失败