> ## 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.

# 製作遊戲第 2 部分 - Game Manager

> PlayFab Economy V2 製作遊戲教學課程第 2 部分：使用 Game Manager 建立您的工作室和遊戲，然後設定物品、商店和組合。

# 第 2 部分 - 使用 Game Manager

開始撰寫程式碼之前，我們需要了解 [Game Manager](https://developer.playfab.com) 並進行一些設定。

## 必要條件

1. [第 1 部分 - 環境設定](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-environment)
2. [PlayFab 開發人員帳戶](https://developer.playfab.com)。註冊是免費的。

## 步驟 1 - 建立您的工作室

成功登入 (或註冊) 之後，您現在就能建立全新的遊戲工作室！若要這樣做，您登入 [Game Manager](https://developer.playfab.com) 之後，就會看到 **New Studio** 按鈕。按一下之後，系統會提示您為工作室命名。您可以隨意命名。在此範例中，我們將其命名為「New Game Studio」。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-studio-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=fafdf7c8ab9c8bd148634bf69a510144" alt="New Studio 按鈕" width="2475" height="250" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-studio-button.png" />

建立**工作室**之後，您會在 **My Studios and Titles** 畫面中看到它，或是前往 [Game Manager](https://developer.playfab.com) 並登入也能看到。

## 步驟 2 - 建立您的遊戲

若要建立新的遊戲，請遵循下列步驟：

* 在 [Game Manager](https://developer.playfab.com) 的 **My Studios and Titles** 上，尋找 **Upgrade account button** 右側的三個點 (如果您已購買方案並連結至登入的帳戶，則只會看到三個點)，然後選取它。
* 選取之後，會開啟包含不同選項的功能表，請選擇 **New title**。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-title-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=1f766454b108ec7c5611112a0e7feadf" alt="New Title 按鈕" width="215" height="268" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-title-button.png" />

* 輸入遊戲的資訊，例如名稱、網站 URL 和遊戲標誌 (如果您已經有這些資訊)。如果沒有，別擔心，您隨時可以稍後再新增。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/create-title-screen.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=44be5379fc2b87ea4ff4a67d0a52ce41" alt="建立遊戲畫面" width="916" height="781" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/create-title-screen.png" />

* 選取 **Create title**
* 建立之後，您的遊戲現在會顯示在先前建立的工作室底下。它會以「卡片」的形式顯示，您可以在其中看到遊戲的標誌、名稱、方案和 ID，以及一個顯示為齒輪 ⚙️ 圖示的按鈕，可讓您前往其他遊戲設定。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/studio-with-title.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=037f3879654fc96a9c35b4fbb98b6752" alt="包含遊戲的遊戲工作室" width="1168" height="232" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/studio-with-title.png" />

## 步驟 3 - 取得您的遊戲 ID 和祕密金鑰

現在您已建立工作室和遊戲，接下來要取得您的遊戲 ID 和開發人員祕密金鑰。這兩者都會在您開始撰寫程式碼時使用，並作為開發環境中的連結點，指回執行驗證和交易的特定遊戲。

取得**遊戲 ID** 最簡單的方式，就是在工作室畫面中查看您的遊戲。在對應於您遊戲的卡片右下角，您會看到「ID」標籤，後面接著 5 位數的英數字元代碼，這就是您的 ID。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/title-id.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=be521565f7a37914e39d931b82204f3e" alt="遊戲 ID" width="1168" height="232" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/title-id.png" />

接著取得您的**開發人員祕密金鑰**：

* 登入 [Game Manager](https://developer.playfab.com)。
* 在工作室畫面中選取您的遊戲卡片。這會開啟遊戲的概觀頁面。
* 在左上角遊戲名稱旁，選取齒輪圖示 ⚙️。
* 選擇 **Title settings** 選項。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/title-settings-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=d6dcb179b78e02a7e2eb94f91f5c23ab" alt="Title Settings" width="475" height="357" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/title-settings-button.png" />

* 選取畫面頂端附近的 **Secret Keys** 導覽列選項。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/secret-keys-navbar.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=eb8a03f836ac1fcea83aa5d01973af18" alt="Secret Keys 導覽列選項" width="993" height="159" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/secret-keys-navbar.png" />

* 您會看到我們已自動為您產生一個名為 **Default Key** 的金鑰。這就是您的開發人員祕密金鑰，我們將在本教學課程的下一部分使用它來設定程式碼撰寫環境設定。

恭喜您完成到這裡！您現在應該已設定並妥善配置您的工作室和遊戲，同時手邊也有您的遊戲 ID 和開發人員祕密金鑰 (或至少知道需要時可以在哪裡取得)。

## 步驟 4 - 建立您的第一個物品

由於我們要建置的是製作遊戲，因此需要在 Game Manager 中建立物品，讓玩家一開始就能使用 (也讓您可以開始撰寫程式碼)。

### Game Manager

* 登入 [Game Manager](https://developer.playfab.com)。
* 前往 **My Studios and Titles** 頁面，然後選取您的遊戲以顯示儀表板。
* 從左側導覽功能表中，選取 **Engage** > **Economy**。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/engage-economy-menu.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=a9ebb5df1fc763340702b914994eb5ad" alt="Engage 區段下的 Economy 選項" width="235" height="226" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/engage-economy-menu.png" />

* 在 **Economy** 頁面上，選取 **Items** 索引標籤，然後選取 **New Item**。您也可以找到其他索引標籤，例如 **Currency**、**UGC**、**Bundles** 和 **Stores**。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=d3d8fb31667bdb48a26b1c67e53834e5" alt="New item 按鈕" width="2104" height="421" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-button.png" />

* 選取之後，系統會將您重新導向至一個表單，提示您新增新物品所需的詳細資料。在此畫面上，您也能設定物品的部分屬性，例如價格、檔案、影像，以及物品可在哪些平台上使用。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/create-item-screen.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=66d6ca488f5b81dfb6c6f9b083d8882b" alt="建立物品畫面" width="1876" height="1168" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/create-item-screen.png" />

* 新增所有必要資訊以及您想要為物品新增的任何其他資訊之後，在 New Item 畫面的底部附近，您會取得兩個不同的選項以繼續：**1. Save as draft**：這會建立草稿物品，它在您的遊戲中將無法使用 (即使透過搜尋、購買等方式也一樣)。**2. Save and publish**：這會立即儲存物品並發佈至您的遊戲，表示它可供搜尋、處於使用中，且可購買。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-save-options.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=c228f6f45b2dc9aa0c4a0008e213341c" alt="新物品儲存選項" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-save-options.png" />

儲存變更之後，物品現在會處於草稿狀態或已發佈狀態，視您的選擇而定。

### API

若要使用 PlayFab 的 API 建立物品，您必須使用 **catalog/createDraftitem** 下的 **CreateDraftItem** 呼叫。這與其他建立物品的範例運作方式類似，略有不同的是，除非另外指定，否則預設建立的物品最終會是草稿物品。

有一個 **Publish** 布林值，若為 true，物品會直接發佈，而不會儲存為草稿。

下列 JSON 是 **CreateDraftItem** 要求本文的範例。並非所有欄位都是必要的，因此您可以依需求/喜好隨意修剪該 JSON。

如需詳細資訊，請參閱 [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item)。

```json theme={null}
{
  "Item": {
    "Type": "ugc",
    "Title": {
      "NEUTRAL": "Neutral title",
      "en-US": "US English title"
    },
    "Description": {
      "NEUTRAL": "Neutral description",
      "en-US": "US English description"
    },
    "Keywords": {
      "NEUTRAL": {
        "Values": [
          "Keyword_1",
          "Keyword_2"
        ]
      }
    },
    "ContentType": "example item",
    "CreatorEntity": {
      "Id": "someId",
      "Type": "title_player_account",
      "TypeString": "title_player_account"
    },
    "IsHidden": false,
    "Tags": [
      "pirates",
      "holiday"
    ],
    "DisplayVersion": "1.0.0",
    "CreationDate": "2018-08-17T22:32:10.472Z",
    "Contents": [
      {
        "Id": "00000000-0000-0000-0000-000000000001",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000001/textures.zip",
        "MaxClientVersion": "2.4.1",
        "MinClientVersion": "2.0.0"
      }
    ],
    "Images": [
      {
        "Id": "00000000-0000-0000-0000-000000000003",
        "Type": "Thumbnail",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000003/splashscreen_thumb.jpg"
      }
    ],
    "DisplayProperties": {
      "mapDetails": {
        "mapType": "desertIsland",
        "gameMode": "capture",
        "maxPlayers": 16
      },
      "averageMatchLengthInSeconds": 947
    },
    "DefaultStackId": "Static_Default_Stack_Id"
  },
  "Publish": false
}
```

***

<Note>
  如需物品、庫存及其他 Economy 函式和術語的詳細資訊，請參閱我們的 [Economy V2 文件](/zh-TW/services/playfab/economy-monetization/economy-v2/overview)。
</Note>

## 步驟 5 - 使用目錄檢視和編輯您的物品

如果您回到左側導覽列中的 **Engage** > **Economy** (如同您在[步驟 4](#step-4---create-your-first-item) 中所做)，您會看到上述相同的選項/索引標籤清單。頁面預設為 **Items** 索引標籤，您會在其中取得另一個選項，可依 Published 或 Draft 篩選物品，並顯示所選類別中的所有物品。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/published-items.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=0cf510c53a77e887bf7993e9a29c28aa" alt="物品清單篩選器" width="2074" height="796" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/published-items.png" />

現在您可以在單一位置檢視/列出所有已發佈或草稿物品，您可以自由地個別編輯它們或大量刪除它們。若要刪除，請選取您要刪除的物品，然後按下 **Delete** 按鈕。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/delete-item.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=2966a320ccbffe027c937a22ce196d43" alt="刪除物品" width="420" height="290" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/delete-item.png" />

若要編輯物品，請選取物品的標題，這會帶您前往與前述 New Item 畫面相同的畫面，其中包含您在建立物品時 (或自上次更新以來) 可能新增的所有屬性和自訂欄位，並可讓您捲動至頁面底部並選取 **Edit draft item** 按鈕來自訂和儲存它們 (在 **Edit draft item** 按鈕旁邊，還會有一個 **Delete** 按鈕，這是刪除物品的另一種方式)。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-draft-item-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=dfb1b685ae0a6ead3c6852173f5dd390" alt="Edit draft item 按鈕" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-draft-item-button.png" />

## 步驟 6 - (提示) 讓物品可免費購買

<Tip>
  此步驟為選用，將說明我們建議讓物品可免費購買的其中一種方式。所使用的方法是建立新的「Free Item」，在您想要設為免費的物品中將其作為數量為 0 的價格。
</Tip>

<Note>
  您可能認為讓物品免費的方式，就是不為它設定價格。目前並非如此，如果您建立沒有價格的物品，我們會將其視為**無法購買**。
</Note>

若要建立可作為您想要設為免費之物品價格的「Free Item」，您必須遵循在[步驟 4](#step-4---create-your-first-item) 中採取的相同步驟，這就像建立「一般」物品一樣。您不需要過度考量為該物品新增的屬性或值，因為它不應是您遊戲中使用中的物品，其用途只是設定為價格。也不需要為它設定價格。

建立兩個物品 (「Free Item」以及您想要設為免費的物品) 之後，您必須編輯想要設為免費的物品，以便為其設定價格。若要這樣做，請從物品清單中選取所需的物品並選取其名稱，就像我們在[步驟 5](#step-5---use-catalog-to-view-and-edit-your-items) 中逐步說明的一樣，以前往物品編輯畫面。如果您向下捲動至底部並啟用 **Edit Mode**，「Prices」區段下方現在會有一個 **Add new price** 按鈕。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/add-new-price-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=742068c1ba7526ce97588b644a4142bf" alt="Add new price 按鈕" width="360" height="103" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/add-new-price-button.png" />

按一下 **Add new price** 之後，會彈出一個視窗，其中列出您目前的所有物品，供您選擇一個作為價格 (您也可以依「Items」、「UGC Items」和「Currencies」篩選)，並搜尋特定文字。在我們的案例中，那裡只有另一個物品，也就是「Free Item」(除非您已建立多個物品)。

如果您選取「Free Item」旁的「Add」選項，系統接著會提示您選取要作為價格的「Free Item」數量，若要將這個新物品設為免費，您必須將此值 (預設為 1) 變更為零。

完成價格設定之後，您必須儲存並發佈變更，這樣就完成了！此物品現在可免費購買！稍後我們會探討如何透過 C# 和直接 API 呼叫來購買物品 (即使是免費物品)。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/pick-item-currency.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=4b14d8585efbca567c767f27aa7f6e7c" alt="將免費物品新增為價格的步驟" width="1542" height="750" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/pick-item-currency.png" />

## 步驟 7 - 新增 FriendlyId

<Tip>
  這是另一個選用步驟，將說明如何編輯現有物品以新增 **FriendlyId**。如此一來，您就可以使用此 **FriendlyId** 來搜尋物品，而不是使用預設提供的冗長英數字元物品 ID。
</Tip>

若要新增 FriendlyId，您必須前往 **Economy** > **Items** 並選取所需的物品。選取之後，請啟用 **Edit mode**，以便對物品進行變更。

在下列螢幕擷取畫面中，您可以看到 **FriendlyId** 欄位 (以紅色醒目提示)。您可以在此為物品輸入更易記的名稱或 ID，它會立即連結至該特定物品。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-friendly-id.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=1c3b6871c59587e7e3961855a9734fd2" alt="編輯 Friendly Id" width="2077" height="1020" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-friendly-id.png" />


## Related topics

- [製作遊戲第 1 部分 - 設定](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-environment.md)
- [製作遊戲第 3 部分 - 撰寫程式碼](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-coding.md)
- [製作遊戲 - 背景](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context.md)
- [Economy v2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview.md)
- [透過 Steam Marketplace 兌換](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/steam.md)
