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

# Seguimiento de depuración en el SDK unificado de PlayFab

> Habilite y configure el seguimiento de depuración en el SDK unificado de PlayFab: establezca el nivel de detalle de HCTraceLevel, dirija la salida a Visual Studio o reenvíela a registros personalizados del juego.

El SDK unificado de PlayFab proporciona un sistema de seguimiento de depuración extensible para ayudar a los desarrolladores a supervisar el comportamiento interno de la API, realizar el seguimiento de errores e integrar los registros de PlayFab en la infraestructura de registro de su juego. La salida de depuración también se puede dirigir al panel Output de Visual Studio durante el desarrollo.

## Información general

El seguimiento de depuración es útil para:

* Supervisar las solicitudes y respuestas del SDK de PlayFab
* Diagnosticar errores en las llamadas a la API
* Integrarse con sistemas de registro personalizados
* Ajustar el nivel de detalle del registro por entorno (desarrollo frente a producción)
* Depurar problemas de multithreading mediante el seguimiento del identificador de subproceso

## Habilitación y configuración del seguimiento

Puede habilitar el seguimiento, establecer el nivel de detalle y configurar adónde se envía la salida mediante las siguientes llamadas a la API:

```cpp theme={null}
HCSettingsSetTraceLevel(HCTraceLevel::Verbose);  // Verbose, Error, or Off
HCTraceSetTraceToDebugger(true);                 // Route to Visual Studio Output window
HCTraceSetClientCallback(TraceCallback);         // Custom trace handler
```

## Niveles de seguimiento

| Nivel                   | Descripción                                            |
| ----------------------- | ------------------------------------------------------ |
| `HCTraceLevel::Off`     | Deshabilita todo el seguimiento                        |
| `HCTraceLevel::Error`   | Registra solo las llamadas a la API con error          |
| `HCTraceLevel::Verbose` | Registra todas las solicitudes, respuestas y metadatos |

## Integración con sistemas de registro personalizados

### Función auxiliar GameLog

```cpp theme={null}
#include <iostream>
#include <string>

void GameLog(const std::string& levelStr, const std::string& message)
{
    std::cout << "[" << levelStr << "] " << message << std::endl;
}
```

### Ejemplo de devolución de llamada de seguimiento

```cpp theme={null}
#include <sstream>

void CALLBACK TraceCallback(
    const char* areaName,
    HCTraceLevel level,
    uint64_t threadId,
    uint64_t timestamp,
    const char* message)
{
    std::ostringstream oss;

    std::string levelStr;
    switch (level)
    {
        case HCTraceLevel::Error:   levelStr = "Error";   break;
        case HCTraceLevel::Verbose: levelStr = "Verbose"; break;
        default:                    levelStr = "Log";     break;
    }

    oss << "[" << areaName << "] [Thread " << threadId << "] " << message;
    GameLog(levelStr, oss.str());
}
```

### Inicialización

```cpp theme={null}
void InitializePlayFabTracing()
{
    HCSettingsSetTraceLevel(HCTraceLevel::Verbose);
    HCTraceSetTraceToDebugger(true);  // Set to false to suppress VS Output pane
    HCTraceSetClientCallback(TraceCallback);
}
```

## Procedimientos recomendados

* **Verbose en desarrollo**: habilita un seguimiento completo para la depuración y el control de calidad.
* **Error u Off en producción**: reduce el impacto en el rendimiento y el volumen de registros.
* **Centralice el registro**: use una función unificada `GameLog` o similar para agregar los registros de PlayFab y otros sistemas.
* **Depure el multithreading**: use el identificador de subproceso en los registros para identificar problemas de simultaneidad.

## Consulte también

* [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)


## Related topics

- [SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/overview.md)
- [Administración de memoria en el SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/memory-management.md)
- [Realización de llamadas asincrónicas en el SDK unificado de PlayFab](/es/services/playfab/sdks/unified-sdk/async-model.md)
- [Implementación de Game Saves con el GDK de octubre de 2025](/es/services/playfab/player-progression/game-saves/october-2025-gdk-changes.md)
- [Productos de SDK de PlayFab](/es/services/playfab/sdks/sdk-products.md)