Informações de migração de entidades - XBOX Game Development Documentation

A API de entidade introduz novos padrões de acesso projetados para aliviar os pontos problemáticos dos sistemas atuais de conta e de dados. As informações apresentadas aqui são úteis se você usava anteriormente os seguintes métodos para implementar o gerenciamento de dados das informações de título, jogador ou personagem. Acesso de título:

client/GetTitleData
admin/GetTitleData
server/GetTitleData

Acesso de jogador:

Acesso de personagem:

client/GetCharacterData
client/UpdateCharacterData

Usando a API de entidades, você pode chamar um único método para salvar os valores de dados dos tipos de entidade de título, jogador e personagem. A API fornece regras de acesso que replicam e expandem o comportamento atual do sistema de dados personalizados em uma interface melhor. Em alguns aspectos, essas alterações não são compatíveis com versões anteriores. No entanto, você pode adicionar chamadas à API de entidade sem alterar o comportamento das APIs existentes.

Terminologia

A tabela a seguir descreve refinamentos na terminologia relacionada às APIs de entidade.

Termo	Descrição
title	Esse conceito não mudou. Seu título pode conter informações globais disponíveis para todos os jogadores. Isso é semelhante a TitleData. Ele é identificado pela ID de título (`TitleId`) do jogo/aplicativo.
master_player_account	Esse tipo de entidade permite compartilhar informações sobre um jogador entre vários jogos de um namespace. Isso é semelhante a UserPublisherData. Ele é identificado pela ID do jogador (`PlayFabId`), que é retornada como parte de qualquer login ou de qualquer chamada para obter informações da conta do jogador (por exemplo, GetAccountInfo da PlayFab Client API).
title_player_account	Esse conceito se baseia no usuário/jogador dos métodos de API existentes. Cada jogador pode conter algumas informações para o título atual. Isso é semelhante ao método GetUserData. Ele é identificado pela ID de entidade (`EntityKey.Id`) que você recebe no objeto EntityKey em qualquer login em que você especificar `LoginTitlePlayerAccountEntity` como `True`.
character	Esse conceito não mudou. Seu jogador pode ter personagens, e cada um pode conter algumas informações. Isso é semelhante a CharacterData. Ele é identificado pela ID do personagem (`CharacterId`).
PlayFabId	Anteriormente, esse termo abrangia os conceitos de `master_player_account` e `title_player_account`. Separar esses conceitos simplifica e esclarece a funcionalidade. Um jogador pode interagir com vários títulos no mesmo namespace. O jogador pode ter informações exclusivas em uma `title_player_account` diferente para cada título e uma única `master_player_account` com dados compartilhados entre títulos. Isso permite a promoção cruzada de jogos e recompensas entre jogos.

Confira também

Introducing Entities, Objects and Files no blog do PlayFab.
Início rápido de entidades

​Terminologia

​Confira também

Terminologia

Confira também