Installez le plugin pour Unity

Cette section explique comment ajouter le plugin à un projet Unity. Une fois le plugin installé, les fonctionnalités du plugin sont disponibles lorsque le projet est ouvert dans l'éditeur Unity.

Avant de commencer

Voici ce dont vous avez besoin pour utiliser le GameLift plugin Amazon pour Unity :

• Unity pour Windows 2022 LTS ou Unity pour macOS

• Téléchargement GameLift du plugin Amazon pour Unity. [Site de téléchargement] Le téléchargement inclut deux packages :

  • Plug-in GameLift autonome Amazon pour Unity

  • SDK du serveur Amazon GameLift C# pour Unity

• Microsoft Visual Studio 2019 ou version ultérieure.

• Un projet de jeu multijoueur avec un code de jeu C#.

• Le registre UnityNuGet délimité par des tiers. Cet outil gère les DLL tierces. Pour plus d'informations, consultez le référentiel UnityNuGetGithub.

Ajoutez le plugin à votre projet de jeu

Effectuez les tâches suivantes en utilisant l'éditeur Unity et les fichiers de votre projet de jeu.

Étape 1 : Ajoutez UnityNuGet à votre projet de jeu

Si vous n'avez pas UnityNuGet configuré votre projet de jeu, procédez comme suit pour installer l'outil à l'aide du gestionnaire de packages Unity. Vous pouvez également utiliser la NuGet CLI pour télécharger manuellement les DLL. Pour plus d'informations, consultez le SDK du serveur Amazon GameLift C# pour Unity. README

1. Votre projet étant ouvert dans l'éditeur Unity, accédez au menu principal et sélectionnez Modifier, Paramètres du projet. Parmi les options, choisissez la section Package Manager et ouvrez le groupe Scoped Registries.

2. Cliquez sur le bouton + et entrez les valeurs suivantes pour le registre UnityNuGet délimité :

   Name: Unity NuGet
   URL: https://unitynuget-registry.azurewebsites.net
   Scope(s): org.nuget

Pour les utilisateurs de la version Unity 2021 :

Après la configuration UnityNuGet, vérifiez qu'aucune Assembly Version Validation erreur ne s'affiche dans la console Unity. Ces erreurs se produisent si les redirections de liaison pour les assemblages aux noms forts dans les NuGet packages ne sont pas résolues correctement vers les chemins de votre projet Unity. Pour résoudre ce problème, configurez la validation de la version d'assemblage de Unity :

1. Dans l'éditeur Unity, accédez au menu principal, sélectionnez Modifier, Paramètres du projet, puis ouvrez la section Lecteur.

2. Désélectionnez l'option Validation de la version d'assemblage.

Étape 2 : Ajouter le plugin et les packages SDK du serveur C#

1. Décompressez le GameLift plugin Amazon pour le téléchargement de Unity, qui contient les deux packages.

2. Votre projet étant ouvert dans l'éditeur Unity, allez dans le menu principal et sélectionnez Window, Package Manager.

3. Cliquez sur le bouton + pour ajouter un nouveau package. Choisissez l'option Ajouter un package à partir de l'archive tar.

4. Dans Sélectionner les packages sur disque, recherchez le plugin SDK Amazon GameLift C# Server pour les fichiers de téléchargement Unity, puis choisissez le com.amazonaws.gameliftserver.sdk-<version>.tgz fichier. Choisissez Ouvrir pour installer le plugin.

5. Dans Sélectionner les packages sur disque, recherchez le plugin GameLift autonome Amazon pour les fichiers de téléchargement Unity, puis choisissez le fichiercom.amazonaws.gamelift-<version>.tgz. Choisissez Ouvrir pour installer le plugin.

6. Vérifiez que le plugin autonome est ajouté à votre projet. Retournez dans la fenêtre de l'éditeur Unity. Consultez le menu principal pour voir s'afficher le nouveau bouton GameLift du menu Amazon.

Étape 3 : Importer l'exemple de jeu (facultatif)

Le plugin pour Unity est fourni avec un ensemble d'exemples de ressources de jeu, y compris des scènes, que vous pouvez ajouter à votre projet de jeu. L'importation de l'exemple de jeu vous permet de tester, de créer et de déployer rapidement un jeu multijoueur simple avec Amazon GameLift. L'exemple de jeu est déjà entièrement intégré aux GameLift SDK Amazon. Vous pouvez donc ignorer les tâches d'intégration et effectuer les tâches de flux de travail restantes.

En utilisant l'exemple de jeu, vous pouvez configurer et rejoindre une flotte Amazon GameLift Anywhere hébergée localement en quelques minutes. Vous pouvez déployer le jeu sur Amazon GameLift et rejoindre un jeu en direct hébergé dans le cloud en moins d'une heure.

Pour importer l'exemple de jeu, procédez comme suit :

1. Votre projet de jeu étant ouvert dans l'éditeur Unity, accédez au GameLift menu Amazon et sélectionnez Sample Game, Importer Sample Game.

2. Une fois les fichiers importés, accédez à nouveau au GameLift menu Amazon et sélectionnez Sample Game, Initialize Settings. Cette étape configure votre projet pour créer le client et le serveur du jeu.

Une fois l'installation terminée, deux nouvelles scènes seront ajoutées à votre projet de jeu. Vous verrez également d'autres actifs du projet, dont un GameLiftClientSettingsactif.

Pour plus de détails sur l'interface utilisateur et le gameplay de l'exemple, consultez le fichier readme de l'exemple de jeu.