免费商品

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

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

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

使用示例：

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

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

要设置免费商品：

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

将免费商品添加到目录

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

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

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

用户下单免费商品

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

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

一键下单免费商品

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

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

通过购物车下单免费商品

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

• 如购物车中同时包含付费和免费商品，请调用Cart类的Purchase SDK方法。该方法会封装创建订单、打开支付UI和跟踪订单状态的方法。

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

将免费商品发放给用户

Purchase、PurchaseFreeItem和PurchaseFreeCart方法包含跟踪订单状态的逻辑。调用这些方法时，请在onSuccess参数中传入订单变为done状态时调用的函数。使用以下方式之一在客户端侧更新物品库：

• 使用显示用户物品库的SDK方法
• 使用传入购买方法onSuccess回调函数的订单内容数据

有用链接