> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 目录概览

> Game Manager 中 PlayFab Economy v2 目录的概览，包括目录物品、定价、权限以及如何发布游戏内容。

<Info>
  Economy v1 API 处于维护模式，将不再接收任何新功能，只有 bug 修复。**v1 API 将在可预见的未来内继续维护。** 请参阅 [Economy v2 概览](/services/playfab/economy-monetization/economy-v2/overview) 以了解 PlayFab Economy 下一版本的更多信息！
</Info>

本概览介绍了 **Game Manager** 中 **Economy** 部分的 **Catalog V2** 选项卡。它描述了 PlayFab Economy V2 中的目录功能，并详细介绍了各种物品类型的所有字段属性。

## 什么是目录？

目录用于定义玩家可以购买或可以奖励给玩家的物品。许多游戏为玩家提供可购买的物品，例如护盾、关卡解锁或增强道具。这些物品在目录中指定，通常以虚拟货币或真钱出售。PlayFab 的目录提供了一种简便的方式来管理游戏的虚拟物品，并可以容纳游戏中所有可用的物品。

## 物品字段参考

本节介绍 **Game Manager** 中 **Economy** 区域下 **Catalog V2** 部分的每个字段。

首次创建游戏时，你的目录是空的。除非你创建物品，否则你不会在 **Catalog** 部分看到任何物品。

**Catalog v2** 部分包含以下选项卡：

| 选项卡               | 描述                                                                 | 参考                                                                                                                |
| ----------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **Items**         | 具有虚拟货币或真钱价值、可购买或奖励的物品。                                             | [PlayFab Economy V2 物品](/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview) |
| **Currency**      | 虚拟货币可用于购买其他目录物品。                                                   | [PlayFab Economy V2 货币](/services/playfab/economy-monetization/economy-v2/tutorials/currencies)                   |
| **UGC**           | 用户创建的物品。                                                           | [PlayFab Economy V2 UGC](/services/playfab/economy-monetization/economy-v2/ugc)                                   |
| **Bundles**       | 物品和虚拟货币的集合，授予时会拆包到玩家的库存中。捆绑包可以使用 Marketplace Mapping 字段链接到真实世界的购买。 | [PlayFab Economy V2 捆绑包](/services/playfab/economy-monetization/economy-v2/catalog/bundles)                       |
| **Stores**        | 商店允许你覆盖物品的基础目录价格。                                                  | [PlayFab Economy V2 商店](/services/playfab/economy-monetization/economy-v2/catalog/stores)                         |
| **Subscriptions** | 虚拟订阅允许你授予对耐久物品的基于时间的访问权限。                                          | [PlayFab Economy V2 订阅](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)。                 |

其中每一项都是可以在目录中使用的物品类型。

### Catalog V2 物品字段

当你选择 **Catalog V2**、**Items** 选项卡，然后选择 **NEW ITEM** 时，你将看到以下页面：

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/playfab-economy-v2-item-details.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=dc355abd7646e672180aaabb0a74ab40" alt="Game Manager - Economy - Catalogs- New Catalog Item" width="1193" height="1263" data-path="images/playfab/economy-monetization/economy-v2/playfab-economy-v2-item-details.png" />

**New Item** 页面包含以下字段。除非**特别说明**，这些字段均为可选：

* **PROPERTIES**
  * **Creator Entity Type**：
    一个**系统创建**的字段，用于告知你实体创建者的类型。
  * **Creator Entity ID**：
    实体创建者的唯一 ID。在 Game Manager 中，此 ID 被设置为游戏的值。
  * **Friendly ID**：
    一个可以在代码中方便引用的字段。Friendly ID 对所有物品都是可选的，并且在目录中必须是唯一的。
  * **Title**：
    一个**必填**字段，用于物品的通用名称，通常显示给玩家。**Title** 支持使用区域设置键进行简单本地化。有关更多信息，请参阅 [Economy V2 本地化](/services/playfab/economy-monetization/economy-v2/catalog/localization)。
  * **Default Stack ID**：
    物品可以以堆栈形式存储在库存中，每个堆栈都有自己的数量并由 StackId 区分。如果未定义，库存操作将使用 *default* 作为 StackId。有关更多信息，请参阅 [Economy 堆栈](/services/playfab/economy-monetization/economy-v2/inventory/stacks)。
  * **Keywords**：
    关键词可用于基本搜索过滤。它们是 JSON 格式的本地化关键词字典。有关示例，请参阅 [Economy V2 本地化](/services/playfab/economy-monetization/economy-v2/catalog/localization)。
  * **Description**：
    JSON 格式的本地化物品描述字典。
  * **Content Type**：
    你可以使用此下拉列表选择物品内容类型。内容类型在目录设置 (Title Settings > Economy) 中定义。
  * **Display Properties**：
    一个可用于自定义物品属性的 JSON blob。
  * **Display Version**：
    可用于为 Display Properties 添加版本的字段。
  * **Tags**：
    此字段包含可用于整理目录物品以便搜索的标签。标签可以以逗号分隔的文本字符串输入。这些字符串在目录设置 (Title Settings > Economy) 中预定义。
  * **Available Tags**
    用于选择已在目录配置中定义的物品标签的便捷下拉列表。
  * **OPTIONS**
    * **Hidden**：
      目前此部分中列出的物品有一个可用选项。此选项 **Hidden** 会使物品无法通过搜索暴露。
  * **Start Date**：
    一个**必填**的日期字段，指定物品在搜索中何时可用。
  * **End Date**：
    一个日期字段，用于指定物品何时应在搜索中不可用。
* **PRICES**
  * **Add New Price**：
    你可以使用此部分为物品指定一个或多个购买价格。
* **FILES**
  * **Upload**：
    在此你可以上传要存储在公共目录中并与此物品关联的内容。
* **IMAGES**
  * **Upload**：
    在此你可以上传各种图片，包括缩略图和屏幕截图，用于游戏内目录中的物品展示。
* **PLATFORMS**
  * **Manage**：
    你可以指定此物品适用于哪些平台。平台列表在目录设置 (Title Settings > Economy) 中定义。

### 将物品保存为草稿或已发布状态

Economy V2 目录支持**草稿**物品状态。当你 *保存为草稿* 时，物品元数据可通过直接调用获取，但不会暴露给公共搜索。当你准备将物品公开时，可将其设置为**已发布**状态。有关更多信息，请参阅我们的 [物品状态](/services/playfab/economy-monetization/economy-v2/catalog/item-status) 页面。

## 物品创建示例

要创建 **Item**：

1. 打开 **Game Manager** 并选择左侧边栏中的 **Economy**。
2. 选择 **Catalogs V2** 选项卡。
3. 选择 **NEW ITEM** 按钮。
   1. 填写必填的物品字段：
      * **Title** (JSON 例如 \{"NEUTRAL":"My New Amazing Item"})。
      * **Start Date**（选择今天的日期）。
4. 选择 **SAVE AND PUBLISH** 按钮，这会将你带回物品页面。
5. 要添加更多物品，选择 **NEW ITEM** 并重复步骤 3 – 5。

### Catalog V2 货币字段

当你选择 **Catalog V2**、打开 **Currency** 选项卡，然后选择 **NEW CURRENCY** 时，你将打开 **New Currency** 页面。

货币包含与 [Catalog V2 物品字段](#catalog-v2-item-fields)相同的所有字段。

### Catalog V2 UGC 字段

当你选择 **Catalog V2**、打开 **UGC** 选项卡，然后选择 **NEW ITEM** 时，你将打开 **New User Generated Content** 页面。

用户生成内容包含与 [Catalog V2 物品字段](#catalog-v2-item-fields)相同的所有字段，*外加*此字段：

* **MODERATION STATE**
  * **Moderation State**：
    一种简便的方式，将物品标记为 Approved、Awaiting Moderation 或 Rejected。审核状态只能在已发布物品上修改。

### Catalog V2 捆绑包字段

当你选择 **Catalog V2**、打开 **Bundles** 选项卡，然后选择 **NEW BUNDLE** 时，你将打开 **New Bundle** 页面。

此页面包含 [Catalog V2 物品字段](#catalog-v2-item-fields)中的所有字段，*外加*这些字段：

* **ITEMS**
  * **Add**：
    捆绑包允许你将多个物品分组为一个单一物品。你可以创建通常一起购买的物品捆绑包，或仅在有限时间内可用的物品捆绑包。有关更多信息，请参阅我们关于 [Economy V2 捆绑包](/services/playfab/economy-monetization/economy-v2/catalog/bundles) 的文档。

* **MARKETPLACE MAPPING**
  * **Marketplace**、**Marketplace ID**：
    你可以将你的游戏内物品链接到一个或多个市场物品，以用于兑换场景。有关更多信息，请参阅我们关于 [Economy V2 内购](/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android) 的文档。

### Catalog V2 商店字段

当你选择 **Catalog V2**、打开 **Stores** 选项卡，然后选择 **NEW STORE** 时，你将打开 **New Store** 页面。

商店包含 [Catalog V2 物品字段](#catalog-v2-item-fields)中的所有相同字段，*外加*此字段：

* **ITEMS**
  * **Add**：
    商店可以包含目录中的任何其他物品类型。所有目录内容将保留其基础成本，或可以从此商店以此处列出的价格购买。有关更多信息，请参阅我们关于 [Economy V2 商店](/services/playfab/economy-monetization/economy-v2/catalog/stores) 的文档。

我们希望你会发现新的目录是一个强大而灵活的工具，可以为你的玩家创造引人入胜且有回报的体验。要了解更多信息，请仔细查看 [Economy V2 快速入门](/services/playfab/economy-monetization/economy-v2/quickstart)。

### 另请参阅

* [PlayFab Economy V2 物品](/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview)
* [PlayFab Economy V2 货币](/services/playfab/economy-monetization/economy-v2/tutorials/currencies)
* [PlayFab Economy V2 UGC](/services/playfab/economy-monetization/economy-v2/ugc)
* [PlayFab Economy V2 捆绑包](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [PlayFab Economy V2 商店](/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [PlayFab Economy V2 订阅](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)


## Related topics

- [物品和库存概览](/zh-CN/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [多人游戏会话目录概述](/zh-CN/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XBOX Series X|S 概览](/zh-CN/paths/series-xs/overview.md)
- [XBOX 认证概览](/zh-CN/publishing/certification/overview.md)
- [Economy v2 概览](/zh-CN/services/playfab/economy-monetization/economy-v2/overview.md)