Inicio rápido: Establecer y obtener datos del jugador
En las API de PlayFab, los nombres de las funciones utilizan el término UserData. En Game Manager, este concepto se describe como Player Data. Son idénticos e intercambiables.
Requisitos
- Una cuenta de desarrollador de PlayFab.
- Una copia instalada del editor de Unity. Para instalar Unity para uso personal a través de Unity Hub, o Unity+ para uso profesional, consulte Descargar Unity.
El SDK de Unity3D de PlayFab es compatible con la versión 5.3 del editor de Unity (publicada en diciembre de 2015) y posteriores.
- Un proyecto de Unity puede ser:
- Un proyecto totalmente nuevo. Para obtener más información, consulte Iniciar Unity por primera vez.
- Un proyecto de tutorial guiado. Para obtener más información, consulte Introducción a Unity.
- Un proyecto existente.
- El SDK de Unity3D de PlayFab.
Acerca de los ejemplos de código
Los ejemplos de C# de este artículo están escritos para el SDK de Unity. El SDK de Unity usa un modelo controlado por eventos para gestionar las tareas no sincrónicas. Para ejecutar el código de ejemplo con el SDK de C#, debe modificar el código para usar un modelo de tareas asíncronas (async Task). Los métodos que deben modificarse llevan Async anexado al nombre del método en la firma. Por ejemplo, SetObject en el SDK de Unity se convierte en SetObjectAsync en el SDK de C#. Para obtener más información, consulte Programación asincrónica con async y await. Aunque puede usar un proyecto de Unity existente, este inicio rápido asume que está usando el ejemplo creado al completar el Inicio rápido: Biblioteca de cliente de PlayFab para C# en Unity.Datos del jugador en Game Manager
Siempre puede obtener y establecer los datos del jugador a través de Game Manager realizando los pasos siguientes.- Abra Game Manager. Si no está familiarizado con él, consulte el inicio rápido de Game Manager.
- Seleccione la pestaña Players.
- Seleccione el nombre del jugador para acceder a la pestaña Players Account.
- Seleccione la pestaña Player Data para ver sus datos.
Agregar un método para establecer los datos del jugador y recuperar los datos del jugador
- En el editor de Unity, abra su proyecto de ejemplo.
- En la ventana Project, abra Assets > Scripts y, a continuación, abra el script PlayFabLogin.
-
En Visual Studio, agregue lo siguiente a la instrucción using:
using System.Collections.Generic; -
Para establecer los datos del jugador, agregue un método
SetUserDataa la clasePlayFabLogin.SetUserDatausa el método UpdateUserData para crear o actualizar los datos del jugador que ha iniciado sesión. El método crea (o actualiza, si los pares clave-valor (KVP) ya existen) los KVPAncestorcon el valorArthurySuccessorcon el valorFred. -
Para obtener los datos del jugador, agregue un método
GetUserDataa la clasePlayFabLogin.SetUserDatausa el método GetUserData para recuperar los datos del jugador especificado. -
Llame a
SetUserDatayGetUserDataen el métodoOnLoginSuccess. - Guarde el archivo.
Ejecución del ejemplo
En el editor de Unity, seleccione el botón de reproducción. Si todo va bien, los resultados de las llamadas se muestran en la ventana de la consola.Consulte también
- Cómo establecer datos internos del jugador
- Cómo obtener datos internos del jugador
- Cómo establecer datos de solo lectura del jugador
- Cómo obtener datos de solo lectura del jugador
- Cómo modificar datos de solo lectura o internos del jugador desde CloudScript
- Inicio rápido de datos del título
- Uso de datos del publicador
- Inicio rápido de CloudScript
