目录和目录列表
了解如何在 Unity IAP 中使用目录和目录列表，并选择定义列表的最佳方法。
阅读时间4 分钟最后更新于 3 个月前
在 Unity 应用内购中，IAP 目录包含玩家可以在应用程序中购买的所有数字商品，例如虚拟货币、新游戏关卡、付费功能或订阅。目录中的每个条目都是目录列表。
您可以通过以下方式定义目录：
方法 | 何时使用 | D2C 兼容？ |
|---|---|---|
| 以编程方式定义目录列表。 | 直接在脚本中定义目录。 | 是 |
| 通过 Editor 或 API 创建远程目录。 | 使用以下方法之一可以创建目录，从而无需客户端更新即可分发您的列表。 | 是 |
| 使用 Editor 中的 IAP Catalog 窗口。 | 如果要使用无代码 IAP，则需要此方法。 | 否 |
无论使用哪种方法，都可以在 Dashboard（后台）中导入现有目录，从而从 Dashboard（后台）管理、编辑和部署目录。
列出属性
您可以使用一组标准属性来定义每个目录列表，这些属性用于控制其行为及其对玩家和数字商店中的显示方式。以下是定义列表行为和呈现的一些关键属性。如需了解更多信息，请参阅目录架构。
目录列表 ID
Catalog Listing ID 是基础项的唯一跨平台标识符。此 ID 用于与应用商店通信，如果需要，可以用特定于商店的 ID 覆盖。Catalog Listing ID 只能包含小写字母、数字、下划线和句点。
商品类型
商品类型定义了如何购买商品以及是否可以恢复商品。以下产品类型可用：
Type（类型） | 描述 | 示例 | D2C 兼容？ |
|---|---|---|---|
| 消耗品 | 玩家可以多次购买的物品，使用后会耗尽。无法恢复消耗品。例如，虚拟货币或临时充值。 | 虚拟货币 - 保健药水 - 临时加电 | 是 |
| 非消耗品 | 玩家只能购买一次的物品。这些项是永久拥有的，可以在重新安装应用程序后恢复。例如，解锁新角色或删除广告。 | - 武器或盔甲 - 访问额外内容 - 无广告 | 是 |
| 订阅 | 授予在设定时间段内访问内容或功能的项。例如，每月 VIP 访问权限或战斗通行证。 | - 在线游戏的每月访问 - 授予每日奖励的 VIP 身份 - 免费试用 | 否 |
付款
Payout 属性（可选）指定玩家在成功购买后收到的内容，例如 100 金币。指定付款以将每笔交易与特定商品和数量关联，例如 100 金币。Payouts 属性简化了游戏内库存管理，并确保玩家在购买时获得正确的奖励或物品。
要实现编码的 IAP，请调用 在脚本中访问目录。对于无代码的 IAP，目录会自动集成，因此无需执行任何其他操作。如果您希望在代码中定义自己的目录，Unity 还提供可选的 类，这有助于简化创建自定义目录的过程。
ProductCatalog.LoadDefaultCatalogCatalogProvider