Skip to main content
Esta guía muestra cómo integrar el SDK unificado de PlayFab en su proyecto de Windows, inicializar el SDK y autenticar a un jugador. Esta es la base para realizar llamadas a la API de PlayFab.

Requisitos previos

Antes de empezar, complete los pasos de configuración en Configuración del inicio rápido para configurar su entorno de desarrollo y su proyecto.

Qué logrará

Al final de este inicio rápido, habrá:
  • Configurado el SDK unificado de PlayFab en su proyecto de Windows
  • Inicializado el SDK con su Title ID
  • Autenticado a un jugador con XBOX o Steam
  • Obtenido un identificador de entidad para realizar llamadas a la API
  • Limpiado los recursos correctamente

En este inicio rápido

  1. Inicializar el SDK
  2. Autenticar a un jugador
  3. Limpiar los recursos

Paso 1: inicializar el SDK

Incluir los encabezados necesarios

Empiece por incluir los encabezados necesarios de PlayFab y XBOX Game Runtime en su proyecto:

Inicializar los servicios de XBOX Gaming Runtime

El SDK unificado de PlayFab requiere XBOX Game Runtime. Inicialícelo primero:

Inicializar PlayFab Core

Inicialice el SDK de PlayFab y cree un identificador de configuración del servicio. Reemplace ABCDEF por su Title ID real de PlayFab:
Puede encontrar su Title ID en el panel de Game Manager, en la configuración de su juego.

Paso 2: autenticar a un jugador

PlayFab requiere la autenticación del jugador antes de realizar llamadas a la API. El SDK proporciona varios métodos de autenticación según su plataforma y sus requisitos.

Elegir el método de autenticación

Opción A: iniciar sesión con XBOX (recomendado para Windows/XBOX)

Use PFAuthenticationLoginWithXUserAsync para iniciar sesión con una cuenta de usuario de XBOX. Este es el método recomendado para aplicaciones de Windows y XBOX.

Opción B: iniciar sesión con Steam

Para juegos integrados con Steam, use PFAuthenticationLoginWithSteamAsync con un ticket de autenticación de Steam.
El PFEntityHandle que devuelve el inicio de sesión es necesario para todas las llamadas posteriores a la API de PlayFab. Mantenga este identificador disponible durante toda la vida de su aplicación.

Paso 3: limpiar los recursos

Cuando su aplicación se cierre, limpie correctamente todos los recursos para evitar pérdidas de memoria y garantizar una finalización controlada:
Limpie siempre los recursos en el orden inverso al de la inicialización para garantizar un cierre correcto.

Pasos siguientes

Ahora que ha inicializado el SDK y ha autenticado a un jugador, está listo para empezar a llamar a los servicios de PlayFab:

Realice su primera llamada a la API

  • Llamada a PlayFab Services: aprenda a llamar a las API de PlayFab para administrar los datos de los jugadores y usar los servicios del juego

Conceptos básicos

Autenticación avanzada

  • Autenticación multiplataforma: admita varios proveedores de autenticación
  • Autenticación con Custom ID: use su propio sistema de autenticación
  • Vinculación de cuentas: vincule varios métodos de autenticación a una sola cuenta

Solución de problemas

Problemas comunes y soluciones:

Documentación de referencia

Última modificación el 28 de agosto de 2026