Amazon GameLift Serversplugin pour Unity (SDK de serveur 4.x)

Pour télécharger et installer le plugin pour Unity

1. Téléchargez le Amazon GameLift Servers plugin pour Unity. Vous pouvez trouver la dernière version sur la page du référentiel du Amazon GameLift Servers plugin pour Unity. Dans la dernière version, choisissez Assets, puis téléchargez le com.amazonaws.gamelift-version.tgz fichier.

2. Lancez Unity et choisissez un projet.

3. Dans la barre de navigation supérieure, sous Window, choisissez Package Manager :

   

4. Dans l'onglet Gestionnaire de packages, choisissez +, puis choisissez Ajouter un package depuis une archive... :

   

5. Dans la fenêtre Sélectionner les packages sur le disque, accédez au com.amazonaws.gamelift dossier, choisissez le fichiercom.amazonaws.gamelift-version.tgz , puis choisissez Ouvrir :

   

6. Une fois que Unity a chargé le plug-in, Amazon GameLift Serversil apparaît sous la forme d'un nouvel élément dans le menu Unity. L'installation et la recompilation des scripts peuvent prendre quelques minutes. L'onglet Paramètres du Amazon GameLift Servers plugin s'ouvre automatiquement.

   

7. Dans le volet SDK, choisissez Utiliser .NET 4.x.

   Une fois configuré, le statut passe de Non configuré à Configuré.

1. Dans la fenêtre du plugin pour Unity, choisissez l'onglet Test.

2. Dans le volet Test, choisissez Download Amazon GameLift Servers Local. Le plugin pour Unity ouvre une fenêtre de navigateur et télécharge le GameLift_06_03_2021.zip fichier dans votre dossier de téléchargements.

   Le téléchargement inclut le SDK du serveur C#, les fichiers source .NET et un composant .NET compatible avec Unity.

3. Décompressez le fichier GameLift_06_03_2021.zip téléchargé.

4. Dans la fenêtre Paramètres du Amazon GameLift Servers plugin, choisissez Amazon GameLift ServersLocal Path, accédez au dossier décompressé, choisissez le fichierGameLiftLocal.jar, puis choisissez Ouvrir.

   Une fois configuré, le statut des tests locaux passe de Non configuré à Configuré.

5. Vérifiez l'état du JRE. Si le statut est Non configuré, choisissez Télécharger JRE et installez la version Java recommandée.

   Après avoir installé et configuré l'environnement Java, le statut passe à Configuré.

1. Dans l'onglet Plugin pour Unity, choisissez l'onglet Test.

2. Dans le volet Test, choisissez Open Local Test UI.

3. Dans la fenêtre de test local, spécifiez le chemin exécutable du serveur. Sélectionnez... pour sélectionner le chemin et le nom du fichier exécutable de votre application serveur.

4. Dans la fenêtre de test local, spécifiez un port GL local.

5. Choisissez Deploy & Run pour déployer et exécuter le serveur.

6. Pour arrêter votre serveur de jeu, choisissez Arrêter ou fermez les fenêtres du serveur de jeu.

Pour mettre à jour AWS les identifiants

1. Dans Unity, dans l'onglet Plug-in pour Unity, choisissez l'onglet Déployer.

2. Dans le volet Déployer, sélectionnez AWS Credentials.

3. Vous pouvez créer de nouvelles AWS informations d'identification ou choisir des informations d'identification existantes.

   • Pour créer des informations d'identification, choisissez Créer un nouveau profil d'informations d'identification, puis spécifiez le nouveau nom du profil, AWS l'ID de clé d'accès, la cléAWS secrète et Région AWS.

   • Pour choisir des informations d'identification existantes, choisissez Choisir un profil d'informations d'identification existant, puis sélectionnez un nom de profil et Région AWS.

4. Dans la fenêtre Mettre à jour les AWS informations d'identification, choisissez Mettre à jour le profil des informations d'identification.

Pour mettre à jour l'emplacement du bootstrap du compte

1. Dans Unity, dans l'onglet Plug-in pour Unity, choisissez l'onglet Déployer.

2. Dans le volet Déploiement, choisissez Update Account Bootstrap.

3. Dans la fenêtre Account Bootstrapping, vous choisissez un compartiment Amazon S3 existant ou vous créez un nouveau compartiment Amazon S3 :

   • Pour choisir un compartiment existant, choisissez Choisir un compartiment Amazon S3 existant et Mettre à jour pour enregistrer votre sélection.

   • Choisissez Créer un nouveau compartiment Amazon S3 pour créer un nouveau compartiment Amazon Simple Storage Service, puis choisissez une politique. La politique précise la date d'expiration du compartiment Amazon S3. Choisissez Create pour créer le bucket.

Pour déployer un scénario

1. Dans Unity, dans l'onglet Plug-in pour Unity, choisissez l'onglet Déployer.

2. Dans le volet Déploiement, choisissez Open Deployment UI.

3. Dans la fenêtre Déploiement, choisissez un scénario.

4. Entrez un nom de jeu. Il doit être unique. Le nom du jeu fait partie du nom de la AWS CloudFormation pile lorsque vous déployez le scénario.

5. Choisissez le chemin du dossier de compilation du serveur de jeu. Le chemin du dossier de construction pointe vers le dossier contenant le fichier exécutable du serveur et ses dépendances.

6. Choisissez le chemin du fichier .exe de compilation du serveur de jeu. Le chemin du fichier exécutable de compilation pointe vers le fichier exécutable du serveur de jeu.

7. Choisissez Démarrer le déploiement pour commencer à déployer un scénario. Vous pouvez suivre l'état de la mise à jour dans la fenêtre Déploiement sous État actuel. Le déploiement des scénarios peut prendre plusieurs minutes.

   

8. Lorsque le scénario est terminé, l'état actuel est mis à jour pour inclure l'ID du client Cognito et le point de terminaison API Gateway que vous pouvez copier et coller dans le jeu.

   

9. Pour mettre à jour les paramètres du jeu, dans le menu Unity, choisissez Accéder aux paramètres de connexion du client. Cela affiche un onglet Inspector sur le côté droit de l'écran Unity.

10. Désélectionnez le mode de test local.

11. Entrez le point de terminaison API Gateway et l'ID du client Coginito. Choisissez le même Région AWS que celui que vous avez utilisé pour le déploiement du scénario. Vous pouvez ensuite reconstruire et exécuter le client du jeu à l'aide des ressources du scénario déployées.

Pour supprimer les ressources créées par le scénario

1. Dans la fenêtre de déploiement du Amazon GameLift Servers plugin pour Unity, sélectionnez Afficher AWS CloudFormation la console pour ouvrir la AWS CloudFormation console.

2. Dans la AWS CloudFormation console, choisissez Stacks, puis choisissez la pile qui inclut le nom du jeu spécifié lors du déploiement.

3. Choisissez Supprimer pour supprimer la pile. La suppression d'une pile peut prendre quelques minutes. Après avoir AWS CloudFormation supprimé la pile utilisée par le scénario, son statut passe àROLLBACK_COMPLETE.

1. Dans Unity, dans le menu, choisissez Amazon GameLift Servers, puis choisissez Importer un exemple de jeu.

2. Dans la fenêtre Importer un exemple de jeu, choisissez Importer pour importer le jeu, ses actifs et ses dépendances.

3. Construisez le serveur de jeu. Dans Unity, dans le menu, choisissez Amazon GameLift Servers, puis choisissez Appliquer les paramètres de build de Windows Sample Server ou Appliquer les paramètres de build de macOS Sample Server. Après avoir configuré les paramètres du serveur de jeu, Unity recompile les ressources.

4. Dans Unity, dans le menu, choisissez Fichier, puis Build. Choisissez Server Build, choisissez Build, puis choisissez un dossier de build spécifiquement pour les fichiers du serveur.

   Unity construit l'exemple de serveur de jeu en plaçant le fichier exécutable et les ressources requises dans le dossier de compilation spécifié.

1. Dans Unity, dans le menu, choisissez Amazon GameLift Servers, puis choisissez Appliquer les paramètres de génération du client d'exemple de Windows ou Appliquer les paramètres de génération du client d'exemple de macOS. Une fois les paramètres du client de jeu configurés, Unity recompile les actifs.

2. Dans Unity, dans le menu, sélectionnez Accéder aux paramètres du client. Cela affichera un onglet Inspector sur le côté droit de l'écran Unity. Dans l'onglet Paramètres du Amazon GameLift Servers client, sélectionnez Mode de test local.

3. Créez le client du jeu. Dans Unity, dans le menu, choisissez Fichier. Vérifiez que Server Build n'est pas cochée, choisissez Build, puis sélectionnez un dossier de build spécifiquement pour les fichiers client.

   Unity crée l'exemple de client de jeu en plaçant l'exécutable et les ressources requises dans le dossier de construction du client spécifié.

4. Vous n'avez pas créé le serveur et le client de jeu. Dans les étapes suivantes, vous lancerez le jeu et vous verrez comment il interagit avecAmazon GameLift Servers.

1. Lancez le serveur de jeu. Dans Unity, dans l'onglet Plug-in pour Unity, choisissez l'onglet Déployer.

2. Dans le volet Test, choisissez Open Local Test UI.

3. Dans la fenêtre de test local, spécifiez le chemin du fichier .exe du serveur de jeu. Le chemin doit inclure le nom de l'exécutable. Par exemple, C:/MyGame/GameServer/MyGameServer.exe.

4. Choisissez Deploy and Run. Le plugin pour Unity lance le serveur de jeu et ouvre une fenêtre de journal Amazon GameLift Servers local. La fenêtre contient des messages de journal, notamment des messages envoyés entre le serveur de jeu et Amazon GameLift Servers Local.

5. Lancez le client du jeu. Trouvez l'emplacement de compilation à l'aide de l'exemple de client de jeu et choisissez le fichier exécutable.

6. Dans le jeu Amazon GameLift Servers d'exemple, saisissez un e-mail et un mot de passe, puis choisissez Se connecter. L'e-mail et le mot de passe ne sont ni validés ni utilisés.

7. Dans le jeu Amazon GameLift Servers d'exemple, choisissez Start. Le client du jeu recherche une session de jeu. S'il ne trouve pas de session, il en crée une. Le client de jeu démarre ensuite la session de jeu. Vous pouvez voir l'activité du jeu dans les journaux.

1. Dans le client de jeu, choisissez Quitter ou fermez la fenêtre pour arrêter le client de jeu.

2. Dans Unity, dans la fenêtre de test local, choisissez Arrêter ou fermez les fenêtres du serveur de jeu pour arrêter le serveur.