View a markdown version of this page

Migre al SDK 5.x del servidor para Servidores Amazon GameLift - GameLift Servidores Amazon

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Migre al SDK 5.x del servidor para Servidores Amazon GameLift

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

nota

Si necesita seguir usando la versión 4.x, o una versión anterior, del SDK del servidor, consulte SDK de servidor para Servidores Amazon GameLift versión 4 y anteriores para obtener documentación y la información de descarga. En concreto, para la versión 4.0.2 del SDK, puedes descargarla desde las versiones oficiales GitHub .

  1. Obtenga el paquete más reciente del SDK del servidor de Amazon GameLift Servers para su entorno de desarrollo [sitio de descarga]. Sigue las instrucciones de instalación que aparecen en el Readme archivo correspondiente al paquete y la versión descargados. Consulte estas instrucciones para usar los SDK del servidor con el proyecto de juego.

  2. Actualice el código del servidor de la siguiente manera:

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

    • Actualice las entradas InitSDK() como corresponda:

      • Si planea implementar la compilación del servidor de juegos en una flota de EC2 administrada por Amazon GameLift Servers o en una flota de Anywhere con el agente de Amazon GameLift Servers:

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

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

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

  3. Si la compilación del servidor de juegos, u otras aplicaciones alojadas, se comunican con otros recursos de AWS mientras se están ejecutando, tendrá que cambiar cómo accede la aplicación a esos recursos. Sustituya el uso de AssumeRoleCredentials por la nueva acción GetFleetRoleCredentials() del SDK del servidor (para servidores de juegos) o utilice credenciales compartidas (para otras aplicaciones). Para obtener más información sobre cómo implementar este cambio, consulte Conecta tus GameLift Servidores Amazon servidor de juegos alojado a otro AWS recursos.

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

  5. Cuando subas la compilación de tu juego a Amazon GameLift Servers (por ejemplo, con upload-build o CreateBuild ()), establece el ServerSdkVersion parámetro en la versión 5.x que estás usando (este parámetro actualmente es 4.0.2 por defecto). Este parámetro debe coincidir con las bibliotecas reales del SDK del servidor en la compilación del servidor del juego. Si especifica una versión incorrecta para una compilación de servidor de juegos cargada, todas las flotas que cree con esa compilación generarán errores. Consulte Cree una compilación de servidor de juegos para GameLift Servidores Amazon.

    En el siguiente ejemplo, se muestra cómo especificar la versión del SDK 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 administradas, actualice los scripts para utilizar el nuevo proceso, tal y como se describe en Conéctese a las instancias de la flota.