艾克索拉服务器集成

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

集成过程

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

安装资源

  1. 下载Unity
  2. 根据需要选择个人版或专业版Unity许可证。
  3. 新建一个Unity项目。
  4. 下载资源
  5. 解压缩文件包。
  6. 在Unity编辑器的主菜单中,前往Assets > Import Package > Custom Package,然后选择该资源。
  7. 请确保使用Mono编译器创建游戏编译版本(仅适用于独立编译版本)。方法是:

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

安装资源后,从Assets > Xsolla > DemoCommon > Scene目录中启动Xsollus演示场景。演示场景展示了该资源的功能,并提供应用程序逻辑的一种可能实现方式。

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

Xsollus演示场景的默认值:

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

演示场景有两种用途:

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

要在应用程序中使用演示场景或其中的组件,请在编译版本设置中进行添加:

  1. 前往Assets > Xsolla > DemoCommon > Scene并启动Xsollus场景。
  2. 打开File > Build settings,然后单击Add Open Scenes

在发布商帐户中设置项目

  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. 确保组状态为已启用

设置Unity项目

  1. 打开您的Unity项目。
  2. 在主菜单中单击Window > Xsolla > Edit Settings
  3. Inspector面板中指定项目参数:
    1. Login ID字段中,指定发布商帐户中的登录管理器ID。

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

    1. Project ID字段中,指定发布商帐户中的项目ID。
    2. 要启用沙盒模式,请勾选Enable sandbox?复选框。
    3. Authorization method字段中,选择OAuth2.0
    4. OAuth2.0 client ID字段中,指定在发布商帐户中设置OAuth 2.0时收到的客户端ID。

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

  1. 启动演示场景Assets > Xsolla > DemoCommon > Scene > Xsollus,确保授权功能及其他功能正常运行。
  2. 为登录系统、游戏内商店系统及应用程序的其他页面设计界面。

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

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

测试支付流程

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

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

  1. 确保已签署与艾克索拉的协议。
  2. 在Unity项目中,取消勾选Inspector面板中的Enable sandbox?复选框。

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

不想回答

感谢您的反馈!

继续阅读

上次更新时间: 2021年12月28日

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

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