Información de migración de entidades - XBOX Game Development Documentation

La API de entidad presenta nuevos patrones de acceso diseñados para aliviar los puntos débiles de los sistemas actuales de cuentas y datos. La información que se presenta aquí es útil si anteriormente ha usado los siguientes métodos para implementar la administración de datos de su información de título, jugador o personaje. Acceso de título:

client/GetTitleData
admin/GetTitleData
server/GetTitleData

Acceso de jugador:

Acceso de personaje:

client/GetCharacterData
client/UpdateCharacterData

Con la API de entidades, puede llamar a un único método para guardar los valores de datos de los tipos de entidad de título, jugador y personaje. La API proporciona reglas de acceso que replican y amplían el comportamiento actual del sistema de datos personalizados en una interfaz mejorada. En ciertos aspectos, estos cambios no son compatibles con versiones anteriores. Sin embargo, puede agregar llamadas a la API de entidad sin cambiar el comportamiento de las API existentes.

Terminología

En la tabla siguiente se describen los ajustes de terminología relacionados con las API de entidad.

Término	Descripción
title	Este concepto no cambia. Su título puede contener información global disponible para todos los jugadores. Es similar a TitleData. Se identifica mediante el identificador de título (`TitleId`) del juego o la aplicación.
master_player_account	Este tipo de entidad le permite compartir información sobre un jugador entre varios juegos de un mismo estudio. Es similar a UserPublisherData. Se identifica mediante el identificador de jugador (`PlayFabId`) del jugador, que se devuelve como parte de cualquier inicio de sesión o de cualquier llamada para recuperar la información de cuenta de la cuenta de jugador (por ejemplo, la API de cliente de PlayFab GetAccountInfo).
title_player_account	Este concepto se basa en el usuario/jugador de los métodos de API existentes. Cada jugador puede contener cierta información para el título actual. Es similar al método GetUserData. Se identifica mediante el identificador de entidad (`EntityKey.Id`) que se obtiene en el objeto EntityKey en cualquier inicio de sesión en el que especifique `LoginTitlePlayerAccountEntity` como `True`.
character	Este concepto no cambia. Su jugador puede poseer personajes, cada uno de los cuales puede contener cierta información. Es similar a CharacterData. Se identifica mediante el identificador de personaje (`CharacterId`) del personaje.
PlayFabId	Anteriormente, este término abarcaba tanto el concepto de `master_player_account` como el de `title_player_account`. Separar estos conceptos simplifica y aclara la funcionalidad. Un jugador puede interactuar con varios títulos que están todos en el mismo estudio, por lo que, aunque puede tener información única como una `title_player_account` diferente en cada título, el propietario del estudio también necesita identificar a ese jugador como una única entidad `master_player_account` con datos compartidos entre títulos. Esto habilita cosas como la promoción cruzada de juegos y la entrega de recompensas entre juegos a los jugadores.

Consulte también

Introducing Entities, Objects and Files en el blog de PlayFab.
Inicio rápido de entidades

​Terminología

​Consulte también

Terminología

Consulte también