艾克索拉服务器集成

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

集成过程

要集成Payments库:
  1. 下载安装Android Studio。
  2. 新建一个项目。
  3. 在您的发布商帐户中设置项目
  4. 设置虚拟货币模块(可选)。
  5. 设置虚拟物品模块(可选)。
  6. 设置支付中心
  7. 获取令牌
  8. 安装库
  9. 配置返回URL
  10. 设置事件处理和SDK方法
完成集成后,可测试支付流程
Note
本指南介绍快速使用该模块所需的最低设置。如有任何问题,请联系您的帐户经理。

在发布商帐户中设置项目

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

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

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

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

设置虚拟货币模块

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

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

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

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

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

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

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

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

设置虚拟物品模块

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

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

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

  1. 单击创建一个组

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

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

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

  1. 确保组状态为已启用

在发布商帐户中设置支付中心

  1. 前往您的项目并在支付中心部分单击打开。如果之前未安装商店模块,请在支付中心部分单击连接

  1. 打开支付中心设置。
  2. 重定向策略部分指定返回URL重定向条件,然后单击保存

获取令牌

需要令牌才能使SDK正常工作。访问令牌是一个用于初始化支付过程的字符串。

可使用Xsolla Store库中的Create Order with All Items from Particular Cart方法获取令牌,也可以使用其他访问令牌,例如从PlayFab收到的令牌。

安装库

可在Maven Central中找到该库。

要安装库:

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

最新版本:

Copy
Full screen
Small screen
implementation 'com.xsolla.android:payments:<version_number>'

配置返回URL

在项目的字符串资源文件中添加以下字符串以指定在发布商帐户中配置的返回URL

Copy
Full screen
Small screen
<string name="xsolla_payments_redirect_scheme">app</string>
<string name="xsolla_payments_redirect_host">yourgame</string>

应设置返回URL的各部分。所示为app://yourgame的示例。

测试支付流程

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

如果要通过进行真实付款来测试支付流程:

  1. 请确保已签署与艾克索拉的协议。
  2. 创建Paystation intent时设置.isSandbox(false)

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

不想回答

感谢您的反馈!

继续阅读

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

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

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