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

# SDK unificado de PlayFab

> Información general del SDK unificado v2 de PlayFab que consolida Core, Services, Multiplayer, Party y GameSave con autenticación unificada y actualización de tokens.

El SDK unificado de PlayFab es la plataforma de desarrollo de próxima generación que consolida todas las bibliotecas cliente de PlayFab en un único producto cohesionado. Proporciona una experiencia de integración coherente y simplificada en todos los componentes de PlayFab, lo que mejora la interoperabilidad y simplifica el desarrollo de clientes.

## Información general

El [SDK de C/C++ de PlayFab Services](/services/playfab/sdks/c) 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.

<Note>
  Los SDK independientes de PlayFab (v1) existentes siguen siendo compatibles, pero recomendamos el SDK unificado de PlayFab (v2) para proyectos nuevos.
</Note>

## 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 el `PFEntityHandle` resultante 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:

| Plataforma                                 | SDK de C/C++                                                 | NuGet de C/C++                                                                                | Unreal Engine                                          | Unity                                                 |
| ------------------------------------------ | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------- |
| **Windows (PC y dispositivos portátiles)** | GDK 2510+                                                    | —                                                                                             | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **XBOX (One, Series S/X, Cloud)**          | GDK 2510+                                                    | —                                                                                             | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **Steam Deck**                             | GDK 2510+                                                    | —                                                                                             | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **PlayStation®5** ¹                        | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5)     | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5/_artifacts/feed/PS5GeneralV2)         | ¹                                                      | ¹                                                     |
| **PlayStation®4** ¹                        | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4)     | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4/_artifacts/feed/PS4GeneralV2)         | ¹                                                      | ¹                                                     |
| **Nintendo Switch 2** ¹                    | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2/_artifacts/feed/Switch2GeneralV2) | ¹                                                      | ¹                                                     |
| **Nintendo Switch** ¹                      | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch)  | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch/_artifacts/feed/SwitchGeneralV2)   | ¹                                                      | ¹                                                     |

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

*"PlayStation" es una marca comercial de Sony Interactive Entertainment Inc.*

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

| Plataforma                                 | Core       | Services   | GameSave                        | Multiplayer (Lobby/Matchmaking) | Party Data | Party Voice |
| ------------------------------------------ | ---------- | ---------- | ------------------------------- | ------------------------------- | ---------- | ----------- |
| **Windows (PC y dispositivos portátiles)** | Compatible | Compatible | Compatible                      | Compatible                      | Compatible | Compatible  |
| **XBOX (One, Series S/X, Cloud)**          | Compatible | Compatible | Compatible                      | Compatible                      | Compatible | Compatible  |
| **Steam Deck**                             | Compatible | Compatible | Compatible                      | Compatible                      | Compatible | Compatible  |
| **PlayStation®5**                          | Compatible | Compatible | Compatible (versión preliminar) | Compatible                      | Compatible | Compatible  |
| **PlayStation®4**                          | Compatible | Compatible | —                               | Compatible                      | Compatible | Compatible  |
| **Nintendo Switch 2**                      | Compatible | Compatible | —                               | Compatible                      | Compatible | Compatible  |
| **Nintendo Switch**                        | Compatible | Compatible | —                               | Compatible                      | Compatible | Compatible  |

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](https://github.com/microsoft/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](/reference/system/xtaskqueue/xtaskqueue_members) para la administración de subprocesos.
* **[PlayFab Core](/services/playfab/sdks/playfab-sdk-intro)**: 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](/services/playfab/sdks/playfab-sdk-intro)**: servicios compartidos para LiveOps, economía y progresión.
* **[PlayFab Multiplayer](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)**: servicios de creación de salas y matchmaking.
* **[PlayFab Party](/services/playfab/multiplayer/networking/party-sdks/overview)**: 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](/services/playfab/player-progression/game-saves/overview)**: almacenamiento y sincronización de partidas guardadas en la nube para conservar el progreso del jugador entre dispositivos y sesiones.

## Prácticas de desarrollo

El SDK unificado extiende a todos los componentes las prácticas de desarrollo modernas introducidas en 2023 en el [SDK de C/C++ de PlayFab Services](/services/playfab/sdks/c):

* [Operaciones asincrónicas](/services/playfab/sdks/unified-sdk/async-model)
* [Administración de memoria](/services/playfab/sdks/unified-sdk/memory-management)
* [Seguimiento y diagnóstico](/services/playfab/sdks/unified-sdk/debug-trace)

## Control de versiones

El SDK unificado de PlayFab sigue los principios de [versionamiento semántico](https://semver.org/), a partir de la versión 2.0.0, lo que garantiza una administración de versiones predecible y coherente.


## Related topics

- [Administración de memoria en el SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/memory-management.md)
- [Seguimiento de depuración en el SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/debug-trace.md)
- [PlayFab para Unity (v2 unificado)](/es/services/playfab/sdks/unified-unity/overview.md)
- [Realización de llamadas asincrónicas en el SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/async-model.md)
- [Configuración del inicio rápido del SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/quickstart-setup.md)
