实体迁移信息

  • 项目

实体 API 引入了一种新的访问模式，旨在减少当前帐户和数据系统的难题。

如果之前使用过以下方法来实现“游戏”、“玩家”或“角色”信息的数据管理，这里介绍的信息则很有用。

游戏 访问：

玩家 访问：

字符 访问：

使用实体 API，可以调用单个方法来保存游戏、玩家和角色实体类型的数据值。 该 API 提供了访问规则，在更好的界面上复制和扩展了当前系统的自定义数据行为。

在某些方面，这些更改不向后兼容。 然而，可以在不改变现有 API 行为的情况下增加对实体 API 的调用。

术语

下表描述了与实体 API 相关术语的优化项。

术语 说明
title 此概念未更改。 游戏可以包含对所有玩家可用的全局信息。 这类似于 TitleData。 它由游戏/应用程序的游戏 ID（TitleId）进行标识。
master_player_account 该实体类型允许在一个工作室内的多个游戏中共享一个玩家的信息。 这类似于 UserPublisherData。 它由玩家 ID（PlayFabId）进行标识，该 ID 作为任何登录或调用的一部分返回，用于对玩家帐户检索帐户信息（例如，PlayFab 客户端 API GetAccountInfo）。
title_player_account 此概念基于现有 API 方法中的用户/玩家。 每个玩家可包含当前游戏的一些信息。 这类似于 GetUserData 方法。 这由实体 ID (EntityKey.Id) 进行标识，可在将 LoginTitlePlayerAccountEntity 指定为 True 的任何登录中，通过 EntityKey 对象返回该 ID。
角色 此概念未更改。 玩家可以拥有各种角色，每个角色可以包含一些信息。 这类似于 CharacterData。 它由角色 ID（CharacterId）进行标识。
PlayFabId 此术语以前涵盖 master_player_account 和 title_player_account 这两个概念。 分离这两个概念简化并阐明了功能。 玩家可以与全都属于同一个工作室的多个游戏进行交互，因此虽然他们在每个游戏中作为不同 title_player_account 具有唯一的信息，但是工作室的所有者还需要将玩家标识为跨游戏具有共享数据的单个 master_player_account 实体。 这样可实现诸如游戏的交叉促销以及向玩家授予跨游戏奖励这类功能。

另请参阅