用户帐户

运行机制

用户可以通过其帐户管理以下数据:

  • 个人资料图片
  • 电话
  • 电子邮件
  • 昵称
  • 姓名
  • 出生日期
  • 性别
  • 好友列表(仅通过API提供)。

您可以通过以下方式之一集成用户帐户:

  • 通过URL使用用户界面进行。“用户帐户”界面已本地化成20种语言并且可以适应各种屏幕分辨率。
  • 不使用用户界面而通过API进行。您可以通过此方法实现自己管理用户数据的界面。

使用者

已集成登录管理器的合作伙伴。

如何获取

选择想要集成用户帐户的方式并按照以下说明操作。

通过URL集成

  1. 生成一个用于打开用户帐户的URL。
  2. 设置用户帐户在生成的URL上打开。
  3. 设置事件处理(可选)。

URL生成

用户帐户将在https://useraccount.xsolla.com/profile处打开且参数如此表格中所述。

参数类型描述
localestring查询参数。用户帐户界面语言。接受符合ISO 639-1标准的值。
tokenstring哈希参数。用户JWT。在身份验证成功之后在URL中传递。 必需

URL示例:

https://useraccount.xsolla.com/profile?locale=de#token=XXXX

设置用户帐户在URL上打开

您可以通过以下方式设置在特定URL上打开用户帐户:

  • 在网站上的iframe中
  • 在新的选项卡中

IFRAME

为想要在其中打开用户帐户的网页添加以下脚本:<iframe src="https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">,其中src生成的URL

新选项卡

为指向用户帐户的UI对象添加URL。

您可以使用以下脚本:<a href="https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">Your account</a>,其中src生成的URL

设置事件处理(可选)

如果用户帐户在iframe中打开,则父窗口将会根据帐户中的用户操作获得postMessage事件。

事件名称描述
user-account-close用户单击“退出”按钮并关闭用户帐户。
user-account-loaded用户帐户已加载,但无法获取用户数据。
user-account-page-fetched用户帐户和用户数据已成功加载。

要处理这些事件,请为网站添加addEventListener方法和脚本。

事件处理示例:

window.addEventListener('message', (event) => {
  if (event.data.command === 'user-account-loaded') {
    // your script
  }
})

通过API集成

要通过API管理用户数据,请实现您自己的界面并允许API方法调用。您可以在我们的文档中找到可用API方法的详细说明和代码示例。