Unity专用SDK(PC、网页端) / 通过应用程序启动器进行认证
  返回文档

Unity专用SDK(PC、网页端)

通过应用程序启动器进行认证

如果使用艾克索拉启动器或Steam向用户交付应用程序,可以使用启动器的凭证自动认证用户身份。

详解

通过方法详解文档了解高级设置。

如何设置通过启动器认证进入应用程序

您可以使用艾克索拉启动器向用户交付应用程序及其更新。启动器包含一个内置的授权工具。如要避免重复输入用户名和密码的需要,可设置通过启动器授权进入应用程序。

注意
要使用启动器,需配置登录管理器。不支持使用其他授权系统。

设置SDK与启动器配合工作

  1. 在您的发布商帐户中设置启动器
注:
config.json文件中,请更改以下对象的值:
  • launcher_project_id — 指定在发布商帐户 > 启动器 > 常规设置 > 常规信息中找到的启动器ID
  • login_project_id — 指定发布商帐户 > 启动器 > 常规设置 > 验证中找到的登录管理器ID
  1. 自定义启动器UI
注意
通过艾克索拉服务器进行SDK集成使用IGS & BB API调用,因此不支持启动器商店。
  1. 在您的应用程序中实现启动器授权逻辑
  2. 生成启动器安装文件和编译版本压缩包
  3. 创建应用程序编译版本
  4. 将应用程序编译版本上传至艾克索拉更新服务器

实现通过启动器进行身份认证的逻辑

通过启动器在应用程序中进行授权的过程如下:

  1. 用户授权进入启动器。
  2. 用户安装并运行应用程序。
  3. 启动器运行该应用程序并通过命令行传入用户参数。授权令牌在xsolla-login-token参数中传递。
  4. 应用程序处理命令行参数并获取令牌。您可在演示项目中查看令牌处理脚本示例。
  5. 应用程序验证收到的令牌。您可在演示项目中查看令牌验证脚本示例。
  6. 应用程序在不显示授权页面的情况下自动完成用户授权。您可在演示项目中查看用户授权脚本

注:
获得的令牌用于供SDK方法打开游戏内商店、进行支付等。请将令牌传入Token.Instance属性。

创建应用程序编译版本

  1. 前往您的Unity项目。
  2. 在主菜单中单击Window > Xsolla > Edit Settings。在Inspector面板中:
    1. Project ID字段中指定在发布商帐户 > 项目设置 > 项目ID中找到的项目ID。
    2. Login ID字段中指定在发布商帐户 > 启动器 > 常规设置 > 验证中找到的登录管理器ID。
  1. 运行授权场景,令牌在其中得到处理。
  2. 在主菜单中单击File > Build settings,然后单击Add Open Scenes。确保授权场景添加为列表首项。
  3. 单击Build
  4. 在弹出窗口中指定放置所得编译版本的目录路径。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
隐藏

如何设置通过Steam进行本机用户认证

注意
如在您的Unity项目中使用了演示项目,请参阅本详解指南。

本机用户认证可让玩家通过其所装的Steam应用程序进入您的应用程序。

要设置本机用户认证:

  1. 在发布商帐户中设置通过Steam进行静默认证
  2. 配置您的Unity项目
  3. 配置事件处理
  4. 确保通过Steam进行认证

配置您的Unity项目

  1. 创建一个steam_appid.txt文件并在其中输入您在Steam中的应用ID。然后将该文件放在项目的Assets/Plugins/Steamworks.NET/redist/目录中。
注:
如果是从GitHub下载的SDK,则可在Assets/Plugins/Steamworks.NET/redist/目录中找到该steam_appid.txt文件。该文件包含一个演示项目的Steam应用ID。
  1. 打开您的Unity项目。
  2. 在主菜单中,前往Window > Xsolla > Demo Settings
  3. Inspector面板:
    1. 勾选Use Steam authorization复选框。
    2. Steam App ID字段中,指定您在Steam中的应用ID。该值应与steam_appid.txt文件中的值相同。

配置事件处理

要通过Steam认证用户,应向SilentAuth方法传入session ticket。示例见演示项目SteamAuth.cs类。

确保通过Steam进行认证

  1. 创建适用于独立平台的Unity项目的编译文件或启动一个场景。
  2. 启动Steam并登录。
  3. 启动您的应用程序。如果一切正确,将自动登入应用程序。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
隐藏
上次更新时间: 2023年10月10日

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

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