Skip to main content
Los datos de jugador son un almacenamiento por jugador limitado a las entidades de jugador (title_player_account, master_player_account y character). Úselos para almacenar el progreso del juego, las preferencias y otra información vinculada a un jugador individual. Los datos de jugador son una de las varias características de almacenamiento de PlayFab, cada una limitada a un tipo de entidad diferente. Para ver una comparación, consulte Objetos de entidad.

Opciones de almacenamiento

PlayFab proporciona dos maneras de almacenar datos de jugador:
  • Entidades: Le permiten almacenar datos en objetos y archivos entre jugadores, personajes y grupos.
  • Datos de jugador/UserData: Le permiten almacenar datos de pares clave-valor para los jugadores.
Para proporcionar la máxima flexibilidad y el mejor rendimiento, se recomienda que todos los títulos nuevos usen objetos de entidad. En las API de PlayFab, los nombres de las funciones usan el término UserData. En Game Manager, este concepto se describe como Player Data. Son idénticos e intercambiables. Hay tres modos de acceso a los datos de jugador:
  • Cliente: Son datos de jugador que están disponibles para que el cliente de su título los lea y actualice. Use las API de cliente UpdateUserData para crear, actualizar o eliminar y GetUserData para leer los datos del jugador.
  • Solo lectura: Son datos de jugador que crea o actualiza su servidor. El cliente de su título puede leer estos datos, pero no actualizarlos. Use la API de servidor UpdateUserReadOnlyData para crear, actualizar o eliminar y la API de cliente GetUserReadOnlyData para leer los datos específicos del título del jugador. Estos datos son visibles para el jugador, pero solo el servidor puede modificarlos.
  • Interno: Son datos de jugador que solo están disponibles para su servidor. Use las API de servidor UpdateUserInternalData para crear, actualizar o eliminar y GetUserInternalData para leer los datos específicos del título del jugador. Estos datos son exclusivos del servidor y el cliente no puede verlos.
Cuando usa datos de jugador, solo los datos de usuario (User Data) y los datos de usuario de solo lectura (User Read Only Data) están disponibles para la API de cliente. Si tiene datos de jugador que otro jugador debería poder leer, debe establecer el valor de Permission en Public al escribir los datos.

Datos de jugador frente a datos de publicador del jugador

Los datos de jugador son información del jugador específica de un título de juego. Deben usarse para información específica del título, como guardar la posición de su jugador en una mazmorra u otros datos específicos del juego. Los datos de publicador del jugador son datos asociados a la cuenta del jugador, en lugar de a la cuenta del jugador más el título. Se usan para guardar información sobre un jugador relevante para todos los títulos de su estudio (que también puede contener información específica del título, con fines de recompensas entre títulos). Todos los títulos de un estudio en PlayFab comparten un Publisher ID de forma predeterminada, y ese id. define esta relación. Las cuentas de jugador existen en el nivel del publicador y se comparten entre todos los títulos con el mismo Publisher ID (y, además, tienen datos de jugador distintos por título). Si necesita tener títulos en un estudio con distintos Publisher ID, o títulos en distintos estudios que compartan el mismo Publisher ID, puede abrir una incidencia en los foros de la comunidad de PlayFab y nuestro equipo de Developer Success le ayudará.
No confunda los datos de publicador del jugador con los datos de publicador, que son datos de pares clave-valor compartidos por todos los títulos (no son por jugador).
El uso de los datos de publicador del jugador es casi idéntico al uso de los datos de jugador. Ambos son diccionarios que asignan una cadena a un blob JSON (u otro valor de cadena arbitrario). Para obtener más información, consulte Cómo usar los datos de publicador del jugador para otorgar una recompensa por jugar a varios títulos.
Última modificación el 28 de agosto de 2026