Tutorial de actualización por la reestructuración de la API de entidades

Introducción

Hemos reestructurado las API que estaban agrupadas bajo el grupo de API de entidades en grupos lógicos coherentes que facilitan su consumo, tanto a través del sitio de documentación como de los SDK de PlayFab. El impacto inmediato es que, si ha estado usando las API basadas en entidades en su juego, el código deberá actualizarse cuando actualice sus SDK.

Requisitos previos

Las siguientes condiciones deben cumplirse para que esta guía de actualización le aplique:

Usa las API de PlayFab basadas en entidades.
Ha actualizado a un SDK de PlayFab publicado el 9/8/2018 o después.

No hay cambios en el nivel de servicio. Por ejemplo, los títulos existentes que usan SDK antiguos seguirán funcionando sin necesidad de cambios.

Cómo actualizar

El impacto fundamental de este cambio es que el grupo de API PlayFabEntityModel se ha separado en seis grupos de API diferentes que están enlazados lógicamente, como se muestra en la siguiente imagen. Puede encontrar la lista completa de asignaciones de API de entidades anterior -> Nueva API en el APÉNDICE 1 de este tutorial.

La asignación de la API clásica no se ha visto afectada.

En la siguiente sección se muestra un ejemplo de actualización de un SDK de C# que usa PlayFabEntityAPIGroup al nuevo conjunto de grupos de API.

Ejemplo de actualización: SDK de C#

Siga estos pasos para actualizar su aplicación. Paso 1: Cambie las instrucciones using que hagan referencia a PlayFab.EntityModels, como las que se muestran a continuación.

using PlayFab.EntityModels;
using PlayFab.DataModels;

Ahora puede ser granular al seleccionar cuáles de estas API quiere incorporar, en lugar de importar todo el grupo de API de entidades. Paso 2: A continuación se proporciona un ejemplo de código más detallado de la nueva API, con comentarios sobre cómo era antes.

public async void Example()
{
       var logrequest = new PlayFab.ClientModels.LoginWithCustomIDRequest
       {
           CustomId = "TestExample",
           CreateAccount = true,
       };

       var loginResult = await PlayFab.PlayFabClientAPI.LoginWithCustomIDAsync(logrequest);
       var playfabId = loginResult?.Result?.PlayFabId;

       // PlayFab EntityAPI has been replaced here with the PlayFabProfilesAPI
       // and PlayFab.EntityModels has been replaced with PlayFab.ProfileModels
       var getProfileResult = await PlayFab.PlayFabProfilesAPI.GetProfileAsync(new
       PlayFab.ProfilesModels.GetEntityProfileRequest());
       var profile = getProfileResult?.Result?.Profile;
}

Proceda de la misma manera con los demás SDK, usando la asignación del APÉNDICE 1 de este tutorial.

Conclusión

Nos complace exponer las API de entidades de una manera más intuitiva en nuestro sitio de documentación y en nuestro código, basándonos en sus comentarios. Si tiene preguntas o comentarios, póngase en contacto con nosotros a través de los foros de PlayFab.

APÉNDICE 1: Asignaciones de API ANTIGUAS a NUEVAS

Todas las API que se enumeran a continuación formaban parte anteriormente del grupo de API PlayFabEntityModel. Ahora están clasificadas en los siguientes grupos de API nuevos.

PlayFabProfilesApi

GetGlobalPolicy
GetProfile
GetProfiles
SetGlobalPolicy
SetProfilePolicy

PlayFabAuthenticationApi

GetEntityToken

PlayFabDataApi

AbortFileUploads
DeleteFiles
FinalizeFileUploads
GetFiles
InitiateFileUploads
GetObjects
SetObjects

PlayFabGroupsApi

AcceptGroupApplication
AcceptGroupInvitation
AddMembers
ApplyToGroup
BlockEntity
ChangeMemberRole
CreateGroup
CreateRole
DeleteGroup
DeleteRole
GetEntityToken
GetGroup
InviteToGroup
IsMember
ListGroupApplications
ListGroupBlocks
ListGroupInvitations
ListGroupMembers
ListMembershipOpportunities
RemoveGroupApplication
RemoveGroupInvitation
RemoveMembers
UnblockEntity
UpdateGroup
UpdateRole

PlayFabEventsApi

WriteEvents

PlayFabCloudScriptApi

ExecuteEntityCloudScript

​Introducción

​Requisitos previos

​Cómo actualizar

​Ejemplo de actualización: SDK de C#

​Conclusión

​APÉNDICE 1: Asignaciones de API ANTIGUAS a NUEVAS

​PlayFabProfilesApi

​PlayFabAuthenticationApi

​PlayFabDataApi

​PlayFabGroupsApi

​PlayFabEventsApi

​PlayFabCloudScriptApi

Introducción

Requisitos previos

Cómo actualizar

Ejemplo de actualización: SDK de C#

Conclusión

APÉNDICE 1: Asignaciones de API ANTIGUAS a NUEVAS

PlayFabProfilesApi

PlayFabAuthenticationApi

PlayFabDataApi

PlayFabGroupsApi

PlayFabEventsApi

PlayFabCloudScriptApi