目錄概觀

本概觀說明 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： 實體建立者的唯一識別碼。在 Game Manager 中，此識別碼會設定為遊戲的值。
  • 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 目錄支援 草稿 物品狀態。當您選擇 Save as Draft 時，可透過直接呼叫取得物品中繼資料，但不會公開給公用搜尋。當您準備好將物品公開時，請將其設定為 已發佈 狀態。您可以在我們的物品狀態頁面上深入了解。

​

物品建立範例

若要建立 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 UGC 欄位

當您選取 Catalog V2、開啟 UGC 索引標籤，然後選擇 NEW ITEM 時，會開啟 New User Generated Content 頁面。 使用者產生的內容包含與 Catalog V2 物品欄位相同的所有欄位，再加上此欄位：

• MODERATION STATE
  • Moderation State： 將物品標示為已核准、等待審核或已拒絕的簡單方式。只能在已發佈的物品上修改 Moderation State。

​

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 訂閱