鉴权登录

发布于:2024-10-18


更新时间
更新内容
对应SDK版本
定位
2022-11-17
  • 登录异步回调接口
V1.0.3
2022-09-29
登录鉴权模块
V1.0.0

1. 蓝图中登录

1.1 蓝图登录逻辑说明

  • 用户第一次登录,通过蓝图接口来输入账户和密码。
  • 登录成功,会将账户加密后保存,下一次程序启动时自动登录。
  • 登录失败,会返回登录错误原因。
  • 自动登录:
  • 每次启动程序后,如果检测到本地电脑上保存有账户信息后,自动触发登录验证。
  • 退出登录,解除绑定:
  • 提供蓝图方法退出当前登录账号。
  • 退出后账号和当前机器解绑,可用于其他机器登录。

1.2 蓝图方法

  1. 登录
  • Style3DAccountLogin: 用来输入账户密码,并返回登录后的结果。
  • Username:账户名
  • Password:密码
  • Force Sign in:强制登陆,可在当前机器上强制登陆,之前登陆的机器将下线
  • LoginFinished: 登录结束后的回调事件。返回值如下:
  • Success: 登录是否成功
    • ErrorType:登录失败时,返回对应的错误码。
    • ErrorMessage:登录失败时,返回对应的错误原因。
  • IsStyle3DLogin: 用来检测当前账户是否已经登录成功。
打shipping包时,有时出现beginplay延迟登录不成功的现象,需要设置手动触发登录的逻辑

✅2. 登录异步回调接口

应用场景
打包成应用后,每次重启应用,系统会主动自动登陆。这样不需要每次都弹出登陆窗口,让用户输入账号密码
通过 Style3D Bind Auto Login Event的回调事件,可以监听自动登陆是否成功
  • 登陆成功,则直接进入应用中体验
  • 登陆失败的情况下,再连接到手动登陆的流程,也就是上面的Style3D Account Login节点
  1. 退出登录
  • Style3DAccountLogout: 用来退出登录,解除账号绑定。
  • FinishedEvent: 退出登录结束后的回调事件。返回值如下:
Success: 退出登录是否成功
Message:退出登录返回的消息。

2. 日志查看

  • 编辑器中和蓝图中查看登录相关日志的方法相同,都是在日志中过滤 LogStyle3DNetwork 字段,如下:
LogStyle3DNetwork: syncPost-url = https://api.style3d.com/account/auth/login
LogStyle3DNetwork: Login Success!
LogStyle3DNetwork: clientId:= D7525BC3-B38B-D15F-9938-5811229D466E-DESKTOP-4DIUC8B-
LogStyle3DNetwork: syncPost-postData: key = client_id value = D7525BC3-B38B-D15F-9938-5811229D466E-DESKTOP-4DIUC8B-
LogStyle3DNetwork: syncPost-postData: key = code value = 
LogStyle3DNetwork: syncPost-postData: key = version value = 4.8.405
LogStyle3DNetwork: syncPost-postData: key = category value = style3dClient
LogStyle3DNetwork: syncPost-postData: key = environment value = windows
LogStyle3DNetwork: syncPost-url = https://api.style3d.com/setting/software/user_init_info
LogStyle3DNetwork: GetUserInfo call back:= {"state":true,"message":"","data":{"user_info":{"id":47649,"name":"pangqibo","introduction":"庞启波","tel":"","email":"pangqibo@linctex.com","avatar":{"id":"","name":"","path":"","version":""},"roles":["product_supplier","product_buyer","fabric_supplier","fabric_buyer","accessory_supplier","accessory_buyer"],"created_a
LogStyle3DNetwork: Get user info success!

3. 错误码对照

  • 6000 未授权
  • 6002 授权码过期
  • 6003 授权码属于其他企业
  • 6004 授权码属于本企业其他用户
  • 6005 授权码未通过审核
  • 6001 6006 返回了其他设备ID
  • 6007 存在其他设备登录
  • 6008 当前设备不能重复试用
  • 6009 当前渠道包已停用

4. 第三方账号与style3D账号关联

客户端主程序中用户使用主程序账号,不直接使用style3D账号,由主程序实现调用Style3D账号进行鉴权登录操作。
联系凌迪工作人员批量开通style3D账号

提交反馈