Migre al GameLift servidor Amazon SDK 5.x

Para actualizar un proyecto de juego para que utilice la SDK versión 5.x del servidor, realiza los siguientes cambios:

1. Obtenga el SDK paquete Amazon GameLift Server más reciente para su entorno de desarrollo [sitio de descargas]. Siga las instrucciones de instalación del Readme archivo correspondiente al paquete y la versión descargados. Consulta estas instrucciones para usar el servidor SDKs con tu proyecto de juego.

   • Para entornos de desarrollo que utilizan C++, C# o Go

   • Para proyectos de Unreal Engine (servidor C++ solo SDK para bibliotecas de Unreal)

   • Para proyectos de Unity (servidor C# solo SDK para bibliotecas de Unity)

   • Para usar con el GameLift complemento de Amazon para Unreal Engine

   • Para usar con el GameLift complemento Amazon para Unity

2. Actualiza el código de tu servidor de la siguiente manera:

   • Cambie la función de devolución de llamada del código del servidor onCreateGameSession() aonStartGameSession().

   • Actualice las InitSDK() entradas según corresponda:

     • Si planeas implementar la versión del servidor del juego en una EC2 flota GameLift gestionada por Amazon o en una Anywhere flota con el GameLift agente de Amazon:

       Llama InitSDK() sin parámetros (C++) (C#) (Unreal). Esta llamada configura el entorno informático y una WebSocket conexión al GameLift servicio de Amazon.

     • Si planea implementar la versión del servidor de juegos en un Anywhere flota sin el GameLift agente de Amazon:

       Llame InitSDK() con los parámetros del servidor (C++) (C#) (Unreal). Un proceso de servidor de juegos utiliza estos parámetros para establecer una conexión con el GameLift servicio de Amazon.

3. Si la versión de tu servidor de juegos u otras aplicaciones alojadas se comunican con otros AWS recursos mientras se están ejecutando, tendrás que cambiar la forma en que la aplicación accede a esos recursos. Sustituya el uso AssumeRoleCredentials de por la nueva SDK acción de GameLift servidor de Amazon GetFleetRoleCredentials() (para servidores de juegos) o utilice credenciales compartidas (para otras aplicaciones). Para obtener más información sobre cómo implementar este cambio, consulteComuníquese con otros AWS recursos de sus flotas.

4. Si su proyecto ejecutó la SDK acción del servidor GetInstanceCertificate() para recuperar un TLS certificado, modifique el código para usar el nuevo código GetComputeCertificate() (C++) (C#) (Unreal) en su lugar.

5. Cuando subas la versión de tu juego a Amazon GameLift (por ejemplo, con upload-build o CreateBuild()), establece el ServerSdkVersion parámetro en la versión 5.x que estés utilizando (este parámetro actualmente tiene el valor predeterminado 4.0.2). Este parámetro debe coincidir con las SDK bibliotecas de servidor reales de la compilación del servidor del juego. Si especificas una versión incorrecta para una versión de servidor de juegos cargada, las flotas que crees con esa compilación fallarán. Consulte Implemente una compilación de servidor personalizada para Amazon GameLift Hosting.

   El siguiente ejemplo ilustra cómo especificar la SDK versión del servidor:

   aws gamelift upload-build \
       --operating-system AMAZON_LINUX_2023 \
       --server-sdk-version "5.0.0" \
       --build-root "~/mygame" \
       --name "My Game Nightly Build" \
       --build-version "build 255" \
       --region us-west-2

6. Si utiliza scripts para conectarse remotamente a flotas gestionadas, actualice los scripts para utilizar el nuevo proceso, tal y como se describe enConéctese remotamente a las instancias de GameLift la flota de Amazon.