艾克索拉服务器集成

如使用此种集成,以下任务在艾克索拉侧执行:
  • 目录存储和管理
  • 价格管理
  • 存储区域价格数据
  • 区域限制管理
  • 物品库管理
  • 推广活动管理
  • 用户认证
  • 用户访问管理
  • 交易处理
Discord服务器
与艾克索拉团队以及使用艾克索拉产品的开发者联系。
您无需在自己的服务器侧配置上述任务。

集成过程

要使用Game Commerce插件与艾克索拉服务器集成:
  1. 安装该插件
  2. 在您的发布商帐户中设置项目
  3. 设置登录管理器或使用支付中心访问令牌实现您自己的授权系统
  4. 设置虚拟货币模块(可选)。
  5. 设置虚拟物品模块模块
  6. 设置您的UE4项目
完成集成后,可测试支付流程
Note
本指南介绍快速使用该模块所需的最低设置。如有任何问题,请联系您的帐户经理。

安装插件

  1. 下载Epic Games启动器
  2. 新建一个UE4项目。
  3. 虚幻商城GitHub中下载插件。

安装插件后,从Content Browser > Xsolla Content > Maps目录启动演示Map。演示Map展示了该插件的功能,并提供应用程序逻辑的一种可能实现方式。

对于演示Map,发布商帐户中预置了一个项目,且游戏内商店已完整配置。

演示Map的默认值:

KeyValue
登录管理器ID026201e3-7e40-11ea-a85b-42010aa80004
项目ID77640

演示Map有两种用途:

  • 作为示例
  • 作为登录系统、物品库和游戏内商店的初始版本,以便快速进行试用并根据需要扩展其功能

在发布商帐户中设置项目

  1. 注册发布商帐户
  2. 配置一个发布商帐户项目。注册帐户后将自动创建一个项目:
    1. 项目部分选择您的项目,然后前往项目设置
    2. 常规设置选项卡中,添加以下内容:
      • 图片(可选)
      • 项目语言(默认为英语)
      • 用于所有指定语言的项目名称
      • 游戏网站(可选)
      • 项目描述(可选)
    3. 单击保存

集成过程中需要用到以下参数:

  • 项目ID,可在项目设置 > 项目ID中找到。

  • 登录管理器ID,可在登录管理器设置 > 登录管理器ID中找到它,为UUID格式

设置登录管理器

  1. 发布商帐户中打开您的项目。
  2. 登录管理器窗格中单击连接。您可以通过在侧边栏中单击登录管理器按钮从发布商帐户的任何位置前往“登录管理器”设置。

  1. 前往登录管理器项目,然后单击设置登录管理器

  1. 指定名称,然后单击创建

  1. 前往常规设置 > URL部分,然后指定回调URL(用户完成邮箱确认或密码重置后将重定向到该URL)。
  2. 用户数据存储部分选择艾克索拉存储
  3. 设置OAuth 2.0授权:

    1. 前往授权部分。
    2. OAuth 2.0认证部分单击连接
    3. 指定OAuth 2.0重定向URI并单击连接
    4. 复制并保存客户端ID

Note
OAuth 2.0是推荐的认证方法,默认在SDK设置中选中。

设置虚拟货币模块

  1. 发布商帐户中打开您的项目。
  2. 商店窗格中单击连接。您可以通过在侧边栏中单击商店按钮从发布商帐户的任何位置前往“游戏内商店”设置。

  1. 虚拟货币窗格中单击连接

  1. 创建虚拟货币:
    1. 单击创建虚拟货币

    1. 指定以下信息:
      • SKU
      • 货币名称
      • 虚拟货币单价
      • 默认货币
      • 硬虚拟货币功能(可选)
      • 图像(可选)
    2. 单击创建货币

  1. 创建虚拟货币套餐:
    1. 前往套餐
    2. 单击创建套餐

    1. 指定以下信息:
      • SKU
      • 套餐名称
      • 简短描述
      • 虚拟货币
      • 套餐中的货币数量
      • 价格
      • 默认价格
      • 图像(可选)

    1. 在商店中显示开关设置为
    2. 单击创建套餐

Note
本插件支持使用虚拟货币购买虚拟物品。此外,用户还可以根据游戏内逻辑使用虚拟货币(获得某地点的访问权限、进入下一级别等)。调用ConsumeInventoryItem SDK方法时用户将消耗虚拟货币。

设置虚拟物品模块

Note
SDK方法支持以下类型的物品:
  • 消耗品 — 消耗品是物品库中可累积或重复购买的物品,且使用后在物品库中的数量会相应减少。用户可以补充这类物品的数量。例如:攻击敌人的弹药、急救包等。
  • 非消耗品 — 非消耗品是物品库中只能一次性获得或购买的物品,不会从物品库中消失。例如:某个地点的访问权限、状态等。
  • 到期性订阅 — 在一段时间内有效的非消耗品,到期后不会从物品库中消失。例如:高级访问权限或季度访问权限。详细信息请参阅游戏内商店文档

  1. 发布商帐户中打开您的项目。
  2. 商店窗格中单击连接。您可以通过在侧边栏中单击商店按钮从发布商帐户的任何位置前往“游戏内商店”设置。

  1. 虚拟物品窗格中单击连接

  1. 单击创建一个组

  1. 指定组代码组名称
  2. 在商店中显示组开关设置为
  3. 单击创建组

  1. 创建物品:
    1. 指定以下信息:
      • 该物品所属的一个或多个组
      • SKU
      • 名称和简短描述
      • 以真实货币和虚拟货币表示的价格
      • 图像(可选)

    1. 偏好部分的物品属性字段,根据物品类型选择以下属性之一:
      • 消耗品
      • 非消耗品
      • 到期性订阅
    2. 单击创建物品

  1. 确保组状态为已启用

设置UE4项目

  1. 在虚幻编辑器中打开您的UE4项目。
  2. 仅对于蓝图项目:
    1. 编译您的UE4项目。
    2. 前往Content Browser,添加一个New C++ ClassNone父节点。
  3. 前往Settings > Plugins > Installed > Xsolla Store SDK。勾选Enabled复选框,然后单击Restart Now按钮保存设置并重新加载虚幻编辑器。

  1. 指定项目参数:
    1. 前往Settings > Project Settings > Plugins > Xsolla Login,并指定以下参数:

      1. Login IDDemo Login ID字段中,指定发布商帐户中的登录管理器ID。
      2. Project IDDemo Project ID字段中,指定发布商帐户中的项目ID。
      3. 启用Use OAuth 2.0选项。
      4. Client ID字段中,指定在发布商帐户中设置OAuth 2.0时收到的客户端ID。

Note
如果使用自有授权系统,则无需填写Login IDDemo Login ID字段。

    1. 前往Settings > Project Settings > Plugins > Xsolla Store,然后在Project IDDemo Project ID字段中指定项目ID。

    1. 前往Settings > Project Settings > Plugins > Xsolla Inventory,然后在Project IDDemo Project ID字段中指定项目ID。

随后,您发布商帐户中的项目将连接至演示Map。

  1. 前往Content Browser > View Options,然后勾选Show Engine ContentShow Plugin Content复选框。

  1. 前往Content Browser > Xsolla Content > Maps,然后启动游戏的Demo_Store Map。确保授权功能及其他功能正常运行。
  2. 为登录系统、游戏内商店系统及应用程序的其他页面设计界面。

Note
您可以按照UMG UI文档中的信息创建自己的解决方案,也可以将演示场景用作模板。要根据自己的应用程序调整演示场景,请使用UI生成器。

  1. 根据您的应用程序逻辑使用SDK方法设置事件处理。请按照分步教程熟悉基本的SDK功能。

Note
要根据应用具体情况修改SDK,请按照SDK修改说明进行操作。

测试支付流程

成功配置插件后,请测试支付流程。默认情况下,所有用户的支付均在沙盒模式下进行,可使用测试银行卡来模拟成功的支付过程。

通过进行真实付款测试支付流程:

  1. 确保已签署与艾克索拉的协议。
  2. 在UE4项目中,取消勾选Settings > Project Settings > Plugins > Xsolla Store中的Sandbox复选框。

Note
首次完成真实付款后,严格沙盒付款政策即生效。沙盒模式支付只对发布商帐户 > 公司设置 > 用户中指定的用户可用。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
为此页面评分
为此页面评分
我们还有其他可改进之处吗?

不想回答

感谢您的反馈!

继续阅读

上次更新时间: 2021年9月1日

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

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