Información general
El SDK de C/C++ de PlayFab Services independiente (publicado en 2023) introdujo prácticas de desarrollo modernas como la actualización automática de tokens, una administración de memoria mejorada y un control de subprocesos avanzado. Sin embargo, otros SDK independientes, como PlayFab Party y PlayFab Multiplayer, no adoptaron estas mejoras. El SDK unificado reúne estos componentes en un SDK cohesionado y modernizado.Los SDK independientes de PlayFab (v1) existentes siguen siendo compatibles, pero recomendamos el SDK unificado de PlayFab (v2) para proyectos nuevos.
Ventajas clave
El SDK unificado proporciona mejoras significativas respecto a los SDK independientes:- Integración simplificada: un único proceso de instalación y actualización del SDK elimina la necesidad de administrar varias descargas y versiones de SDK. En XBOX/Windows, el SDK se incluye con el GDK (a partir del GDK de octubre de 2025, versión 2510).
-
Autenticación unificada: la autenticación se realiza una sola vez mediante las API de
PFAuthentication, y elPFEntityHandleresultante se usa en todos los componentes. Los componentes consultan automáticamente al servicio de Core para obtener los tokens internamente, lo que elimina el paso manual de tokens y reduce los errores de integración. - Administración automática de tokens: la lógica centralizada de actualización de tokens controla automáticamente la renovación del Entity Token en segundo plano, lo que evita la expiración de la sesión durante sesiones de juego prolongadas.
- Modelo de programación coherente: todos los componentes siguen patrones estandarizados para la inicialización, las llamadas a la API, el control de errores, las operaciones asincrónicas y el registro unificado, lo que reduce significativamente la curva de aprendizaje.
-
Control avanzado de subprocesos y administración de memoria: todos los componentes admiten asignadores de memoria personalizados y un control avanzado de subprocesos mediante la integración con
XTaskQueue, lo que permite un control detallado sobre la asignación de recursos y el comportamiento de los subprocesos.
Plataformas y motores de juego compatibles
La siguiente tabla muestra la compatibilidad de plataformas y motores de juego para el SDK unificado de PlayFab:El acceso a los SDK de las plataformas PlayStation® y Nintendo requiere un acuerdo de confidencialidad (NDA) con el propietario de la plataforma correspondiente. Consulte Solicitar acceso a SDK y ejemplos para obtener más detalles.
Disponibilidad de características
Los componentes del SDK unificado se distribuyen juntos, pero determinadas características pueden tener una disponibilidad limitada o provisional en plataformas específicas en la versión actual. La siguiente tabla resume el estado de las características para esta versión preliminar.
Un guion (—) indica que la característica no es compatible actualmente en esa plataforma.
Si encuentra una discrepancia entre esta tabla y el comportamiento observado, notifique un problema a través de su canal de soporte técnico de PlayFab para que el equipo de producto pueda actualizar la documentación y solucionar la carencia.
Componentes del SDK
El SDK unificado de PlayFab presenta una arquitectura modular, lo que le permite integrar solo los componentes que su proyecto requiere. En XBOX/Windows, el SDK se incluye con la instalación del Microsoft GDK. El SDK proporciona encabezados y binarios para los siguientes componentes:- libHttpClient: abstracción de HTTP/WebSocket multiplataforma usada por los SDK de XBOX y PlayFab. Proporciona API asincrónicas, administración de memoria y lógica de reintentos. Es necesaria para todos los componentes del SDK. Integración opcional con XTaskQueue para la administración de subprocesos.
- PlayFab Core: funcionalidad fundamental para todos los componentes de PlayFab. Controla la autenticación, la administración de entidades, la configuración, la telemetría, el registro y el control de errores.
- PlayFab Services: servicios compartidos para LiveOps, economía y progresión.
- PlayFab Multiplayer: servicios de creación de salas y matchmaking.
- PlayFab Party: comunicación de voz, chat de texto y datos multiplataforma de baja latencia con integración opcional de Azure Cognitive Services para conversión de voz en texto, texto a voz, traducción y mucho más.
- PlayFab GameSave: almacenamiento y sincronización de partidas guardadas en la nube para conservar el progreso del jugador entre dispositivos y sesiones.