Saltar al contenido principal

Información general

El SDK de servidor de juegos (GSDK) de PlayFab se proporciona en versiones para C++, C# y Java. El GSDK conecta su servidor de juegos con el agente de PlayFab instalado en la máquina virtual. Este agente facilita las interacciones clave del servidor con la plataforma multijugador de PlayFab.

Integración básica

Para que su servidor de juegos pueda comunicarse con la plataforma multijugador de PlayFab, debe integrarlo con el GSDK. Como mínimo, debe implementar los métodos Start y ReadyForPlayers en su servidor de juegos.

Registro con el GSDK

Cuando el servidor de juegos finaliza, el agente de PlayFab de la máquina virtual comprime los archivos de registro y los pone a su disposición. <!—via the GetMultiplayerServerLogs API.—> Hay dos formas de agregar archivos de registro desde su juego:
  1. Use el método Log del GSDK: agregará sus propias líneas de registro al archivo de registro del GSDK.
  2. Escriba su propio archivo de registro en el directorio de registros adecuado, que el agente de PlayFab de la máquina virtual comprimirá y cargará.

Apagar correctamente el servidor de juegos

Hay tres escenarios en los que el servidor de juegos finalizará:
  1. La aplicación del servidor de juegos se cierra.
  2. PlayFab finaliza el servidor de juegos porque hay más servidores de juegos disponibles de los necesarios para la carga actual de jugadores.
PlayFab solo finalizará los servidores de juegos que no estén activos en ese momento.
  1. Azure realizará el mantenimiento necesario en la máquina virtual que hospeda el servidor de juegos.
Para el caso (1) anterior: usted controla cuándo sucede y puede realizar cualquier limpieza necesaria antes de que se cierre la aplicación. Para los casos (2) y (3) anteriores: el GSDK le proporciona una forma de saber cuándo se producirán mediante la especificación de un método de devolución de llamada.

Proporcionar a PlayFab información sobre el servidor de juegos

Actualmente, hay dos cosas que puede comunicar a PlayFab mediante el GSDK:
  1. El estado de mantenimiento actual del servidor de juegos.
  2. Una lista de los jugadores que están conectados actualmente al servidor de juegos.
Estos dos datos se transmitirán a PlayFab en el siguiente latido y actualmente se pueden usar para la generación de informes.

Obtener opciones de configuración en el servidor de juegos

Hay varias opciones de configuración de PlayFab relacionadas con el servidor de juegos que puede recuperar mediante el GSDK.
Dos de estas opciones de configuración las pasan en realidad sus clientes a PlayFab, como parte de la llamada para solicitar un servidor multijugador. Por lo tanto, esas opciones no estarán disponibles para el servidor de juegos hasta que se asigne.
Última modificación el 20 de octubre de 2026