目录概览

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

​

什么是目录？

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

​

物品字段参考

本节介绍 Game Manager 中 Economy 区域下 Catalog V2 部分的每个字段。 首次创建游戏时，你的目录是空的。除非你创建物品，否则你不会在 Catalog 部分看到任何物品。 Catalog v2 部分包含以下选项卡： 其中每一项都是可以在目录中使用的物品类型。

​

Catalog V2 物品字段

当你选择 Catalog V2、Items 选项卡，然后选择 NEW ITEM 时，你将看到以下页面： New Item 页面包含以下字段。除非特别说明，这些字段均为可选：

• PROPERTIES
  • Creator Entity Type： 一个系统创建的字段，用于告知你实体创建者的类型。
  • Creator Entity ID： 实体创建者的唯一 ID。在 Game Manager 中，此 ID 被设置为游戏的值。
  • Friendly ID： 一个可以在代码中方便引用的字段。Friendly ID 对所有物品都是可选的，并且在目录中必须是唯一的。
  • Title： 一个必填字段，用于物品的通用名称，通常显示给玩家。Title 支持使用区域设置键进行简单本地化。有关更多信息，请参阅 Economy V2 本地化。
  • Default Stack ID： 物品可以以堆栈形式存储在库存中，每个堆栈都有自己的数量并由 StackId 区分。如果未定义，库存操作将使用 default 作为 StackId。有关更多信息，请参阅 Economy 堆栈。
  • Keywords： 关键词可用于基本搜索过滤。它们是 JSON 格式的本地化关键词字典。有关示例，请参阅 Economy V2 本地化。
  • 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 目录支持草稿物品状态。当你 保存为草稿 时，物品元数据可通过直接调用获取，但不会暴露给公共搜索。当你准备将物品公开时，可将其设置为已发布状态。有关更多信息，请参阅我们的 物品状态 页面。

​

物品创建示例

要创建 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 UGC 字段

当你选择 Catalog V2、打开 UGC 选项卡，然后选择 NEW ITEM 时，你将打开 New User Generated Content 页面。 用户生成内容包含与 Catalog V2 物品字段相同的所有字段，外加此字段：

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

​

Catalog V2 捆绑包字段

当你选择 Catalog V2、打开 Bundles 选项卡，然后选择 NEW BUNDLE 时，你将打开 New Bundle 页面。 此页面包含 Catalog V2 物品字段中的所有字段，外加这些字段：

• ITEMS
  • Add： 捆绑包允许你将多个物品分组为一个单一物品。你可以创建通常一起购买的物品捆绑包，或仅在有限时间内可用的物品捆绑包。有关更多信息，请参阅我们关于 Economy V2 捆绑包 的文档。
• MARKETPLACE MAPPING
  • Marketplace、Marketplace ID： 你可以将你的游戏内物品链接到一个或多个市场物品，以用于兑换场景。有关更多信息，请参阅我们关于 Economy V2 内购 的文档。

​

Catalog V2 商店字段

当你选择 Catalog V2、打开 Stores 选项卡，然后选择 NEW STORE 时，你将打开 New Store 页面。 商店包含 Catalog V2 物品字段中的所有相同字段，外加此字段：

• ITEMS
  • Add： 商店可以包含目录中的任何其他物品类型。所有目录内容将保留其基础成本，或可以从此商店以此处列出的价格购买。有关更多信息，请参阅我们关于 Economy V2 商店 的文档。

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

​

另请参阅

• PlayFab Economy V2 物品
• PlayFab Economy V2 货币
• PlayFab Economy V2 UGC
• PlayFab Economy V2 捆绑包
• PlayFab Economy V2 商店
• PlayFab Economy V2 订阅