Juego de demostración: Winter Starfall

Winter Starfall es un juego desarrollado por PlayFab para mostrar nuestras distintas características y ofrecer una forma de explorar cómo se implementan en un juego en vivo. El juego está disponible para jugar en WinterStarfall.com. Si ya tiene una cuenta de desarrollador de PlayFab, también puede acceder a él a través del portal para desarrolladores en la página My Studios and Titles. El juego está creado como una aplicación web y usa las API del SDK de PlayFab junto con la integración de Azure Functions de PlayFab para implementar funcionalidad personalizada. Actualmente, el juego hace uso de las siguientes características de PlayFab:

Economy V2 (catálogo, moneda, lotes, tiendas)
Datos de título, datos de jugador y otras funciones básicas de PlayFab
Noticias del título para comunicarse con los jugadores
Cloud Script con Azure Functions

Características de demostración adicionales

Winter Starfall incluye características que facilitan ver lo que sucede “bajo el capó” con PlayFab. El juego está disponible para que cualquiera lo juegue, pero para aprovechar al máximo estas características debe registrarse para obtener una cuenta de desarrollador gratuita. Junto al icono de perfil en la parte superior derecha hay un icono de PlayFab que, al seleccionarlo, abre la barra lateral de actividad de PlayFab.

La barra lateral de actividad muestra una lista de llamadas a la API que se actualiza mientras juega. Cada llamada a la API está etiquetada y codificada por colores para indicar con qué SDK de PlayFab está relacionada.
Puede seleccionar una de las llamadas a la API de la lista para ver la solicitud y la respuesta completas de la API.
Al seleccionar View title F8941 se abre el título en Game Manager, donde puede ver cómo están configuradas las distintas características. En este paso es donde se le pide que inicie sesión con una cuenta de desarrollador de PlayFab.
Clear quita todas las notificaciones actuales de la barra de actividad.

Puede jugar al juego de demostración en cualquier momento, pero para acceder a Game Manager debe registrarse para obtener una cuenta de desarrollador gratuita.

Características de PlayFab incluidas

La siguiente sección desglosa con más detalle las distintas características de PlayFab que se usan en el juego.

Autenticación

Lo primero que ocurre en cualquier juego de PlayFab es el inicio de sesión de un jugador, que devuelve un token de autenticación necesario para todas las llamadas a la API posteriores. Winter Starfall admite varias formas de inicio de sesión recuperable con correo electrónico, Microsoft (a través de OpenID), Google y Facebook. El tutorial de código fuente y escenarios ofrece un recorrido detallado del flujo de inicio de sesión y los procedimientos recomendados para la autenticación de jugadores. Más información sobre la autenticación de PlayFab

Economía

Como juego de rol (RPG) de fantasía, Winter Starfall incluye un sistema de economía para que el jugador visite tiendas, compre artículos y gane moneda a través de las batallas. El servicio de economía más reciente de PlayFab gestiona todo lo relacionado con el inventario y el comercio en el juego. El tutorial de código fuente y escenarios ofrece un recorrido detallado del flujo de compra que se produce en el juego. Más información sobre Economy V2

Datos de jugador

Los jugadores de PlayFab tienen datos asociados que las distintas características almacenan en el servicio. Los datos de jugador, como característica, le permiten almacenar información relacionada con el jugador en pares clave-valor u objetos y archivos que se pueden compartir entre varios juegos y dispositivos. En Winter Starfall, los datos de jugador se usan para almacenar el estado del juego e información como qué personajes se unieron al grupo del jugador. Cuando el jugador avanza por la historia, su posición se registra en su perfil de jugador mediante una llamada a la API UpdateUserData. Luego se accede a estos datos con GetUserData cuando inicia sesión, para cargar al jugador en el punto correcto de la historia con todo su progreso anterior. Por ejemplo, estos ejemplos son el cuerpo de la solicitud y la respuesta de la API de la llamada a GetUserData durante el flujo de inicio de sesión. GetUserData - Request

{
  "Keys": [
    "stats",
    "location",
    "party",
    "notifications",
    "cinematicProgression",
    "enemyGroupProgression"
  ]
}

GetUserData - Response

{
  "code": 200,
  "status": "OK",
  "data": {
    "Data": {
      "location": {
        "Value": "{\"id\":\"intro\",\"map\":[\"intro\",\"intro-village\"]}",
        "LastUpdated": "2024-09-20T18:16:13.68Z",
        "Permission": "Private"
      },
      "party": {
        "Value": "{\"characters\":[{\"id\":1,\"armor\":\"dfae3ef9-92a0-493b-9bb8-f88a09718d26\",\"weapon\":\"32e1f684-43b0-4fe6-982e-b0829ff0d6f3\",\"spells\":null}],\"guests\":[]}",
        "LastUpdated": "2024-09-20T18:16:13.68Z",
        "Permission": "Private"
      }
    },
    "DataVersion": 20
  },
  "CallBackTimeMS": 97
}

Más información sobre la característica de datos de jugador

Datos de título

Los datos de título son similares a los datos de jugador en que almacenan pares clave-valor, solo que los datos pertenecen al título del juego en lugar de a un jugador específico. Winter Starfall usa los datos de título con el sistema de economía para calcular el precio al vender un artículo, almacenando el valor multipliers con un valor de sell, 0.5. Para obtener más información sobre cómo funciona el flujo de venta, consulte el tutorial de código fuente y escenarios. Más información sobre los datos de título

CloudScript con Azure Functions

CloudScript es una característica flexible que le permite implementar funcionalidad personalizada del lado del servidor, lo que permite soluciones casi ilimitadas cuando se combina con otras características de PlayFab. El juego usa esta característica para resolver muchos escenarios:

CombatVictory: después de que el jugador gana una batalla, ejecuta una serie de acciones para conceder experiencia y artículos, y agregar miembros al grupo.
PlayerCreated: equipa a un jugador nuevo con artículos y estadísticas iniciales.
ProgressCheckpoint: realiza acciones para desbloquear artículos y personajes tras alcanzar puntos clave de la historia.
ResetPlayer: borra los datos de usuario, los artículos y las estadísticas para un restablecimiento completo.
SellItem: permite vender artículos con descuento, lo que no es una característica inherente del sistema de economía. El flujo de compra/venta se trata con más detalle en el tutorial de código fuente y escenarios.

Más información sobre CloudScript con Azure Functions

Las funciones de CloudScript de Winter Starfall están escritas en C#, pero puede usar cualquier lenguaje compatible con Azure Functions.

Noticias del título

Las noticias del título se usan para comunicarse con todos los jugadores dentro del ámbito de un título. Winter Starfall las implementa como un sistema de notificaciones para mostrar consejos de juego y avisos. Además de las noticias del título, PlayFab ofrece otras características de comunicación, como plantillas para correo electrónico y notificaciones push. Más información sobre los métodos de comunicación del título

Limitaciones de la demostración

Dado que Winter Starfall funciona con datos de jugadores reales, algunas características tienen un alcance limitado en la vista de Game Manager. Esta sección ofrece una visión general de cómo se verían las características limitadas en Game Manager. Para explorar estas páginas con más detalle, puede descargar el código fuente y ejecutar una instancia local del juego, o crear su propio título nuevo desde cero.

Para obtener una guía completa de las características del portal para desarrolladores, consulte la documentación de Game Manager

Jugadores

La sección Players de Game Manager está oculta en el título de Winter Starfall para proteger la información de los jugadores. Normalmente, podría consultar la lista completa de jugadores de su juego y seleccionar una cuenta individual para actualizar sus datos a través de Game Manager. Desde la página de información general del jugador, puede ver toda la información relacionada con el jugador, incluidos los artículos del inventario, un registro de todos los inicios de sesión, los datos de jugador y mucho más.

Datos y análisis

Algunas de las características de la sección Analyze también están limitadas para proteger la información del título y de los jugadores. Esta limitación incluye las secciones Data y Audit History. La sección Data contiene características como Data Explorer, que le permite consultar y ver un registro de eventos de PlayFab, que muestra eventos (llamadas a la API) como cuándo un jugador específico inició sesión. El historial de auditoría ofrece una vista del historial de cambios realizados en el título por cualquier persona con acceso de edición. Para obtener una vista completa de las demás características que forman parte de la sección Data, consulte la documentación de datos y análisis.

Otros

En la configuración del título, la pestaña Secret keys está oculta. Consulte la documentación para la administración de claves secretas.

Pasos siguientes

Después de probar la demostración, le recomendamos comenzar con estos artículos para obtener más información sobre cómo funciona PlayFab:

Más información sobre Game Manager
Información sobre el modelo de entidades
Información sobre el SDK de PlayFab Services

XBOX Services

PlayFab

Información general del juego de demostración de PlayFab Winter Starfall

Juego de demostración: Winter Starfall

Características de demostración adicionales