> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Productos de SDK de PlayFab

> Compare las líneas de productos de los SDK independientes v1 de PlayFab y el SDK unificado v2, y elija la biblioteca cliente adecuada para proyectos de juego nuevos o existentes.

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](/services/playfab/sdks/unified-sdk/migrating-from-v1) 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.

<Info>
  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.
</Info>

## SDK unificado de PlayFab (v2)

El [SDK unificado de PlayFab](/services/playfab/sdks/unified-sdk/overview) 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:

| Componente              | Descripción                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| **PlayFab Core**        | Autenticación, administración de entidades, telemetría y registro                              |
| **PlayFab Services**    | LiveOps, economía, progresión y análisis de datos                                              |
| **PlayFab GameSave**    | Almacenamiento y sincronización de partidas guardadas en la nube                               |
| **PlayFab Multiplayer** | Creación de salas, matchmaking y administración de sesiones                                    |
| **PlayFab Party**       | Redes en tiempo real, chat de voz y comunicación de texto con integración de Azure AI Services |

### 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

<Tip>
  ¿Ya usa v1? Consulte [Migración de v1 a v2](/services/playfab/sdks/unified-sdk/migrating-from-v1) 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.
</Tip>

### Comparación de la experiencia de desarrollo

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

| Tarea                       | v1 (SDK independientes)                                                                                    | v2 (SDK unificado)                                                                               |
| --------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Configuración**           | Descargar y configurar cada SDK por separado                                                               | Instalar un SDK con todos los componentes                                                        |
| **Autenticación**           | Recuperar manualmente los tokens de entidad, pasarlos entre servicios y actualizarlos antes de que expiren | Llamar al inicio de sesión una vez, recibir un `PFEntityHandle` y pasarlo a cualquier componente |
| **Actualización de tokens** | Escribir lógica de actualización personalizada para evitar la expiración de la sesión                      | Se controla automáticamente en segundo plano                                                     |
| **Control de errores**      | Patrones de error diferentes por SDK                                                                       | Notificación de errores coherente en todos los componentes                                       |

## SDK independientes de PlayFab (v1)

Los [SDK independientes v1](/services/playfab/sdks/sdk-overview) 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)

* [**SDK de PlayFab Services**](/services/playfab/sdks/playfab-sdk-intro): LiveOps, economía, matchmaking y análisis de datos
* [**SDK de PlayFab Party**](/services/playfab/multiplayer/networking/party-sdks/overview): redes y comunicación por chat de voz y texto
* [**SDK de PlayFab Lobby y Matchmaking**](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks): características de salas y matchmaking

## Plataformas compatibles

La siguiente tabla compara la compatibilidad de plataformas entre el SDK unificado v2 y los SDK independientes v1:

| Plataforma                             |      v2 (SDK unificado)     |   v1 (SDK independientes)   |
| -------------------------------------- | :-------------------------: | :-------------------------: |
| Windows (PC y dispositivos portátiles) |         ✅ Compatible        |         ✅ Compatible        |
| XBOX (One, Series S/X, Cloud)          |         ✅ Compatible        |         ✅ Compatible        |
| Steam Deck                             |         ✅ Compatible        | ❌ No compatible actualmente |
| PlayStation 4 ¹                        |         ✅ Compatible        |         ✅ Compatible        |
| PlayStation 5 ¹                        |         ✅ Compatible        |         ✅ Compatible        |
| Nintendo Switch ¹                      |         ✅ Compatible        |         ✅ Compatible        |
| Nintendo Switch 2 ¹                    |         ✅ Compatible        |         ✅ Compatible        |
| Linux                                  | ❌ No compatible actualmente |         ✅ Compatible        |
| iOS                                    | ❌ No compatible actualmente |         ✅ Compatible        |
| Android                                | ❌ No compatible actualmente |         ✅ Compatible        |
| macOS                                  | ❌ No compatible actualmente |         ✅ Compatible        |

<Note>
  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](/services/playfab/sdks/request-access-for-sdks-samples) para obtener más detalles.
</Note>

## Consulte también

* [SDK unificado de PlayFab (v2)](/services/playfab/sdks/unified-sdk/overview)
* [Información general de los SDK independientes (v1)](/services/playfab/sdks/sdk-overview)
* [Solicitar acceso a SDK y ejemplos](/services/playfab/sdks/request-access-for-sdks-samples)


## Related topics

- [SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/overview.md)
- [Notas de la versión del SDK de C/C++ de PlayFab Services](/es/services/playfab/release-notes/playfab-c/index.md)
- [Notas de la versión del SDK de PlayFab Services 2023](/es/services/playfab/release-notes/2023.md)
- [Notas de la versión del SDK de PlayFab Services 2024](/es/services/playfab/release-notes/2024.md)
- [Notas de la versión del SDK de PlayFab Services 2025](/es/services/playfab/release-notes/2025.md)