Unity专用企业级SDK / 通过发布平台进行静默认证
  返回文档

Unity专用企业级SDK

通过发布平台进行静默认证

静默认证允许用户无需重复输入凭证即可登录应用程序。使用这种认证方式时,艾克索拉登录管理器通过用户在应用程序发布平台上提供的凭证进行认证。

注:
静默认证目前支持Steam、Xbox Live和Epic Games平台。如需支持Stone或Mail.ru平台,请联系您的客户成功经理或发送邮件至csm@xsolla.com
要实现通过发布平台静默认证:
  1. 在平台开发者帐户中设置应用程序。
  2. 在发布商帐户中设置静默认证
  3. 在您的应用程序侧完成集成步骤

设置静默认证

在登录管理器产品中,有两种方式可启用静默认证:

注:
对于创建允许用户使用同一帐户在不同平台上进行游戏、跨平台同步物品库等的跨平台帐户,影子登录管理器项目为必需。会为每个托管游戏并因此与用户主帐户关联的发布平台创建一个影子登录管理器项目。详细信息请参阅跨平台帐户

在经典登录方案中,您可以一次性为多个发布平台启用静默认证,但不能创建跨平台帐户。如果用户在一个平台上登录游戏后又在另一个平台上登录了游戏,登录管理器项目会将这两次登录视作两个不同的用户。
要在经典登录方案中启用静默认证:
  1. 发布商帐户中打开您的项目,然后前往登录管理器部分。
  2. 在经典登录方案面板中单击配置
  3. 前往身份认证区块,然后选择发布平台部分。
  1. 要连接发布平台,请单击平台名称旁边的⚙图标,然后选择设置
  1. 在模态窗口中,指定所选平台的参数:
    • Steam:
      • 应用程序ID — 您在该平台帐户中的AppID;
      • 应用程序密钥Web API Key
    • Epic Games:
      • 应用程序ID — 您游戏客户端在该平台上的Client ID;
      • 应用程序密钥 — 您游戏客户端在该平台上的密钥。
    • Xbox Live:
      • 应用程序ID — 您游戏在该平台上的Application ID/Client ID;
      • 应用程序密钥 — 您游戏在该平台上注册时生成的Application Secret。
注:
对于Xbox Live平台可以不必提供设置值。您可以使用艾克索拉拥有的访问密钥来连接Xbox Live,方法是单击平台名称右侧的⚙图标,然后选择连接
  1. 单击连接
  2. 如需要,对其他发布平台重复步骤4 – 6。

在应用程序侧进行集成

  1. 将发布平台SDK集成到您的应用程序。
  2. 实现获取会话票证的逻辑:

    • 对于Steam,获取会话票证
    • 对于Xbox Live,在用户认证后根据平台数据生成会话票证。参数根据<xid>-<uhs>;<XSTSToken>的格式生成,其中:
      • <xid> — Xbox用户ID
      • <uhs> — 用户散列
      • <XSTSToken> — Xbox安全令牌服务
    • 对于Epic Games,从平台获取授权码(exchange code),该码在用户认证后生成,用作会话票证。

  1. 使用SDK方法实现用户认证逻辑:
    • SilentAuth — 用来自平台的会话票证交换JSON Web令牌(JWT)并认证用户的身份。
    • OAuthLogout — 结束活动用户会话。
SDK参考文档
了解SDK方法及其参数的详细信息。
注:
演示项目中实现了通过Steam进行静默认证。您可以使用SteamAuth.cs作为范例。如使用演示项目作为用户认证系统的基础,可按照如何设置通过Steam进行本机用户认证指南来设置通过Steam进行静默认证。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。

有用链接

上次更新时间: 2024年1月22日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!