跳到主要内容

登录回调信息（AuthResult）

数据结构​

警告

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

INTLAuthResult：继承自 INTLBaseResult，包含了登录信息。

名称类型说明
OpenIDstringPlayer Network SDK 用户唯⼀标识
默认为 64-bit 无符号整数的字符串，也可以支持 32-bit
TokenstringPlayer Network SDK 生成的 40 字节用户令牌
TokenExpirelongtoken 过期时间戳
例如，1600844518
FirstLoginint是否首次登录
未知：-1
否：0
是：1
UserNamestring昵称
Genderint性别
0：未定义
1：男
2：女
Birthdatestring出生年月日
例如，1987-02-23
PictureUrlstring头像链接
Pfstringpf 值
用于 Midas 支付
Pfkeystringpf key
用于 Midas 支付
NeedRealNameAuthbool是否需要实名认证
ChannelIDint渠道号
Channelstring渠道名
详情请参见 INTLChannel
ChannelInfostring第三方渠道登录信息
JSON 数据，不同渠道取值不同
BindListstring绑定信息
JSON 数据，数组类型
LegalDocumentsAcceptedVersionstring法务文件版本信息
DeleteAccountStatusint删号状态信息
更多信息，请参见 DeleteAccountStatus。
DeleteAccountInfoString如果需要 `DeleteAccountInfo'，请联系 Player Network 助手
注销账号信息，JSON 数据。
更多信息，请参见 DeleteAccountInfo。
TransferCodestring特殊地区游客引继码
TransferCodeExpireTimelong特殊地区游客引继码过期时间
DeleteLIAccountStatusintLEVEL INFINITE PASS 账号注销状态
更多信息，请参见 DeleteLIAccountStatus。
Emailstring邮件地址

其中 INTLAuthResult 里面的 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",
    "adult_status_map": {},
    "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 代表奥地利

韩国年龄标准​

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

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注销账号失败
最后于 更新