Ejemplo de Wrapper

​

Contenido del ejemplo

• Wrapper: integra el paquete NuGet más reciente del SDK de servidor de juego de PlayFab (GSDK) con su servidor de juego. Esta aplicación wrapper no está pensada para su uso en producción
• Fakegame: un servidor de juego básico que no tiene conocimiento alguno del GSDK. Es como un servidor de juego típico que tendría antes de usar PlayFab Multiplayer Servers. Inicia Kestrel, el servidor web de ASP.NET Core, que escucha en el puerto TCP 80. Está pensado para simular un servidor de juego que no tiene absolutamente ningún conocimiento del GSDK. Puede usarlo si no tiene un servidor de juego propio. Tiene dos rutas GET que podemos usar: /hello para obtener una respuesta simple y /hello/terminate, que puede terminar el servidor.

​

Requisitos

• SDK de .NET Core 3.1 x64

​

Tutorial

​

Obtención y compilación del ejecutable de Wrapper

• Obtenga el ejemplo de wrapper del GSDK usando los métodos estándar de Git o descargándolo como archivo zip
• Abra el símbolo del sistema y use el comando cd para cambiar la ruta del directorio a la ubicación del archivo wrapper.csproj. Ejemplo: cd C:/ReplaceWithYourFilePath/wrappingGsdk/wrapper
• A continuación, ejecute el siguiente comando de la CLI de .NET Core:

dotnet publish --self-contained -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true

​

Creación de un recurso de servidor de juego

​

Uso del servidor de juego Fakegame con el wrapper

• Abra PowerShell
• Use el comando cd para cambiar la ruta del directorio a la ubicación del script build.ps1. Ejemplo: cd C:/ReplaceWithYourFilePath/wrappingGsdk/
• Ejecute \build.ps1
• Después de que el script se ejecute correctamente, vaya a la carpeta ..\wrappingGsdk\drop. Encontrará un archivo gameassets.zip que contiene la compilación del servidor de juego falso, el ejecutable del wrapper (compilado en el paso anterior) y otros archivos necesarios.

​

Uso de sus propios archivos de servidor de juego con el wrapper

• Siga las instrucciones de Compilación del ejecutable del wrapper
• Vaya a la ubicación de publicación del wrapper en ..\wrappingGsdk\wrapper\bin\Debug\netcoreapp3.1\win-x64\publish
• En otra ventana, vaya a la compilación de su servidor de juego y a los archivos necesarios para ejecutarla. Si no está seguro de qué archivos se necesitan, consulte Determinación de los archivos DLL necesarios
• Copie la compilación del servidor de juego y todos los archivos necesarios en la ubicación de publicación del wrapper
• Seleccione todos los archivos de la ubicación de publicación del wrapper
• Con todos los archivos seleccionados, haga clic con el botón derecho y seleccione Send to > Compressed (zip) files to zip. No seleccione la carpeta de publicación del wrapper para agregarla al zip. Esto provocaría una asignación incorrecta.

​

Creación y carga de la imagen de contenedor de Linux (solo para servidores Linux)

1. Configure su dispositivo de desarrollo de Windows (opcional)
2. Obtenga sus credenciales de inicio de sesión del registro de contenedor de PlayFab
3. Use un Dockerfile existente o cree el suyo propio Este paso es diferente según use FakeGame o su propio servidor de juego.
   • Si usa FakeGame, compruebe que tiene el Dockerfile
   • Si usa su juego o necesita crear un Dockerfile, consulte Creación de su Dockerfile. Puede usar el Dockerfile de FakeGame como punto de partida.
4. Abra su terminal de Linux con Docker instalado, como Ubuntu. Reemplace los valores de las variables TAG y ACR por sus valores. A continuación, ejecute los comandos siguientes.

TAG="0.1"
ACR="customer5555555.azurecr.io"
docker login ${ACR}

5. Escriba el nombre de usuario y la contraseña obtenidos en el paso anterior.
6. Compile y cargue la imagen de contenedor de Linux.

docker build -t ${ACR}/wrapper:${TAG} .
docker push ${ACR}/wrapper:${TAG}

​

Implementación de una compilación con Game Manager o la API

​

Implementación de servidores de juego de Windows

• Uso de Game Manager para implementar y configurar servidores
• Uso de PowerShell/API para implementar y configurar servidores

• Comando de inicio:
  • Use C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2
  • Reemplace fakegame.exe por el nombre del ejecutable de su servidor de juego, si usa su propia compilación de servidor de juego
• Configuración de red: Nombre: gameport, Puerto: 80, Protocolo: TCP
• Recursos: cuando use FakeGame, cargue gameassets.zip como recurso.

​

Implementación de servidores de juego de Linux

• Uso de Game Manager para implementar y configurar servidores
• Uso de PowerShell/API para implementar y configurar servidores

• Seleccione el contenedor que cargó
• Configuración de red: Nombre: gameport, Puerto: 80, Protocolo: TCP
• No es necesario cargar recursos ni establecer el Start Command

​

Ejecución del wrapper con LocalMultiplayerAgent

"AssetDetails": [
    {
        "MountPath": "C:\\Assets",
        "SasTokens": null,
        "LocalFilePath": "C:\\projects\\gsdkSamples\\wrappingGsdk\\drop\\gameassets.zip"
    }
],
"StartGameCommand": "C:\\Assets\\wrapper.exe -g C:\\Assets\\fakegame.exe",

// if you are using fakegameserver you should also configure port mapping for port 80
"PortMappingsList": [
            [
                {
                    "NodePort": 56100,
                    "GamePort": {
                        "Name": "gameport",
                        "Number": 80,
                        "Protocol": "TCP"
                    }
                }
            ]
        ]

​

Cómo conectarse a un servidor de juego en MPS

​

Uso de Game Manager

1. Inicie sesión en Game Manager
2. Vaya a la página Multiplayer => Servers y seleccione su compilación
3. Vaya a la página Servers y haga clic en el botón “Request server”.
4. En la página siguiente, tome nota de la dirección IPv4 pública y del puerto.
5. Use curl para conectarse en http://[IPV4Address]:[Ports->Num]/Hello.”

​

Uso del ejemplo MPS Allocator

1. Compile y ejecute el ejemplo MPS Allocator.
2. Aplique el comando “ListBuildSummaries” para ver las compilaciones disponibles y sus identificadores de compilación correspondientes.
3. Invoque “RequestMultiplayerServer” para iniciar una solicitud de una instancia de servidor de juego.
4. Introduzca el identificador de compilación seleccionado en el comando “ListMultiplayerServers” para generar una lista de servidores disponibles.
5. Elija una instancia de servidor de juego activa y, a continuación, use “GetMultiplayerServerDetails” con los identificadores de compilación y de sesión obtenidos en los pasos anteriores.
6. Tome nota de IPV4Address y Ports->Num que se muestran en la respuesta.
7. Use curl para conectarse en http://[IPV4Address]:[Ports->Num]/Hello.

​

Consulte también

• Creación de su primer servidor
• Recursos y ejemplos
• SDK de PlayFab Multiplayer Server
• Referencia de API