Skip to main content
El SDK unificado de PlayFab (v2) es la siguiente generación de SDK de PlayFab. Consolida todas las bibliotecas cliente de PlayFab en un único producto cohesionado. Proporciona una experiencia de desarrollo moderna y simplificada con autenticación unificada, administración automática de tokens y API coherentes en todos los componentes. El SDK unificado es el foco principal del desarrollo continuo: todas las nuevas características, la compatibilidad con plataformas y las mejoras se dirigen primero a v2. Para proyectos nuevos, recomendamos el SDK unificado de PlayFab (v2) si las plataformas admitidas actualmente cumplen sus requisitos. Los proyectos existentes que usan los SDK independientes v1 pueden migrar a v2 para aprovechar la arquitectura unificada. Los SDK independientes v1 siguen siendo compatibles por ahora y proporcionan una cobertura de plataformas más amplia para proyectos que requieren plataformas aún no admitidas en v2.
Los SDK v1 y v2 no se pueden usar juntos en el mismo proyecto. Si necesita una plataforma aún no admitida en v2, use v1 para todos los componentes.

SDK unificado de PlayFab (v2)

El SDK unificado de PlayFab reemplaza la colección de paquetes de SDK v1 independientes por un único producto cohesionado que cubre toda la funcionalidad de PlayFab. En lugar de descargar, instalar y actualizar varios SDK de forma independiente, trabaja con un solo SDK que incluye todo lo que necesita.

Qué incluye

El SDK unificado agrupa los siguientes componentes en una sola instalación:

Ventajas clave

  • Un solo SDK: un único proceso de instalación y actualización para todas las características de PlayFab; se acabó administrar paquetes separados para Services, Party y Multiplayer
  • Autenticación unificada: autentíquese una vez y reciba un único PFEntityHandle que funciona en todos los componentes. Ya no hay que recuperar y pasar tokens de entidad manualmente entre servicios
  • Administración automática de tokens: la actualización de tokens en segundo plano controla automáticamente la renovación del Entity Token, lo que evita la expiración de la sesión durante sesiones de juego prolongadas sin ningún código de solución alternativa
  • Modelo de programación coherente: todos los componentes siguen patrones estandarizados para la inicialización, las llamadas a la API, el control de errores y las operaciones asincrónicas; aprenda un patrón y úselo en todas partes
  • Administración de memoria personalizada: conecte sus propios asignadores de memoria mediante PFMemoryHooks para un control detallado en entornos con recursos limitados o de alto rendimiento
  • Control avanzado de subprocesos: la integración con XTaskQueue proporciona modos de distribución flexibles (Manual, ThreadPool, SerializedThreadPool, Immediate) para que pueda controlar exactamente cómo y dónde se ejecuta el trabajo asincrónico
  • Seguimiento de depuración integrado: sistema de seguimiento extensible para supervisar las solicitudes de API, las respuestas y los errores en todos los componentes desde una única salida de depuración
  • Preparado para el futuro: todas las nuevas capacidades de PlayFab, las expansiones de plataformas y las mejoras de rendimiento se dirigen exclusivamente a v2
¿Ya usa v1? Consulte Migración de v1 a v2 para obtener una guía paso a paso. La migración normalmente simplifica su base de código al eliminar la administración manual de tokens y unificar la lógica de inicialización entre componentes.

Comparación de la experiencia de desarrollo

Los siguientes ejemplos ilustran cómo v2 simplifica las tareas comunes en comparación con v1:

SDK independientes de PlayFab (v1)

Los SDK independientes v1 constan de paquetes de SDK separados para diferentes características de PlayFab. Aunque siguen siendo totalmente compatibles, requieren administrar varias instalaciones de SDK y coordinar manualmente los componentes. Los SDK v1 siguen recibiendo correcciones críticas, pero las nuevas características y la compatibilidad con plataformas se desarrollan exclusivamente para v2.

Componentes de SDK (v1)

Plataformas compatibles

La siguiente tabla compara la compatibilidad de plataformas entre el SDK unificado v2 y los SDK independientes v1:
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.

Consulte también

Última modificación el 28 de agosto de 2026