實體移轉資訊 - XBOX Game Development Documentation

實體 API 引進了新的存取模式，旨在減輕目前帳戶和資料系統的痛點。如果您先前使用下列方法為遊戲、玩家或角色資訊實作資料管理，此處提供的資訊會對您有所幫助。遊戲存取：

client/GetTitleData
admin/GetTitleData
server/GetTitleData

玩家存取：

角色存取：

client/GetCharacterData
client/UpdateCharacterData

使用實體 API，您可以呼叫單一方法來儲存 title、player 和 character 實體類型的資料值。此 API 提供的存取規則可複製並擴充目前自訂資料的系統行為，並提供更好的介面。在某些方面，這些變更不具回溯相容性。不過，您可以新增對實體 API 的呼叫，而不會改變現有 API 的行為。

用語

下表說明與實體 API 相關的用語調整。

用語	描述
title	此概念未變更。您的遊戲可能包含可供所有玩家使用的全域資訊。這類似於 TitleData。它由遊戲/應用程式的遊戲識別碼 (`TitleId`) 識別。
master_player_account	此實體類型可讓您在命名空間中的多個遊戲之間共用玩家的相關資訊。這類似於 UserPublisherData。它由玩家的玩家識別碼 (`PlayFabId`) 識別，此識別碼會在任何登入或任何擷取玩家帳戶之帳戶資訊的呼叫中傳回 (例如 PlayFab Client API GetAccountInfo)。
title_player_account	此概念以現有 API 方法中的使用者/玩家為基礎。每位玩家都可以包含目前遊戲的一些資訊。這類似於 GetUserData 方法。它由您在任何將 `LoginTitlePlayerAccountEntity` 指定為 `True` 的登入中，於 EntityKey 物件內取回的實體識別碼 (`EntityKey.Id`) 識別。
character	此概念未變更。您的玩家可能擁有角色，每個角色都可以包含一些資訊。這類似於 CharacterData。它由角色的角色識別碼 (`CharacterId`) 識別。
PlayFabId	此用語先前同時涵蓋 `master_player_account` 和 `title_player_account` 概念。將這些概念分開可簡化並釐清功能。玩家可以與同一命名空間中的多個遊戲互動。玩家可以在每個遊戲的不同 `title_player_account` 中擁有獨特資訊，並擁有單一 `master_player_account`，其中包含跨遊戲共用的資料。這樣就能實現遊戲的交叉推廣和跨遊戲獎勵。

另請參閱

PlayFab 部落格上的 Introducing Entities, Objects and Files。
實體快速入門

最後修改於 2026年10月8日

相關主題

實體快速入門從 PlayFab 獨立 SDK v1 移轉至 Unified SDK v2 移轉仲裁者觸控調整套件 (TAK) 參考實體 API 重新架構升級教學課程

⌘I