设置用户身份认证
订阅产品只能销售给完成身份认证的用户。您可以使用自己的身份认证系统或艾克索拉登录管理器:
- 如果没有自己的后端或需要现成可用的登录和数据存储方案,可使用艾克索拉登录管理器。
- 如果已有自己的身份认证系统,可通过艾克索拉API传递用户数据继续使用现有系统。
您可以在自己的UI(应用或网站)实现订阅销售,或使用艾克索拉建站器创建网站:
- 通过自己UI销售订阅时,可使用艾克索拉API获取可用和活跃订阅数据。
- 使用艾克索拉建站器时,您只需在己侧处理订阅信息的获取以便在游戏中使用。
选择订阅购买的身份认证方式:
选择订阅销售渠道:
如果使用自己的身份认证系统,此阶段只需确保能存储并传递艾克索拉管理订阅所需的数据:
- 唯一用户ID
- 用户邮箱
在这种情况下,建议使用网页商城模板创建网站,并通过ID或深度链接设置用户身份认证。
具体方法:
- 在发布商帐户中打开您的项目,然后前往商店 > 网站部分。
- 单击创建站点。
- 选择网页商城模板。
- 添加游戏所在外部平台的URL,快速创建与游戏风格一致的页面:系统会自动添加图片、游戏标题、开发者信息和颜色方案。如不想使用游戏数据,请关闭通过App Store或Google Play URL复制游戏信息开关。
单击创建网页商城。
设置以下用户身份认证方式之一:
选择订阅销售渠道:
在发布商帐户中设置用户身份认证
艾克索拉支持配置多种用户认证方式。本指南包含以最快方式进行集成和配置的说明,即使用现成的小组件通过一次性验证码或社交网络进行用户认证。
您也可以在后面更改用户认证方式或使用其他集成方案。
艾克索拉提供标准小组件模板。它们的外观和内容取决于您在发布商帐户中为项目所选的登录方式和小组件自定义设置。
使用一次性验证码或社交网络进行身份认证的标准小组件视图:

要在发布商帐户中设置用户认证:
- 在发布商帐户中打开您的项目,前往玩家 > 登录管理器部分。
- 在仪表板中,单击创建登录管理器项目。
- 选择标准登录管理器项目,然后单击创建并设置。等待新登录管理器项目的创建,然后即可看到登录管理器项目页面。
- 在登录方法区块中选择免密登录。
- 单击配置。
- 设置一次性验证码授权:
- 在免密登录区块中,选择回调URL。
- 在回调URL字段中,添加用户成功认证后的重定向URL。
- 单击保存更改。
- 设置社交网络身份认证(可选):
- 在层级导航路径中单击登录管理器项目的名称返回登录管理器项目页。
- 前往身份认证区块并选择社交网络登录。
- 连接用户可用于注册和登录应用的社交网络:
- 要连接所需的社交网络,请单击⚙图标,然后选择连接。
- 要一次性连接多个社交网络,请选择需要的窗格(其边框会变成绿色),然后从管理下拉菜单中选择连接。
- 要一次性连接所有可用的社交网络,请单击全选,然后从管理下拉菜单中选择连接。
- 单击保存更改。
您可以测试小组件的设置,方法是单击屏幕左侧的立即检查并登录。
集成过程中,您需要登录管理器项目ID,可在发布商帐户中的项目玩家 > 登录管理器 > 仪表板部分找到。
在应用中实现用户身份认证
您可以在下方找到以最快方式集成艾克索拉登录管理器的说明,即在应用程序中集成现成的Web小组件。
如要使用自己的UI来让用户登录到您的应用程序,应使用Login API或SDK方法来实现用户认证逻辑。
连接Xsolla Login widget SDK
可使用NPM包管理器或HTML页面上的<script>标记来安装艾克索拉登录管理器小组件。
通过以下方式之一连接Xsolla Login widget SDK:
启动控制台并运行以下命令:
- bash
1npm i @xsolla/login-sdk
在要放置小组件的HTML页面的<head>标记中添加以下代码:
- html
1<script src="https://login-sdk.xsolla.com/latest/">
2</script>
初始化Xsolla Login widget SDK
使用以下方法之一初始化小组件。指定以下参数:
projectId— 登录管理器项目ID。可在发布商帐户您的项目中找到,位于玩家 > 登录管理器 > 仪表板部分。preferredLocale— 界面语言。支持以下语言:阿拉伯语(ar_AE)、保加利亚语(bg_BG)、捷克语(cz_CZ)、英语(en_US)、德语(de_DE)、西班牙语(es_ES)、法语(fr_FR)、希伯来语(he_IL)、意大利语(it_IT)、日语(ja_JP)、韩语(ko_KR)、波兰语(pl_PL)、葡萄牙语(pt_BR)、罗马尼亚语(ro_RO)、俄语(ru_RU)、泰语(th_TH)、土耳其语(tr_TR)、越南语(vi_VN)、简体中文(zh_CN)、繁体中文(zh_TW)。clientId— OAuth 2.0客户端ID。可在发布商帐户您的项目中找到,位于玩家 > 登录管理器 > 您的登录管理器项目 > 安全性 > OAuth 2.0部分。redirectUri— 用户完成帐户验证、登录或确认密码重置后被重定向到的URL。必须在发布商帐户的OAuth 2.0客户端设置中指定。
其余参数保持不变。
将初始化代码添加到JS文件中:
- javascript
1import { Widget } from '@xsolla/login-sdk';
2const xl = new Widget({
3 projectId: 'LOGIN_PROJECT_ID',
4 preferredLocale: 'en_US'
5 clientId: 'CLIENT_ID',
6 responseType: 'code',
7 state: 'CUSTOM_STATE',
8 redirectUri: 'REDIRECT_URI',
9 scope: 'SCOPE'
10});
将小组件初始化代码添加到<body>标记中:
- html
1<script>
2const xl = new XsollaLogin.Widget({
3 projectId: 'LOGIN_PROJECT_ID',
4 preferredLocale: 'en_US',
5 clientId: 'CLIENT_ID',
6 responseType: 'code',
7 state: 'CUSTOM_STATE',
8 redirectUri: 'REDIRECT_URI',
9 scope: 'SCOPE'
10});
11</script>
添加艾克索拉登录管理器小组件的打开
- 在您的HTML页面中添加含
on-click事件的按钮和xl.open()函数:
- html
1<div id="xl_auth" style="display: none"></div>
2<button onclick="showFullscreen()">Fullscreen widget</button>
- 在您的HTML页面的
<div>区块中添加打开小组件的代码。
将以下代码添加到JS文件中:
- javascript
1xl.mount('xl_auth');
2const showFullscreen = () => {
3 const myDiv = document.querySelector('#xl_auth');
4 myDiv.style.display = 'block';
5 xl.open();
6}
将打开小组件的代码添加到<body>标记中:
- html
1<script type="text/javascript">
2 xl.mount('xl_auth');
3
4 function showFullscreen() {
5 const myDiv = document.querySelector('#xl_auth');
6 myDiv.style.display = 'block';
7
8 xl.open();
9 }
10</script>
在发布商帐户中设置用户身份认证
艾克索拉支持配置多种用户认证方式。本指南包含以最快方式进行配置的说明,即通过一次性验证码或社交网络进行用户认证。
您可以在后续阶段更改用户身份认证方法。
要在发布商帐户中设置用户认证:
- 在发布商帐户中打开您的项目,前往玩家 > 登录管理器部分。
- 在仪表板中,单击创建登录管理器项目。
- 选择标准登录管理器项目,然后单击创建并设置。等待新登录管理器项目的创建,然后即可看到登录管理器项目页面。
- 在登录方法区块中选择免密登录。
- 单击配置。
- 设置一次性验证码授权:
- 在免密登录区块中,选择回调URL。
- 在回调URL字段中,添加用户成功认证后的重定向URL。
- 单击保存更改。
- 设置社交网络身份认证(可选):
- 在层级导航路径中单击登录管理器项目的名称返回登录管理器项目页。
- 前往身份认证区块并选择社交网络登录。
- 连接用户可用于注册和登录应用的社交网络:
- 要连接所需的社交网络,请单击⚙图标,然后选择连接。
- 要一次性连接多个社交网络,请选择需要的窗格(其边框会变成绿色),然后从管理下拉菜单中选择连接。
- 要一次性连接所有可用的社交网络,请单击全选,然后从管理下拉菜单中选择连接。
- 单击保存更改。
在建站器中设置用户身份认证
要创建网站并设置用户身份认证:
- 在发布商帐户中打开您的项目,然后前往商店 > 网站部分。
- 单击创建站点。
- 选择任意网站模板并继续创建。
网页商城和单游戏页面模板支持自动设计配置,创建网站时可添加游戏链接:
- 网页商城模板 — 添加游戏的Google Play或App Store链接,完成商店界面(Logo、背景图片、颜色、页脚文本)的初始定制。
- 单游戏页面模板 — 添加游戏的Steam或Epic游戏商城链接,自动设置商店设计(游戏图片、游戏信息、常见问答、颜色、年龄限制)。
如需手动自定义商店设计,或游戏尚未在这些平台上架,请关闭相应开关。
- 在建站器中,前往登录设置 > 艾克索拉登录管理器部分,从下拉列表中选择之前配置的身份认证方式。
- 要使授权模态窗口与网站颜色方案协调一致,可启用使用网站主题开关。
- 在布局部分,根据需要配置Logo和自定义背景。
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。