如何集成用户帐户
运行机制
用户可以通过其帐户管理以下数据:
- 个人资料图片
- 电话
- 电子邮件
- 昵称
- 姓名
- 出生日期
- 性别
- 好友列表(仅通过API提供)。
您可以通过以下方式之一集成用户帐户:
适用对象
已集成登录管理器的合作伙伴。
如何获取
选择想要集成用户帐户的方式并按照以下说明操作。
通过URL集成
生成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中传递。 必需。 |
Copy
- http
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
方法和脚本。
事件处理示例:
Copy
- javascript
window.addEventListener('message', (event) => {
if (event.data.command === 'user-account-loaded') {
// your script
}
})
通过API调用集成
要通过API管理用户数据,请实现您自己的界面并允许API请求调用。您可以在我们的文档中找到可用API调用的详细说明和代码示例。本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。