免费商品

免费商品是一种用户无需使用虚拟货币或真实货币购买即可获得的商品类型，包括：

• 虚拟物品
• 捆绑包
• 虚拟货币套餐

免费商品仅适用于授权用户。未授权用户只能查看免费商品的目录。

使用示例：

• 可在项目的一些重要日子（如项目筹建当天）向用户送出免费商品来回馈用户忠实度。
• 可在商店中送出新手套装来吸引新用户加入游戏。

可在用户已拥有的情况下限制特殊商品的免费发放。

要设置免费商品：

1. 将免费商品添加到目录。
2. 实现用户下单免费商品的逻辑。
3. 实现将免费商品发放给用户的逻辑。

将免费商品添加到目录

关于创建商品的详细信息，请参阅以下文档章节：

• 设置虚拟货币套餐
• 创建虚拟物品
• 创建捆绑包

创建或编辑免费商品时，需在付费或免费部分选择免费物品、免费套餐或免费捆绑包。

用户下单免费商品

用户可以通过两种方式下单免费商品：

• 一键下单（不使用购物车）— 任意数量的某一个SKU，例如100瓶同样的魔法药水。
• 通过购物车 — 任意数量任意类型的商品。

一键下单免费商品

要实现此方式，请在用户点击目录中的按钮下单免费商品时调用Store库的createOrderWithSpecifiedFreeItem方法。

成功向该方法发送请求后，艾克索拉侧向用户物品库发放商品将立即发生（无需打开支付中心）。

通过购物车下单免费商品

对于用户通过购物车下单的情况：

• 如用户购物车同时包含付费和免费商品：
  1. 使用Store库的createOrderFromCartById或createOrderFromCurrentCart方法获取支付令牌和订单ID
  2. 实现支付UI的打开。方法是调用Payments库的createIntentBuilder方法并传入支付令牌和订单ID。

• 如用户购物车中仅包含免费商品，请调用Store库的createOrderWithFreeCart方法。向该方法发送请求成功后，艾克索拉侧向用户发放商品将立即发生（无需打开支付中心）。

将免费商品发放给用户

您可以重复调用Store库的getOrder方法来跟踪免费商品的订单状态。

如果订单成功，请使用显示用户物品库的SDK方法来更新应用程序用户端侧的数据。

有用链接