本教程介绍如何使用SDK方法实现以下内容：

• 用户注册
• 重新发送注册验证邮件请求
• 用户登录
• 用户密码重置

源代码

在GitHub上查看这些示例的源代码。

您可以使用用户名或邮箱地址来认证用户身份。以下示例中，我们使用用户的用户名来进行认证，使用邮箱地址来进行注册验证及重置密码。

示例中的逻辑与界面比您在应用程序中的简单得多。演示项目提供了一种可能的认证系统实现方案。

实现用户注册

创建小组件

1. 前往Content Browser并创建UI目录，在快捷菜单中，前往User Interface > Widget Blueprint。
2. 在小组件蓝图中，添加以下界面元素：
   • 用户名字段
   • 用户邮箱地址字段
   • 用户密码字段
   • 注册按钮

下图为页面结构的示例。

3. 打开一个关卡蓝图：
   1. 在Content Browser中选择一个关卡。
   2. 在主菜单中，前往Blueprints > Open Level Blueprint。
4. 实现在关卡启动时显示小组件。在CreateWidget节点中，指定创建的小组件。

添加事件处理

1. 在Hierarchy面板中，选择注册按钮。
2. 在Details面板中，单击On Clicked事件旁边的+图标。

3. 打开Graph视图。
4. 关联XsollaLoginSubsystem对象上的一个RegisterUser方法调用至OnClicked节点，并添加用户输入数据传递。
5. 添加回调函数：
   • OnRegistered — 注册成功时调用
   • OnError — 发生错误时调用

6. 要开始调试小组件，请启动一个关卡。

事件处理实现示例：

设置注册验证邮件

成功注册后，用户将在指定邮箱中收到一封注册验证邮件。您可以在发布商帐户中自定义发送给用户的邮件。

如果您开发的是Android应用程序，请设置深度链接以在用户验证注册后将用户返回到应用程序。

实现重新发送注册验证邮件请求

创建小组件

1. 前往Content Browser并打开UI目录，在快捷菜单中，前往User Interface > Widget Blueprint。
2. 在小组件蓝图中，添加以下界面元素：
   • 用户名/邮箱字段
   • 重新发送邮件按钮

下图为页面结构的示例。

3. 打开一个关卡蓝图：
   1. 在Content Browser中选择一个关卡。
   2. 在主菜单中，前往Blueprints > Open Level Blueprint。
4. 在CreateWidget节点中，指定创建的小组件。

添加事件处理

1. 在Hierarchy面板中，选择重新发送邮件按钮。
2. 在Details面板中，单击On Clicked事件旁边的+图标。

3. 打开Graph视图。
4. 关联XsollaLoginSubsystem对象上的一个ResendAccountConfirmationEmail方法调用至OnClicked节点，并添加用户输入数据传递。
5. 添加OnEmailResent和OnError回调函数。
6. 要开始调试小组件，请启动一个关卡。

如果请求成功，用户将在注册时指定的邮箱中收到一封注册验证邮件。

事件处理实现示例：

实现用户登录

创建小组件

1. 前往Content Browser并打开UI目录，在快捷菜单中，前往User Interface > Widget Blueprint。
2. 在小组件蓝图中，添加以下界面元素：
   • 用户名字段
   • 密码字段
   • 记住我复选框
   • 登录按钮

下图为页面结构的示例。

3. 打开一个关卡蓝图：
   1. 在Content Browser中选择一个关卡。
   2. 在主菜单中，前往Blueprints > Open Level Blueprint。
4. 在CreateWidget节点中，指定创建的小组件。

添加事件处理

1. 在Hierarchy面板中，选择登录按钮。
2. 在Details面板中，单击On Clicked事件旁边的+图标。

3. 打开Graph视图。
4. 关联XsollaLoginSubsystem对象上的一个AuthenticateUser方法调用至OnClicked节点，并添加用户输入数据传递。
5. 添加OnAuthenticated和OnError回调函数。

6. 要开始调试小组件，请启动一个关卡。

事件处理实现示例：

实现密码重置

创建小组件

1. 前往Content Browser并打开UI目录，在快捷菜单中，前往User Interface > Widget Blueprint。
2. 在小组件蓝图中，添加以下界面元素：
   • 用户名/用户邮箱地址字段
   • 密码重置按钮

下图为页面结构的示例。

3. 打开一个关卡蓝图：
   1. 在Content Browser中选择一个关卡。
   2. 在主菜单中，前往Blueprints > Open Level Blueprint。
4. 在CreateWidget节点中，指定创建的小组件。

添加事件处理

1. 在Hierarchy面板中，选择密码重置按钮。
2. 在Details面板中，单击On Clicked事件旁边的+图标。

3. 打开Graph视图。
4. 关联XsollaLoginSubsystem对象上的一个ResetUserPassword方法调用至OnClicked节点，并添加用户输入数据传递。
5. 添加OnEmailSent和OnError回调函数。
6. 要开始调试小组件，请启动一个关卡。

事件处理实现示例：

成功发出密码重置请求后，用户将收到一封包含密码重置链接的邮件。在发布商帐户 > 登录管理器项目 > 常规设置 > URL > 回调URL中，您可以配置用户成功完成认证、邮箱验证或密码重置后将其重定向到的URL地址或路径。

本指南说明如何使用SDK方法实现用户通过社交网络帐户进行注册和登录。

与通过用户名/邮箱地址和密码进行用户认证不同，您无需实现单独的用户注册逻辑。如果用户的首次登录是通过社交网络进行，将自动创建一个帐户。

如果您在应用程序中将社交网络登录设置为一种备选认证方法，则在满足下列条件的情况下，社交网络帐户将自动与现有用户帐户关联：

• 使用用户名/邮箱地址和密码注册的用户通过社交网络帐户登录您的应用程序。
• 社交网络返回一个邮箱地址。
• 社交网络帐户中用户邮箱地址与其注册您的应用程序时使用的邮箱地址一致。

源代码

在GitHub上查看这些示例的源代码。

示例展示了如何设置通过Twitter帐户进行用户登录。您可以用相同的方法设置其他社交网络。

示例中的逻辑与界面比您在应用程序中的简单得多。演示项目提供了一种可能的认证系统实现方案。

创建小组件

1. 前往Content Browser并创建UI目录。
2. 在快捷菜单中，前往User Interface > Widget Blueprint。
3. 在小组件蓝图中，添加社交网络登录按钮。

下图为页面结构的示例。

4. 打开一个关卡蓝图：
   1. 在Content Browser中选择一个关卡。
   2. 在主菜单中，前往Blueprints > Open Level Blueprint。
5. 实现在关卡启动时显示小组件。在CreateWidget节点中，指定创建的小组件。

添加事件处理

1. 在Hierarchy面板中，选择登录按钮。
2. 在Details面板中，单击On Clicked事件旁边的+图标。

3. 打开Graph视图。
4. 实现在内置浏览器中打开登录页：

1. 1. 将与XsollaLoginSubsystem对象连接的GetSocialAuthenticationUrl方法调用与OnClicked节点关联，并添加用户输入数据传递。将Twitter值传入ProviderName参数。
   2. 添加回调函数：
      • OnUrlReceived — 成功收到页面URL时调用。收到的URL在Url参数中传递。
      • OnError — 发生错误时调用。

5. 实现用户登录：
   1. 调用关联至XsollaLoginSubsystem对象的LaunchSocialAuthentication SDK方法。
   2. 传入登录页URL。

6. 要获取令牌，请跟踪用户成功登录后的页面URL变化：
   1. 实现在成功登录后关闭浏览器。
   2. 调用OnSocialAuthCompleted方法并订阅BrowserClosed事件。

事件处理实现示例：