> ## 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 處於維護模式，不會再推出任何新功能，只會進行錯誤修正。\*\*v1 API 在可預見的未來仍會持續維護。\*\*請參閱 [Economy v2 概觀](/zh-TW/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 物品](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview) |
| **Currency** | 虛擬貨幣可用來購買其他目錄物品。 | [PlayFab Economy V2 貨幣](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/currencies) |
| **UGC** | 使用者建立的物品。 | [PlayFab Economy V2 UGC](/zh-TW/services/playfab/economy-monetization/economy-v2/ugc) |
| **Bundles** | 物品和虛擬貨幣的集合，在授與時會拆開至玩家的庫存。組合可以使用 Marketplace Mapping 欄位連結至真實世界的購買。 | [PlayFab Economy V2 組合](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/bundles) |
| **Stores** | 商店可讓您覆寫物品的基本目錄價格。 | [PlayFab Economy V2 商店](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/stores) |
| **Subscriptions** | 虛擬訂閱可讓您授與耐久性商品的限時存取權。 | [PlayFab Economy V2 訂閱](/zh-TW/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 - 目錄 - 新增目錄物品" 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**：
    實體建立者的唯一識別碼。在 Game Manager 中，此識別碼會設定為遊戲的值。
  * **Friendly ID**：
    可在程式碼中更容易參考的欄位。所有物品的 Friendly ID 都是選擇性的，且在目錄中必須是唯一的。
  * **Title**：
    **必要**欄位，用於物品的通用名稱，通常會向玩家顯示。透過使用地區設定索引鍵，可支援 **Title** 的簡單當地語系化。如需詳細資訊，請參閱 [Economy V2 當地語系化](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/localization)。
  * **Default Stack ID**：
    物品可以堆疊的形式儲存在庫存中，每個堆疊都有自己的數量，並以 StackId 區分。若未定義，庫存動作會使用 *default* 作為 StackId。如需詳細資訊，請參閱 [Economy 堆疊](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/stacks)。
  * **Keywords**：
    關鍵字可用於基本搜尋篩選。它們是 JSON 格式的當地語系化關鍵字字典。如需範例，請參閱 [Economy V2 當地語系化](/zh-TW/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 目錄支援 **草稿** 物品狀態。當您選擇 *Save as Draft* 時，可透過直接呼叫取得物品中繼資料，但不會公開給公用搜尋。當您準備好將物品公開時，請將其設定為 **已發佈** 狀態。您可以在我們的[物品狀態](/zh-TW/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** 按鈕，這會將您帶回 Items 頁面。
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**：
    將物品標示為已核准、等待審核或已拒絕的簡單方式。只能在已發佈的物品上修改 Moderation State。

### Catalog V2 組合欄位

當您選取 **Catalog V2**、開啟 **Bundles** 索引標籤，然後選擇 **NEW BUNDLE** 時，會開啟 **New Bundle** 頁面。

此頁面包含 [Catalog V2 物品欄位](#catalog-v2-item-fields)中的所有欄位，*再加上*這些欄位：

* **ITEMS**
  * **Add**：
    組合可讓您將多個物品分組成單一物品。您可以為經常一起購買的物品，或僅在限定時間內提供的物品建立組合。如需詳細資訊，請參閱我們的 [Economy V2 組合](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/bundles)文件。

* **MARKETPLACE MAPPING**
  * **Marketplace**、**Marketplace ID**：
    您可以將遊戲內物品連結至一或多個市集物品，以用於兌換案例。如需詳細資訊，請參閱我們的 [Economy V2 應用程式內購買](/zh-TW/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 商店](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/stores)文件。

我們希望您發現新的目錄是一項強大且彈性的工具，可為玩家打造引人入勝且有收穫的體驗。若要深入了解，請仔細閱讀 [Economy V2 快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart)。

### 另請參閱

* [PlayFab Economy V2 物品](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview)
* [PlayFab Economy V2 貨幣](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/currencies)
* [PlayFab Economy V2 UGC](/zh-TW/services/playfab/economy-monetization/economy-v2/ugc)
* [PlayFab Economy V2 組合](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [PlayFab Economy V2 商店](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [PlayFab Economy V2 訂閱](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)


## Related topics

- [多人遊戲工作階段目錄概觀](/zh-TW/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [配對概觀](/zh-TW/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview.md)
- [XBOX 服務多人遊戲概觀](/zh-TW/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [目標工作階段初始化和 QoS](/zh-TW/services/xbox-services/multiplayer/matchmaking/concepts/live-matchmaking-target-session.md)
- [在 Partner Center 中設定配對](/zh-TW/services/xbox-services/multiplayer/matchmaking/config/live-matchmaking-config.md)