Entities 迁移信息 - XBOX Game Development Documentation

Entity API 引入了新的访问模式，旨在缓解当前 account 和 data 系统的痛点。如果你之前使用以下方法来实现 Title、Player 或 Character 信息的数据管理，此处提供的信息将很有用。 Title 访问：

client/GetTitleData
admin/GetTitleData
server/GetTitleData

Player 访问：

Character 访问：

client/GetCharacterData
client/UpdateCharacterData

使用 entities API，你可以调用单个方法来保存 title、player 和 character 实体类型的数据值。该 API 提供的访问规则以更好的接口复制并扩展了自定义数据的当前系统行为。在某些方面，这些更改不向后兼容。但是，你可以在不更改现有 API 行为的情况下添加对 entity API 的调用。

术语

下表描述了与 entity API 相关的术语细化。

术语	描述
title	此概念保持不变。你的 title 可能包含对所有玩家可用的全局信息。这类似于 TitleData。它由游戏/应用程序的 title ID (`TitleId`) 标识。
master_player_account	此实体 Type 允许你在工作室内的多个游戏之间共享有关某位玩家的信息。这类似于 UserPublisherData。它由玩家的 player ID (`PlayFabId`) 标识，该 ID 会作为任何登录或任何检索玩家账户信息的调用（例如 PlayFab Client API GetAccountInfo）的一部分返回。
title_player_account	此概念基于现有 API 方法中的 user/player。每位玩家都可以包含当前 title 的一些信息。这类似于 GetUserData 方法。它由 entity ID (`EntityKey.Id`) 标识，你在指定 `LoginTitlePlayerAccountEntity` 为 `True` 的任何登录中都可以在 EntityKey 对象上获得该 ID。
character	此概念保持不变。你的玩家可能拥有角色，每个角色可以包含一些信息。这类似于 CharacterData。它由角色的 character ID (`CharacterId`) 标识。
PlayFabId	以前该术语同时涵盖 `master_player_account` 和 `title_player_account` 概念。分离这些概念可简化并明晰功能。一位玩家可以与同一工作室下的多个 title 进行交互，因此虽然他们在每个 title 中可以作为不同的 `title_player_account` 拥有独特信息，但工作室的所有者也需要将该玩家标识为具有跨 title 共享数据的单一 `master_player_account` 实体。这可以实现诸如游戏交叉推广和为玩家提供跨游戏奖励等功能。

另请参阅

PlayFab 博客上的 Introducing Entities, Objects and Files。
Entities 快速入门

最后修改于 2026年8月13日

相关主题

实体快速入门迁移仲裁者在 Unity 中从 Google Sign-in 迁移到 Google Play Games 从 MPSD 迁移到 PlayFab Multiplayer 和 MPA Microsoft 游戏开发工具包网络简介

⌘I