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 sobreXTaskQueue 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.
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 deHttpClient.
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 objetoXboxLiveContext 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 objetoXboxLiveContext 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 aXblCleanupAsync() 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.