Migrer vers le GameLift serveur Amazon SDK 5.x - Amazon GameLift

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Migrer vers le GameLift serveur Amazon SDK 5.x

Pour mettre à jour un projet de jeu afin qu'il utilise SDK la version 5.x du serveur, apportez les modifications suivantes :

  1. Procurez-vous le dernier SDK package Amazon GameLift Server pour votre environnement de développement [Site de téléchargement]. Suivez les instructions d'installation figurant dans le Readme fichier correspondant au package et à la version que vous avez téléchargés. Consultez ces instructions pour utiliser le serveur SDKs avec votre projet de jeu.

  2. Mettez à jour le code de votre serveur comme suit :

    • Remplacez la fonction de rappel du code du serveur paronCreateGameSession(). onStartGameSession()

    • Mettez à jour les InitSDK() entrées comme il convient :

      • Si vous envisagez de déployer la version du serveur de jeu sur une EC2 flotte GameLift gérée par Amazon ou sur un Anywhere flotte avec l' GameLift agent Amazon :

        Appel InitSDK() sans paramètres (C++) (C#) (Unreal). Cet appel configure l'environnement informatique et une WebSocket connexion au GameLift service Amazon.

      • Si vous envisagez de déployer la version du serveur de jeu sur un Anywhere flotte sans l' GameLift agent Amazon :

        Appel InitSDK() avec les paramètres du serveur (C++) (C#) (Unreal). Un processus de serveur de jeu utilise ces paramètres pour établir une connexion avec le GameLift service Amazon.

  3. Si la version de votre serveur de jeu ou d'autres applications hébergées communiquent avec d'autres AWS ressources en cours d'exécution, vous devez modifier la manière dont l'application accède à ces ressources. Remplacez l'utilisation de AssumeRoleCredentials par la nouvelle SDK action GameLift du serveur Amazon GetFleetRoleCredentials() (pour les serveurs de jeux) ou utilisez des informations d'identification partagées (pour les autres applications). Pour en savoir plus sur la mise en œuvre de cette modification, consultezCommuniquez avec les autres AWS ressources de vos flottes.

  4. Si votre projet a appelé l'SDKaction du serveur GetInstanceCertificate() pour récupérer un TLS certificat, modifiez votre code pour utiliser le nouveau GetComputeCertificate() (C++) (C#) (Unreal) à la place.

  5. Lorsque vous téléchargez la version de votre jeu sur Amazon GameLift (par exemple avec upload-build ou CreateBuild()), définissez le ServerSdkVersion paramètre sur la version 5.x que vous utilisez (ce paramètre est actuellement 4.0.2 par défaut). Ce paramètre doit correspondre aux SDK bibliothèques de serveur réelles de la version du serveur de jeu. Si vous spécifiez une version incorrecte pour une version de serveur de jeu téléchargée, toutes les flottes que vous créerez avec cette version échoueront. Consultez Déployez une version de serveur personnalisée pour l' GameLifthébergement Amazon.

    L'exemple suivant montre comment spécifier la SDK version du serveur : 

    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 vous utilisez des scripts pour vous connecter à distance à des flottes gérées, mettez-les à jour pour utiliser le nouveau processus, comme décrit dansConnectez-vous à distance aux instances GameLift de flotte Amazon.