在您的应用程序中认证用户身份

为确保支付交易的安全性以及能够正确进行，艾克索拉API使用JSON Web令牌(JWT)，该令牌在使用艾克索拉登录管理器进行授权的过程中获得。

您可以在下方找到以最快方式集成艾克索拉登录管理器的说明，即在应用程序中集成现成的Web小组件。

如要使用自己的UI来让用户登录到您的应用程序，应使用Login API或SDK方法来实现用户认证逻辑。

选择最适合您项目的SDK：

导入小组件及与之交互的一般说明见README文件。

连接Xsolla Login widget SDK

可使用NPM包管理器或HTML页面上的<script>标记来安装艾克索拉登录管理器小组件。

通过以下方式之一连接Xsolla Login widget SDK：

初始化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文件中：

Copy

Full screen

Small screen

import { Widget } from '@xsolla/login-sdk';
const xl = new Widget({
  projectId: 'LOGIN_PROJECT_ID',
  preferredLocale: 'en_US'
  clientId: 'CLIENT_ID',
  responseType: 'code',
  state: 'CUSTOM_STATE',
  redirectUri: 'REDIRECT_URI',
  scope: 'SCOPE'
});

将小组件初始化代码添加到<body>标记中：

Copy

Full screen

Small screen

<script>
const xl = new XsollaLogin.Widget({
  projectId: 'LOGIN_PROJECT_ID',
  preferredLocale: 'en_US',
  clientId: 'CLIENT_ID',
  responseType: 'code',
  state: 'CUSTOM_STATE',
  redirectUri: 'REDIRECT_URI',
  scope: 'SCOPE'
});
</script>

添加艾克索拉登录管理器小组件的打开

在您的HTML页面中添加含on-click事件的按钮和xl.open()函数：

Copy

Full screen

Small screen

<div id="xl_auth" style="display: none"></div>
<button onclick="showFullscreen()">Fullscreen widget</button>

在您的HTML页面的<div>区块中添加打开小组件的代码。

将以下代码添加到JS文件中：

Copy

Full screen

Small screen

xl.mount('xl_auth');
const showFullscreen = () => {
  const myDiv = document.querySelector('#xl_auth');
  myDiv.style.display = 'block';
  xl.open();
}

将打开小组件的代码添加到<body>标记中：

Copy

Full screen

Small screen

<script type="text/javascript">
  xl.mount('xl_auth');

  function showFullscreen() {
    const myDiv = document.querySelector('#xl_auth');
    myDiv.style.display = 'block';

    xl.open();
  }
</script>

关于安装和使用本SDK的一般说明，请参阅Unity专用企业级SDK文档。

从压缩文件导入资源包

从CDN或GitHub下载SDK。

通过CDN只能下载最新版本的SDK。如需要其他版本，可从GitHub下载。

解压缩包。
打开您的Unity项目或新建一个项目。
在Unity编辑器中，在主菜单中前往Assets > Import Package > Custom Package，然后选择该SDK。

设置编译器

对于桌面平台，建议您使用Mono编译器，因为它与所提供的游戏内浏览器兼容。如果使用其他浏览器解决方案，则可使用IL2CPP编译器。

要创建Android或iOS游戏编译版本，使用Mono或IL2CPP编译器均可。

请确保使用Mono编译器创建游戏编译版本（仅适用于独立编译版本）。方法是：

在主菜单中单击Edit > Project Settings。
前往Player > Other Settings > Configuration部分。
确保Scripting Backend字段中选择了Mono。

解析Android依赖项

对于Android编译版本，本SDK使用原生Android库中的函数。

要解析依赖项并下载必要库：

将Android指定为编译版本平台：
1. 在Unity编辑器中，前往主菜单中的File > Build Settings。
2. 在Platform面板中，选择Android。
3. 单击Switch Platform。

启动依赖项管理器：
1. 在Unity编辑器中，前往主菜单中的Assets > External Dependency Manager > Android Resolver > Resolve。
2. 等待依赖项管理器完成。

最终，所有必要Android库的JAR或AAR文件会下载到Assets/Plugins/Android文件夹中。

设置SDK

打开您的Unity项目。
在主菜单中单击Window > Xsolla > Edit Settings。
通过以下方式之一在Inspector面板中指定主要项目参数：

1. 从发布商帐户导入设置：
  1. 单击Fill settings by PA。
  2. 在Login和Password字段中指定发布商帐户授权数据。
  3. 单击Log In。
  4. 填写Publisher Account部分的字段。

1. 1. 单击Apply Settings。

如果您注册发布商帐户时使用的是社交网络帐户，需要通过以下方式添加密码，然后才能从您的发布商帐户导入设置：

在发布商帐户的注册/登录页面，单击忘记了密码？，然按照说明进行操作。
在发布商帐户的资料设置 > 更改密码部分指定一个新密码（当前密码字段输入任意值）。

1. 手动指定以下参数：
  1. 在Project ID字段中，指定可在发布商帐户中项目名称旁边找到的项目ID。
  2. 在Login ID字段中，指定登录管理器项目的ID。要获取该ID，请打开发布商帐户，前往登录管理器 > 仪表板 > 您的登录管理器项目部分，然后单击登录管理器项目名称旁边的复制ID。
  3. 在Callback URL字段中，指定用户成功完成认证、邮箱验证或密码重置后将其重定向到的URL或路径。该值必须与发布商帐户中登录管理器 > 您的登录管理器项目 > 安全性 > OAuth 2.0部分中指定的值一致。

如果Callback URL字段为空，则将使用app://xlogin.<APP_ID>进行重定向，其中<APP_ID>是Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier中的应用程序ID。同时必须将该值添加到发布商帐户中的登录管理器 > 您的登录管理器项目 > 安全性 > OAuth 2.0部分。

1. 1. 在OAuth Client ID字段中，指定可在发布商帐户的登录管理器 > 您的登录管理器项目 > 安全性 > OAuth 2.0中找到的OAuth 2.0客户端ID。

如需要，设置其他参数（如Pay Station UI部分中的支付UI显示选项）。

添加艾克索拉登录管理器小组件的打开

要打开小组件，请调用XsollaAuth.AuthWithXsollaWidget SDK方法并传入以下参数：

onSuccess — 用户认证成功回调。
onError — 请求错误回调。
onCancel — 用户认证取消回调，在用户未完成认证流程即关闭小组件的情况下触发。
locale — UI语言（可选）。支持以下语言：阿拉伯语(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)。

对于独立编译版本，小组件在SDK包含的一个内置浏览器中打开。您也可以使用允许跟踪URL更改的其他内置浏览解决方案

关于安装和使用本SDK的一般说明，请参阅Android专用企业级SDK文档。

安装SDK

可在Maven Central中找到所需库。

要安装库：

启动Android Studio。
打开应用程序的build.gradle文件。
在依赖关系部分添加以下代码行，其中<version_number>是需要的库版本：

Copy

Full screen

Small screen

implementation "com.xsolla.android:login:<version_number>"
implementation "com.xsolla.android:store:<version_number>"
implementation "com.xsolla.android:payments:<version_number>"

初始化SDK

在应用程序启动时调用静态方法来初始化Login库。具体方法是，在您的Android项目源代码中添加以下代码行：

Copy

Full screen

Small screen

val loginConfig = LoginConfig.OauthBuilder()
                .setProjectId("login-project-id") // You can find it in your Publisher Account, in the Login > Dashboard section.
                .setOauthClientId("oauth2-client-id") // You can find it in Publisher Account in the Login > your Login project > Security > OAuth 2.0 section.
                .build()

XLogin.init(applicationContext, loginConfig)

添加艾克索拉登录管理器小组件的打开

要打开小组件：

调用Login库的XLogin.startAuthWithXsollaWidget方法，传入以下参数：

- fragment或activity — 当前片段或活动。

- callback — 状态回调。

- locale — UI语言。支持以下语言：阿拉伯语(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)。

在onActivityResult方法中，调用Login库的XLogin.finishAuthWithXsollaWidget方法，传入以下参数：

- activity — 当前活动，是处理应用程序上下文所必需。

- activityResultRequestCode — onActivityResult方法的请求代码，用于识别原始请求。

- activityResultCode — onActivityResult方法的结果代码，可用它判断操作是否成功。

- activityResultData — onActivityResult返回的数据。它包含操作的结果。

- callback — 状态回调，用于处理身份认证结果。

处理授权结果时，请初始化Store库。

初始化Store库：

Copy

Full screen

Small screen

XStore.init(<yourProjectId>, XLogin.token!!) // Project ID can be found in your Publisher Account next to the project name.

关于安装和使用本SDK的一般说明，请参阅虚幻引擎专用企业级SDK文档。

安装SDK

下载Epic Games启动器。
新建一个虚幻引擎项目。

下载并安装SDK：
1. 要从虚幻商城下载并安装该SDK：
  1. 前往虚幻商城上的SDK页面。
  2. 单击Open in Launcher。

1. 1. 前往Epic Games启动器。

1. 1. 单击Install to Engine。
  2. 在虚幻编辑器中打开您的虚幻引擎项目。
  3. 前往Settings > Plugins > Installed > Xsolla SDK部分。勾选Enabled复选框并单击Restart Now以保存设置并重新加载虚幻编辑器。

1. 要从GitHub下载并安装该SDK：
  1. 下载包含用于相应引擎版本SDK的包。
  2. 解压缩包。
  3. 将SDK文件夹移至虚幻引擎项目根目录下的plugins目录。

设置SDK

在虚幻编辑器中打开您的虚幻引擎项目。
前往Settings > Project Settings > Plugins > Xsolla Settings > General并指定项目参数：

1. 在Project ID字段中，指定可在发布商帐户中项目名称旁边找到的项目ID。
2. 在Login ID字段中，指定登录管理器项目的ID。要获取该ID，请打开发布商帐户，前往登录管理器 > 仪表板 > 您的登录管理器项目部分，然后单击登录管理器项目名称旁边的复制ID。
3. 在Client ID字段中，为OAuth 2.0指定可在发布商帐户登录管理器 > 您的登录管理器项目 > 安全性 > OAuth 2.0部分中找到的客户端ID。
4. 在Redirect URI字段中，指定用户成功完成认证、邮箱验证或密码重置后将其重定向到的URL或应用程序内路径。该值必须与发布商帐户中登录管理器 > 您的登录管理器项目 > 安全性 > OAuth 2.0部分中指定的值一致。
5. 如有需要，设置其他的设置（如Pay Station UI部分中的支付UI显示选项）。

之后，您在发布商帐户中的项目将连接到演示Map。

前往Content Browser > View Options，然后勾选Show Engine Content和Show Plugin Content复选框。

添加艾克索拉登录管理器小组件的打开

调用AuthWithXsollaWidget SDK方法，传入以下参数：

WorldContextObject — world context对象（适用于C++调用）。
SuccessCallback — 用户成功认证和收到令牌的回调（可选）。
CancelCallback — 用户认证取消回调，在用户未完成认证流程即关闭小组件的情况下触发（可选）。
ErrorCallback — 认证过程中发生错误的回调（可选）。
bRememberMe — 是否需要留存身份认证数据（可选）。默认情况下值设置为false。
Locale — UI语言（可选）。默认情况下，该值由用户IP地址定义。
State — 用于应用程序服务器上额外用户验证的字符串。默认值设置为xsollatest。

示例：

对于独立编译版本，小组件使用SDK随附的W_LoginBrowser蓝图打开。

您可以自定义使用现有蓝图来打开身份认证小组件。

感谢您的反馈！

我们会查看您的留言并运用它改进用户体验。

上次更新时间: 2024年9月4日

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

Your browser is not supported. Please try a different browser

热门文章

或选择常见问题:

回答基于以下来源:

向我们提供反馈（可选）

向我们提供反馈（可选）

付款

在您的应用程序中认证用户身份

连接Xsolla Login widget SDK

初始化Xsolla Login widget SDK

添加艾克索拉登录管理器小组件的打开

从压缩文件导入资源包

设置编译器

解析Android依赖项

设置SDK

添加艾克索拉登录管理器小组件的打开

安装SDK

初始化SDK

添加艾克索拉登录管理器小组件的打开

安装SDK

设置SDK

添加艾克索拉登录管理器小组件的打开