Skip to main content

Inicializar Gaming Runtime Services

Las XSAPI dependen de Gaming Runtime Services (GRTS). Antes de llamar a cualquier XSAPI, inicialice GRTS, como se muestra a continuación.

Crear un XTaskQueue (opcional)

La mayoría de las XSAPI son API asincrónicas y requieren el uso de una cola de tareas. Es una API para poner en cola el trabajo y para las devoluciones de llamada de finalización de tareas. Para obtener más información sobre XTaskQueue y los diferentes modos de distribución, consulte Diseño de la cola de tareas asincrónicas. Por ejemplo, el código siguiente crea una cola de tareas usando un grupo de subprocesos del sistema.
Asegúrese de devolver al sistema el identificador de cola de tareas adquirido cuando ya no sea necesario.
Si decide no crear su propia cola de tareas, asegúrese de pasar nullptr cuando se necesite un identificador de cola. Cuando se usa nullptr, el sistema de tareas usa ThreadPool de forma predeterminada. Esto puede invalidarse llamando a XTaskQueueSetCurrentProcessTaskQueue.

Configurar el seguimiento de HttpClient (opcional)

Para ver información de depuración adicional en tiempo de ejecución, asegúrese de configurar la funcionalidad de seguimiento de HttpClient. El código siguiente establece el nivel de seguimiento de HttpClient y habilita la salida de información para el depurador.

Inicializar XSAPI

Inicialice XSAPI antes de llamar a cualquier XSAPI.

Iniciar sesión del usuario en la red de XBOX

La mayoría de las XSAPI requieren que el usuario inicie sesión primero en la red de XBOX (también conocida como XBOX Live). Para que un usuario inicie sesión en la red de XBOX, consulte el ejemplo de código de la API XUserAddAsync.

Crear un objeto XboxLiveContext

Un objeto XboxLiveContext representa el contexto de servicio asociado a un usuario determinado. La mayoría de las XSAPI requieren que pase un XboxLiveContextHandle que representa el contexto del usuario que realiza la llamada. Para crear un contexto de XBOX Live (red), use la API XblContextCreateHandle y pase el objeto XUserHandle adquirido en el paso anterior.

Realizar una llamada de servicio a los servicios XBOX

Ahora que tiene un objeto XboxLiveContext asociado al objeto XUserHandle del usuario que ha iniciado sesión, puede realizar llamadas de servicio a los servicios XBOX. Por ejemplo, para recuperar la lista de amigos del usuario, puede hacer lo siguiente:

Limpieza de XSAPI

No es necesario llamar a XblCleanupAsync() en ningún escenario. En un escenario de terminación de la aplicación, actualmente no existe ninguna API XblCleanup() sincrónica a la que pueda llamar. La terminación de la aplicación, por la naturaleza de su ciclo de vida, debe controlarse de forma sincrónica e inmediata. Como resultado, se confía en la limpieza normal a nivel del sistema operativo, que se produce con la terminación del proceso de la aplicación, y esta es suficiente para esta situación. En un escenario en el que la aplicación se suspende, XSAPI se encarga de liberar y, después, restaurar los recursos del sistema necesarios para su funcionamiento, con el fin de mantener la funcionalidad tras la reanudación. XblCleanupAsync() todavía puede usarse en los casos en que su juego decida liberar deliberadamente los recursos asignados a XSAPI.
Última modificación el 28 de agosto de 2026