跳轉到主要內容

第 2 部分 - 使用 Game Manager

開始撰寫程式碼之前,我們需要了解 Game Manager 並進行一些設定。

必要條件

  1. 第 1 部分 - 環境設定
  2. PlayFab 開發人員帳戶。註冊是免費的。

步驟 1 - 建立您的工作室

成功登入 (或註冊) 之後,您現在就能建立全新的遊戲工作室!若要這樣做,您登入 Game Manager 之後,就會看到 New Studio 按鈕。按一下之後,系統會提示您為工作室命名。您可以隨意命名。在此範例中,我們將其命名為「New Game Studio」。 New Studio 按鈕 建立工作室之後,您會在 My Studios and Titles 畫面中看到它,或是前往 Game Manager 並登入也能看到。

步驟 2 - 建立您的遊戲

若要建立新的遊戲,請遵循下列步驟:
  • 在 Game Manager 的 My Studios and Titles 上,尋找 Upgrade account button 右側的三個點 (如果您已購買方案並連結至登入的帳戶,則只會看到三個點),然後選取它。
  • 選取之後,會開啟包含不同選項的功能表,請選擇 New title。
New Title 按鈕
  • 輸入遊戲的資訊,例如名稱、網站 URL 和遊戲標誌 (如果您已經有這些資訊)。如果沒有,別擔心,您隨時可以稍後再新增。
建立遊戲畫面
  • 選取 Create title
  • 建立之後,您的遊戲現在會顯示在先前建立的工作室底下。它會以「卡片」的形式顯示,您可以在其中看到遊戲的標誌、名稱、方案和 ID,以及一個顯示為齒輪 ⚙️ 圖示的按鈕,可讓您前往其他遊戲設定。
包含遊戲的遊戲工作室

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

現在您已建立工作室和遊戲,接下來要取得您的遊戲 ID 和開發人員祕密金鑰。這兩者都會在您開始撰寫程式碼時使用,並作為開發環境中的連結點,指回執行驗證和交易的特定遊戲。 取得遊戲 ID 最簡單的方式,就是在工作室畫面中查看您的遊戲。在對應於您遊戲的卡片右下角,您會看到「ID」標籤,後面接著 5 位數的英數字元代碼,這就是您的 ID。 遊戲 ID 接著取得您的開發人員祕密金鑰:
  • 登入 Game Manager。
  • 在工作室畫面中選取您的遊戲卡片。這會開啟遊戲的概觀頁面。
  • 在左上角遊戲名稱旁,選取齒輪圖示 ⚙️。
  • 選擇 Title settings 選項。
Title Settings
  • 選取畫面頂端附近的 Secret Keys 導覽列選項。
Secret Keys 導覽列選項
  • 您會看到我們已自動為您產生一個名為 Default Key 的金鑰。這就是您的開發人員祕密金鑰,我們將在本教學課程的下一部分使用它來設定程式碼撰寫環境設定。
恭喜您完成到這裡!您現在應該已設定並妥善配置您的工作室和遊戲,同時手邊也有您的遊戲 ID 和開發人員祕密金鑰 (或至少知道需要時可以在哪裡取得)。

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

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

Game Manager

  • 登入 Game Manager。
  • 前往 My Studios and Titles 頁面,然後選取您的遊戲以顯示儀表板。
  • 從左側導覽功能表中,選取 Engage > Economy。
Engage 區段下的 Economy 選項
  • 在 Economy 頁面上,選取 Items 索引標籤,然後選取 New Item。您也可以找到其他索引標籤,例如 Currency、UGC、Bundles 和 Stores。
New item 按鈕
  • 選取之後,系統會將您重新導向至一個表單,提示您新增新物品所需的詳細資料。在此畫面上,您也能設定物品的部分屬性,例如價格、檔案、影像,以及物品可在哪些平台上使用。
建立物品畫面
  • 新增所有必要資訊以及您想要為物品新增的任何其他資訊之後,在 New Item 畫面的底部附近,您會取得兩個不同的選項以繼續:1. Save as draft:這會建立草稿物品,它在您的遊戲中將無法使用 (即使透過搜尋、購買等方式也一樣)。2. Save and publish:這會立即儲存物品並發佈至您的遊戲,表示它可供搜尋、處於使用中,且可購買。
新物品儲存選項 儲存變更之後,物品現在會處於草稿狀態或已發佈狀態,視您的選擇而定。

API

若要使用 PlayFab 的 API 建立物品,您必須使用 catalog/createDraftitem 下的 CreateDraftItem 呼叫。這與其他建立物品的範例運作方式類似,略有不同的是,除非另外指定,否則預設建立的物品最終會是草稿物品。 有一個 Publish 布林值,若為 true,物品會直接發佈,而不會儲存為草稿。 下列 JSON 是 CreateDraftItem 要求本文的範例。並非所有欄位都是必要的,因此您可以依需求/喜好隨意修剪該 JSON。 如需詳細資訊,請參閱 CreateDraftItem。

如需物品、庫存及其他 Economy 函式和術語的詳細資訊,請參閱我們的 Economy V2 文件。

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

如果您回到左側導覽列中的 Engage > Economy (如同您在步驟 4 中所做),您會看到上述相同的選項/索引標籤清單。頁面預設為 Items 索引標籤,您會在其中取得另一個選項,可依 Published 或 Draft 篩選物品,並顯示所選類別中的所有物品。 物品清單篩選器 現在您可以在單一位置檢視/列出所有已發佈或草稿物品,您可以自由地個別編輯它們或大量刪除它們。若要刪除,請選取您要刪除的物品,然後按下 Delete 按鈕。 刪除物品 若要編輯物品,請選取物品的標題,這會帶您前往與前述 New Item 畫面相同的畫面,其中包含您在建立物品時 (或自上次更新以來) 可能新增的所有屬性和自訂欄位,並可讓您捲動至頁面底部並選取 Edit draft item 按鈕來自訂和儲存它們 (在 Edit draft item 按鈕旁邊,還會有一個 Delete 按鈕,這是刪除物品的另一種方式)。 Edit draft item 按鈕

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

此步驟為選用,將說明我們建議讓物品可免費購買的其中一種方式。所使用的方法是建立新的「Free Item」,在您想要設為免費的物品中將其作為數量為 0 的價格。
您可能認為讓物品免費的方式,就是不為它設定價格。目前並非如此,如果您建立沒有價格的物品,我們會將其視為無法購買。
若要建立可作為您想要設為免費之物品價格的「Free Item」,您必須遵循在步驟 4 中採取的相同步驟,這就像建立「一般」物品一樣。您不需要過度考量為該物品新增的屬性或值,因為它不應是您遊戲中使用中的物品,其用途只是設定為價格。也不需要為它設定價格。 建立兩個物品 (「Free Item」以及您想要設為免費的物品) 之後,您必須編輯想要設為免費的物品,以便為其設定價格。若要這樣做,請從物品清單中選取所需的物品並選取其名稱,就像我們在步驟 5 中逐步說明的一樣,以前往物品編輯畫面。如果您向下捲動至底部並啟用 Edit Mode,「Prices」區段下方現在會有一個 Add new price 按鈕。 Add new price 按鈕 按一下 Add new price 之後,會彈出一個視窗,其中列出您目前的所有物品,供您選擇一個作為價格 (您也可以依「Items」、「UGC Items」和「Currencies」篩選),並搜尋特定文字。在我們的案例中,那裡只有另一個物品,也就是「Free Item」(除非您已建立多個物品)。 如果您選取「Free Item」旁的「Add」選項,系統接著會提示您選取要作為價格的「Free Item」數量,若要將這個新物品設為免費,您必須將此值 (預設為 1) 變更為零。 完成價格設定之後,您必須儲存並發佈變更,這樣就完成了!此物品現在可免費購買!稍後我們會探討如何透過 C# 和直接 API 呼叫來購買物品 (即使是免費物品)。 將免費物品新增為價格的步驟

步驟 7 - 新增 FriendlyId

這是另一個選用步驟,將說明如何編輯現有物品以新增 FriendlyId。如此一來,您就可以使用此 FriendlyId 來搜尋物品,而不是使用預設提供的冗長英數字元物品 ID。
若要新增 FriendlyId,您必須前往 Economy > Items 並選取所需的物品。選取之後,請啟用 Edit mode,以便對物品進行變更。 在下列螢幕擷取畫面中,您可以看到 FriendlyId 欄位 (以紅色醒目提示)。您可以在此為物品輸入更易記的名稱或 ID,它會立即連結至該特定物品。 編輯 Friendly Id
最後修改於 2026年10月6日