Skip to main content

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.
Empiece a usar los datos del jugador de PlayFab. Este inicio rápido le muestra cómo establecer y recuperar datos del jugador usando C# en Unity y usando CloudScript de PlayFab. Los datos del jugador son información que se aplica a un jugador individual o a un grupo de jugadores (datos compartidos) y que PlayFab almacena como pares clave-valor (KVP). Este artículo cubre las llamadas de API de cliente, que se pueden llamar de forma segura desde cualquier proceso o contexto. También cubre las llamadas de API de servidor, que solo deben realizarse desde un proceso de servidor dedicado que usted controle, o desde una llamada de CloudScript cuidadosamente protegida. Las API de servidor requieren su clave secreta de desarrollador. La clave no debe proporcionarse al cliente ni publicarse con él.

Requisitos

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:
  • El SDK de Unity3D de PlayFab.
Para obtener información sobre la configuración del SDK de Unity3D de PlayFab, consulte el artículo Inicio rápido: Biblioteca de cliente de PlayFab para C# en Unity. Este artículo garantiza que tenga una cuenta de PlayFab y que haya configurado correctamente el SDK de Unity3D.

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

  1. En el editor de Unity, abra su proyecto de ejemplo.
  2. En la ventana Project, abra Assets > Scripts y, a continuación, abra el script PlayFabLogin.
  3. En Visual Studio, agregue lo siguiente a la instrucción using: using System.Collections.Generic;
  4. Para establecer los datos del jugador, agregue un método SetUserData a la clase PlayFabLogin. SetUserData usa 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 KVP Ancestor con el valor Arthur y Successor con el valor Fred.
  5. Para obtener los datos del jugador, agregue un método GetUserData a la clase PlayFabLogin. SetUserData usa el método GetUserData para recuperar los datos del jugador especificado.
  6. Llame a SetUserData y GetUserData en el método OnLoginSuccess.
  7. 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

Última modificación el 28 de agosto de 2026