如何集成用户帐户

运行机制

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

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

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

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

适用对象

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

如何获取

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

通过URL集成

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

生成URL

用户帐户将在https://useraccount.xsolla.com/profile处打开且参数如此表格中所述。
参数类型描述
locale
string请求参数。用户帐户界面语言。
支持的语言:英语(en)默认、阿拉伯语(ar)、保加利亚语(bg)、捷克语(cs)、德语(de)、西班牙语(es)、法语(fr)、希伯来语(he)、意大利语(it)、日语(ja)、韩语(ko)、波兰语(pl)、葡萄牙语(巴西)(pt)、罗马尼亚语(ro)、俄语(ru)、泰语(th)、土耳其语(tr)、越南语(vi)、简体中文(cn)、繁体中文(tw)。
token
string哈希参数。用户JWT。在身份验证成功之后在URL中传递。 必需
URL示例:
Copy
Full screen
Small screen
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&quot;&gt;Your account</a>,其中src生成的URL

设置事件处理(可选)

如果用户帐户在iframe中打开,则父窗口将会根据帐户中的用户操作获得postMessage事件。
事件名称描述
user-account-close用户单击“退出”按钮并关闭用户帐户。
user-account-loaded用户帐户已加载,但无法获取用户数据。
user-account-page-fetched用户帐户和用户数据已成功加载。

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

事件处理示例:

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

通过API调用集成

要通过API管理用户数据,请实现您自己的界面并允许API请求调用。您可以在我们的文档中找到可用API调用的详细说明和代码示例。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2024年7月31日

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

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