跳轉到主要內容
遊戲資料是一組純文字索引鍵/值組,用於在伺服器上遠端儲存和管理遊戲的設定資料。它可讓遊戲層級的設定變數保持可存取且井然有序,並可在用戶端擷取。 本快速入門說明如何以程式設計方式建立和使用遊戲資料。 這是一個重要的主題,因為將遊戲的設定資料遠端儲存在伺服器上 (可以隨時變更),是使用 PlayFab 這類服務最基本的原因之一。

取得遊戲資料

從遊戲用戶端

使用 PlayFabClientAPI 中的 GetTitleData 取得特定遊戲的 KVP。下列程式碼範例會顯示所有遊戲資料的值。

從遊戲伺服器

使用 PlayFabServerAPI 中的 GetTitleData 取得特定遊戲的 KVP。下列程式碼範例會顯示所有遊戲資料的值。

設定遊戲資料

遊戲資料不太可能非常頻繁地變更。在大多數情況下,您應該將遊戲資料用於在遊戲生命週期中大部分時間都不會變更的靜態資料。 您可以使用 Game Manager 或伺服器 API 函式設定遊戲資料。

使用 Game Manager 設定遊戲資料

若要使用 Game Manager 將主要遊戲資料新增至遊戲,請執行下列步驟。
  1. 在 Game Manager 中開啟遊戲。
  2. 選取 Content,然後選取 Title Data。
  3. 選取 New Title Data
  4. 在新遊戲資料頁面中,輸入 Key 的值和 Value 的值。Key 和 Value 都會儲存為字串。
  5. 使用 Save 按鈕儲存新的資料項目。
螢幕擷取畫面顯示新的遊戲資料。 遊戲資料的螢幕擷取畫面

在 C# 中呼叫伺服器 API 設定遊戲資料

SetTitleData API 是您必須從專用伺服器呼叫的伺服器 API。每次呼叫 SetTitleData 只能設定一個遊戲資料 KVP。

使用 Game Manager 設定遊戲資料覆寫

覆寫也是一組 JSON 索引鍵/值組,理想上應用於包含主要遊戲資料之索引鍵/值組所需的差異變更。與主要遊戲資料相比,差異變更可以包括新的索引鍵/值、現有索引鍵值的變更,或索引鍵的刪除 (以 NULL 作為值的輸入)。 若要將覆寫新增至主要遊戲資料,請執行下列步驟。
  1. 在 Game Manager 中開啟遊戲。
  2. 選取 Content,然後選取 Title Data。
  3. 選取 New Override。
  4. 輸入覆寫標籤,並輸入 Key 的值和 Value 的值。Key 和 Value 都會儲存為字串。
  5. 使用 Save 按鈕儲存新的遊戲資料覆寫。
此覆寫的索引鍵/值組集合目前只有在使用實驗時才會生效。
如果玩家屬於包含遊戲資料覆寫的實驗變體,覆寫會在伺服器端自動套用,並在用戶端與遊戲資料一起傳回。
遊戲資料覆寫值最多可能需要一分鐘才能重新整理並保存。
螢幕擷取畫面顯示新的遊戲資料覆寫。 螢幕擷取畫面顯示如何設定新的遊戲資料覆寫。 螢幕擷取畫面顯示遊戲資料和覆寫。

內部遊戲資料

與使用者資料類似,遊戲資料也有對用戶端隱藏的內部儲存。此資料也可以在 Game Manager 中或透過伺服器 API 設定。

在 C# 中呼叫伺服器 API 取得內部遊戲資料

在 C# 中呼叫伺服器 API 設定內部遊戲資料

另請參閱

最後修改於 2026年10月8日