虚拟物品

运行机制

虚拟物品是指用户可以使用真实货币或虚拟货币购买，或作为奖励获得的游戏内物品。这类物品没有实体形式，仅能在游戏内使用。常见的虚拟物品包括皮肤、药水、武器等影响游戏玩法或角色外观的元素。

主要功能：

灵活的价格配置：
- 为单个物品设置真实货币和/或虚拟货币价格。
- 创建免费物品。
自动检测用户所在国家/地区和货币。
可用性配置：
- 限制物品在特定区域的销售。
- 限制可供购买的物品数量。
- 限制物品在商店中的展示时间。
- 配置不可购买的物品。物品可从目录中隐藏，但仍可作为捆绑包的一部分或其他物品的奖励提供。

虚拟物品可通过发布商帐户、API调用或导入目录的方式创建。

本指南介绍如何手动创建虚拟物品以及使用API调用的方法。有关其他商品类型的创建说明，请参阅商品目录部分。

在设置虚拟物品前，建议先创建组，以便对物品进行分类并管理其在商店中的显示方式。

要创建虚拟物品：

虚拟物品可以设置多种真实货币和虚拟货币价格。在这种情况下，您必须为每种类型指定一种默认货币：一种用于真实货币，一种用于虚拟货币。

要设置虚拟物品，您可以使用虚拟物品和货币组管理子部分下的调用。

管理子部分下的调用不适用于在前端创建商店目录，因此请勿将其用于着陆页、网页商城和游戏内逻辑。

任务	API调用
创建一个虚拟物品。	创建虚拟物品。
获取虚拟物品信息。	获取虚拟物品。
获取一个虚拟物品列表。	获取虚拟物品列表。
按照指定的组获取虚拟物品列表。	在按照指定组的外部ID获取虚拟物品列表API调用中传入`external_id`参数。
按组获取虚拟物品列表以进行管理。	在按照指定组ID获取虚拟物品列表API调用中传入`group_id`参数。
更新一个虚拟物品。	更新虚拟货币。
删除一个虚拟物品。	删除虚拟货币。
限制虚拟物品可购买的数量。	在创建虚拟货币或更新虚拟货币API调用中传递以下参数： `limits` — 指定可购买的虚拟货币最大数量。 `limits.recurrent_schedule` — 定义重置限制数的频率。

有关数量限制的更多信息，请参阅以下指南：

虚拟物品的显示方式取决于目录的实现方式 — 通过建站器还是通过API。

要在您的网站上显示虚拟物品：

要在建站器中显示虚拟物品，需提前创建组 – 虚拟物品仅作为分组的一部分在商店目录中显示。

如果无法发布网站，请确保满足以下所有条件：

网站发布后，包含虚拟物品分组的区段将可用。如果未显示物品，请检查其状态是否设置为可用以及是否启用了基于时间的显示限制。

要在客户端侧检索虚拟物品目录，请使用虚拟物品和货币方法组中目录子部分的方法。使用这些方法无需身份认证。

任务	API调用
按SKU获取虚拟物品。	在按SKU获取虚拟物品API调用中传入`item_sku`参数。
获取一个虚拟物品列表。	获取虚拟物品列表。
按照指定的组获取虚拟物品列表。	在按指定组获取商品列表API调用中传入`external_id`参数。
获取项目中的所有虚拟物品。	获取所有虚拟物品列表。