​

Implementación local y depuración del proyecto de ejemplo ThirdPersonMP

​

Objetivos

• Probar las opciones de implementación local para el proyecto ThirdPersonMP+GSDK.
• Comprobar que el servidor se ejecuta correctamente cuando se ejecuta con LocalMultiplayerAgent
• Comprobar que puede asociar un depurador a la instancia del servidor

​

Requisitos

• Descargue Visual Studio. La versión Community es gratuita.
  • Cargas de trabajo necesarias: desarrollo de escritorio de .NET y desarrollo para el escritorio con C++
• Descargue el código fuente de Unreal Engine. Para obtener instrucciones, consulte Descarga del código fuente de Unreal Engine (externo).
• Proyecto de Unreal completado con el GSDK de Unreal de PlayFab instalado y configurado
• Configuración “Development Server” de su proyecto compilada desde Visual Studio
• [Opcional] Descargue el LocalMultiplayerAgent
  • [Opcional] Como alternativa, descargue el código fuente de LocalMultiplayerAgent.
• Configuración “Debug” o “Release” de LocalMultiplayerAgent compilada desde este repositorio con Visual Studio
  • Con Visual Studio, abra MpsAgent.sln, seleccione la configuración Debug o Release y, a continuación, compile el LocalMultiplayerAgent.
• [Opcional] Instale Docker para Windows

​

Notación

• {depot}/ThirdPersonMP
• {depot}/MpsAgent
• [Opcional] {depot}/gsdk [Contiene el complemento GSDK de Unreal de PlayFab instalado previamente en ThirdPersonMP]
• [Opcional] {depot}/UnrealMarketplacePlugin [Contiene el complemento de Unreal Marketplace de PlayFab, que no es necesario para esta guía, pero sí para la mayoría de las características de PlayFab]

​

Instrucciones

​

Ejecución local, sin contenedores

{
  "RunContainer": false,
  "OutputFolder": "<Local absolute path that will be used to store the required output artifacts>",
  ...
  "AssetDetails": [
    {
      "MountPath": "C:\\Assets",
      "LocalFilePath": "{PATH-TO-ZIP}"
    }
  ],
  ...
  "PortMappingsList": [
    [
      {
        "NodePort": 30000,
        "GamePort": {
          "Name": "gameport",
          "Number": 8888,
          "Protocol": "UDP"
        }
      }
    ]
  ],
  "ProcessStartParameters": {
    "StartGameCommand": "{PATH-TO-EXE} -log"
  },
  "ContainerStartParameters": {
    "StartGameCommand": "C:\\Assets\\ThirdPersonMPServer.exe -log",
    ...
  }
}

• RunContainer: para esta guía, siempre será false. Establecerlo en true requiere Docker.
  • Cuando es true, se ignora ProcessStartParameters/StartGameCommand y se usa ContainerStartParameters/StartGameCommand en su lugar
  • Cuando es true, todo se compila y se ejecuta en un contenedor de Docker, en lugar de en el contexto de la máquina local
  • Esta guía cubre el escenario en el que RunContainer es false, para que podamos depurar más fácilmente el proceso del servidor
  • Establecerlo en true requiere una compilación de servidor Shipping, además de Docker para Windows
• OutputFolder: "<Local absolute path that will be used to store the required output artifacts>"
  • Esta ubicación debe estar completamente definida y debe existir un directorio válido en esta ubicación.
• AssetDetails/LocalFilePath: {PATH-TO-ZIP}
  • Esta ubicación debe estar completamente definida y debe existir un archivo zip válido en esta ubicación
  • Este archivo zip debe contener una compilación “Shipping Server” completamente construida
• PortMappingsList:
  • Es el equivalente en LocalMultiplayerAgent de definir el puerto en Game Manager
  • El complemento GSDK está codificado de forma rígida para buscar un puerto con el nombre: gameport
  • El método SetDefaultServerHostPort del complemento GSDK invalidará internamente el puerto interno de hospedaje del servidor de Unreal para que coincida con este puerto
  • El complemento GSDK usará únicamente el puerto denominado gameport, que se configura en PortMappingsList cuando se usa LocalMultiplayerAgent.
  • Este json le permite probar localmente que este número de puerto proviene de MPS y garantiza que su complemento GSDK lo recibirá correctamente
• ContainerStartParameters/StartGameCommand: mientras RunContainer sea false, no se usa.
  • Cuando RunContainer==true, reemplaza a ProcessStartParameters/StartGameCommand
  • Esta ruta de acceso es la ruta interna dentro del contenedor de Docker y será la suma de AssetDetails/MountPath más la ruta interna al ejecutable en su archivo zip definido por AssetDetails/LocalFilePath
  • Para este ejemplo, podría ser: C:\\Assets\\ThirdPersonMPServer.exe -log
• ProcessStartParameters/StartGameCommand: este comando será, en la práctica, la ruta de acceso a su ejecutable y los parámetros de línea de comandos que se usan para iniciar su servidor de juego
  • -log es un comando de Unreal para indicar al servidor de juego que guarde un registro de ejecución
  • {PATH-TO-EXE} puede ser una de dos opciones:
    • Cualquier ruta de acceso absoluta a un ejecutable de su servidor de juego (incluso un servidor de juego de desarrollo), más los parámetros de línea de comandos de su servidor
      • Esta opción ignora el contenido del archivo zip y, en su lugar, ejecuta cualquier ejecutable arbitrario en cualquier ubicación
      • Es una opción de depuración local que solo funciona en su máquina local para depurar compilaciones de desarrollo: no le ayuda a comprobar que su archivo zip está listo para cargarse en MPS
      • Esta opción debe usarse al probar un servidor de desarrollo, adecuado para asociar un depurador de VS
      • Para este ejemplo, podría ser: {depot}\\ThirdPersonMP\\Binaries\\Win64\\ThirdPersonMPServer.exe -log
      • Para el autor, es: M:\\depot\\GSDK\\ThirdPersonMPGSDK\\Binaries\\Win64\\ThirdPersonMPServer.exe -log
    • Una ruta de acceso relativa, que debe indicar la ruta relativa dentro de su archivo zip, para ejecutar su servidor
      • Es el flujo de trabajo estándar que refleja cómo funciona en una instancia en la nube de MPS
      • Esta opción debe usarse al probar un servidor shipping y ayuda a comprobar que su zip está listo para cargarse en MPS
      • Para este ejemplo, podría ser: ThirdPersonMPServer.exe -log

​

Depuración del servidor

​

Solución de problemas

​

Muchas instancias de ThirdPersonMPServer en el Administrador de tareas

​

LocalMultiplayerAgent inicia dos instancias de ThirdPersonMPServer

​

Pasos siguientes