Préparation d'une candidature dans Amazon GameLift Streams - Amazon GameLift Streams

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.

Préparation d'une candidature dans Amazon GameLift Streams

Pour configurer le streaming avec Amazon GameLift Streams, vous devez d'abord télécharger le jeu ou l'autre application que vous souhaitez diffuser, puis vous configurez une ressource d'application dans Amazon GameLift Streams pour définir les métadonnées relatives à votre jeu. Une application Amazon GameLift Streams se compose des fichiers que vous avez chargés (fichiers exécutables et fichiers annexes) et d'une configuration indiquant à Amazon GameLift Streams quel exécutable exécuter lors du streaming.

Chaque application Amazon GameLift Streams représente une version unique de votre contenu. Si vous disposez de plusieurs versions, vous devez créer une application distincte pour chaque version. Une fois que vous avez créé une application, vous ne pouvez pas mettre à jour les fichiers. Si vous devez mettre à jour le fichier exécutable ou tout autre fichier de support, vous devez créer une nouvelle application Amazon GameLift Streams.

Avant de télécharger

Avant de créer une application Amazon GameLift Streams, vérifiez que votre jeu respecte les limites suivantes.

Nom Par défaut Ajustable Description
Fichiers par demande 30 000 fichiers Oui* Le nombre maximum de fichiers que vous pouvez avoir dans une application, dans ce compte.
Taille de fichier unique 80 GiO Non Taille maximale d'un seul fichier dans une application. Notez qu'un gibioctet (GiB) est égal à 1024*1024*1024 octets.
Taille de l'application 100 Gio Oui* Taille totale maximale d'une application Amazon GameLift Streams, dans ce compte. Notez qu'un gibioctet (GiB) est égal à 1024*1024*1024 octets.

*Pour demander une augmentation, connectez-vous AWS Management Console et ouvrez la console Service Quotas d'Amazon GameLift Streams, où vous pouvez consulter vos quotas actuels dans la colonne Valeur de quota appliquée au niveau du compte et soumettre une demande d'augmentation de valeur.

Note

Pour économiser du temps et des efforts, vérifiez que les fichiers que vous êtes prêt à télécharger sont la bonne version de votre application. Bien que vous puissiez télécharger de nouvelles versions ultérieurement, vous devrez répéter l'Création d’une applicationétape pour chaque version.

Chargez votre application dans un compartiment Amazon S3

Maintenant que vous avez préparé votre jeu pour Amazon GameLift Streams, il est temps de le télécharger dans AWS un bucket Amazon Simple Storage Service (Amazon S3) de votre compte.

Note

La classe de stockage Amazon S3 requise par Amazon GameLift Streams est la norme S3 par défaut. Les autres classes de stockage, telles que S3 Glacier ou les objets déplacés vers Infrequent Access ou Archive Access par S3 Intelligent-Tiering, ne sont pas prises en charge par Amazon Streams. GameLift

Pour optimiser les coûts de stockage, vous pouvez supprimer l'application de votre compartiment S3 une fois que vous avez terminé Création d’une application et que l'application est à l'état Prêt.

Pour télécharger votre application sur Amazon S3
  1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

  2. Créez un compartiment Amazon S3. Entrez un nom de compartiment et sélectionnez un Région AWS. Cette région doit être identique à l'application et au groupe de flux que vous créerez ultérieurement. Consultez Régions AWS et sites distants pris en charge par Amazon GameLift Streams la liste des Régions AWS endroits où Amazon GameLift Streams est disponible. Pour les autres champs, conservez les paramètres par défaut.

    Pour plus d'instructions, reportez-vous à la section Création d'un compartiment dans le guide de l'utilisateur d'Amazon Simple Storage Service.

  3. Ouvrez le nouveau compartiment et téléchargez le dossier contenant les fichiers de votre application.

    Avertissement

    Vous devez télécharger les fichiers de votre candidature sous forme de dossier non compressé. N'importez pas de .zip dossier.

Création d’une application

Une application Amazon GameLift Streams est une ressource qui contient le jeu ou tout autre logiciel que vous souhaitez diffuser, ainsi que les paramètres nécessaires à son exécution. Lorsque vous créez une application, vous indiquez le chemin d'accès aux fichiers d'application que vous avez chargés dans votre compartiment Amazon S3.

Amazon GameLift Streams ne synchronise pas automatiquement vos fichiers de jeu à partir du compartiment Amazon S3 que vous avez créé. Si vous souhaitez mettre à jour vos fichiers de jeu, vous devez créer une nouvelle application Amazon GameLift Streams.

Console
Pour créer une application Amazon GameLift Streams à l'aide de la console Amazon GameLift Streams
  1. Connectez-vous à la console Amazon GameLift Streams AWS Management Console et ouvrez-la. Choisissez le même Région AWS que le compartiment Amazon S3 dans lequel vous avez chargé votre ensemble de fichiers. Pour plus d'informations, reportez-vous à la section Choix d'une région dans le guide de AWS Management Console démarrage.

  2. Dans la barre de navigation, choisissez Applications, puis sélectionnez Créer une application.

  3. Dans les paramètres d'exécution, entrez les informations suivantes :

    1. Environnement d'exécution

      Il s'agit de l'environnement d'exécution sur lequel exécuter votre application. Amazon GameLift Streams peut fonctionner sous Windows, Ubuntu 22.04 LTS ou Proton.

      Vous ne pouvez pas modifier ce champ après le processus de création.

      Choisissez l'un des environnements d'exécution suivants .

      • Pour les applications Linux :

        • Ubuntu 22.04 () UBUNTU, 22_04_LTS

      • Pour les applications Windows :

        • Microsoft Windows Server 2022 Base (WINDOWS, 2022)

        • Proton 8,0-5 () PROTON, 20241007

        • Proton 8,0-2c () PROTON, 20230704

      Consultez les descriptions et utilisez la liste de contrôle de comparaison pour vous aider à sélectionner l'environnement d'exécution optimal pour votre application.

  4. Dans Paramètres généraux, entrez les informations suivantes :

    1. Description

      Il s'agit d'une étiquette lisible par l'homme pour votre application. Il n'est pas nécessaire que cette valeur soit unique. Pour les meilleures pratiques, utilisez une description, un nom ou une étiquette significatifs pour l'application. Vous pouvez modifier ce champ à tout moment.

    2. Chemin de base

      Il s'agit de l'URI Amazon S3 vers le dossier racine de votre application dans le compartiment Amazon S3. Le dossier doit contenir le fichier exécutable de votre build et tous les fichiers de support.

      Un URI valide est le préfixe du bucket qui contient tous les fichiers nécessaires à l'exécution et au streaming de l'application. Par exemple, un bucket appelé mygamebuild contient trois versions complètes des fichiers de compilation du jeu, chacune dans un dossier distinct. Vous souhaitez diffuser le build dans le dossiermygamebuild-EN101. Dans cet exemple, l'URI ests3://amzn-s3-demo-bucket/mygamebuild-EN101.

      Vous ne pouvez pas modifier ce champ après le processus de création.

    3. Chemin de lancement de l'exécutable

      Il s'agit de l'URI Amazon S3 vers le fichier exécutable qu'Amazon GameLift Streams diffusera. Le fichier doit se trouver dans le dossier racine de l'application.

      Vous ne pouvez pas modifier ce champ après le processus de création.

  5. (Facultatif) Dans le chemin du journal de l'application, entrez ce qui suit :

    1. Chemin du journal de l'application

      Il s'agit du chemin (ou des chemins) du dossier ou du fichier de l'application contenant les journaux que vous souhaitez enregistrer. Spécifiez chaque chemin de journal par rapport au chemin de base de votre application. Si vous utilisez cette fonctionnalité, à la fin de chaque session de streaming, Amazon GameLift Streams copie le ou les fichiers que vous spécifiez dans le compartiment Amazon S3 que vous nommez. L'opération de copie n'est pas effectuée de manière récursive dans les sous-dossiers d'un dossier d'application.

      Vous pouvez modifier ce champ à tout moment.

    2. Sortie du journal des applications

      Il s'agit de l'URI du compartiment Amazon S3 dans lequel Amazon GameLift Streams copiera les fichiers journaux de l'application. Ce champ est obligatoire si vous spécifiez le chemin du journal de l'application.

      Vous pouvez modifier ce champ à tout moment.

      Pour enregistrer des fichiers journaux en votre nom, Amazon GameLift Streams doit être autorisé à enregistrer votre compartiment S3. Si vous autorisez Amazon GameLift Streams à créer le compartiment pour la journalisation, la politique d'autorisation sera appliquée automatiquement lors de la création. Si vous fournissez votre propre bucket, vous devrez appliquer vous-même la politique d'autorisation.

      Modèle de politique d'autorisation de compartiment

      Copiez le code de politique suivant et appliquez-le au compartiment que vous souhaitez utiliser pour les journaux d'applications. Assurez-vous de remplacer amzn-s3-demo-bucket par le nom de votre compartiment S3 existant.

      { "Version": "2012-10-17", "Statement": [ { "Sid": "PutPolicy", "Effect": "Allow", "Principal": { "Service": [ "gameliftstreams.amazonaws.com" ] }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] }
  6. (Facultatif) Dans Balises, attribuez des balises à cette application.

    Les tags sont des libellés qui peuvent vous aider à organiser vos AWS ressources. Pour plus d'informations, consultez la section Marquage de vos ressources AWS.

    Par exemple, pour suivre les versions des applications, utilisez une balise telle queapplication-version : my-game-1121.

  7. Choisissez Créer une application.

CLI

Prérequis

Vous devez le configurer AWS CLI avec vos informations d'identification utilisateur et celles que vous avez choisies Région AWS. Pour les instructions de configuration, reportez-vous àTéléchargez le AWS CLI.

Pour créer une application à l'aide du AWS CLI

Lorsque vous AWS CLI utilisez la CreateApplicationcommande, personnalisée pour votre contenu.

aws gameliftstreams create-application \ --description "MyGame v1" \ --runtime-environment '{"Type":"PROTON", "Version":"20241007"}' \ --executable-path "launcher.exe" \ --application-source-uri "s3://amzn-s3-demo-bucket/example"

  • description:

    Il s'agit d'une étiquette lisible par l'homme pour votre application. Il n'est pas nécessaire que cette valeur soit unique. Pour les meilleures pratiques, utilisez une description, un nom ou une étiquette significatifs pour l'application. Vous pouvez modifier ce champ à tout moment.

  • runtime-environment:

    Il s'agit de l'environnement d'exécution sur lequel exécuter votre application. Amazon GameLift Streams peut fonctionner sous Windows, Ubuntu 22.04 LTS ou Proton.

    Vous ne pouvez pas modifier ce champ après le processus de création.

    Choisissez l'un des environnements d'exécution suivants .

    • Pour les applications Linux

      • Ubuntu 22.04 LTS () Type=UBUNTU, Version=22_04_LTS

    • Pour les applications Windows

      • Microsoft Windows Server 2022 Base (Type=WINDOWS, Version=2022)

      • Proton 8,0-2c () Type=PROTON, Version=20230704

      • Proton 8,0-5 () Type=PROTON, Version=20241007

  • executable-path:

    Il s'agit de l'URI Amazon S3 vers le fichier exécutable qu'Amazon GameLift Streams diffusera. Le fichier doit se trouver dans le dossier racine de l'application. Entrez le chemin relatif auapplication-source-uri.

    Vous ne pouvez pas modifier ce champ après le processus de création.

  • application-source-uri:

    Il s'agit de l'URI Amazon S3 vers le dossier racine de votre application dans le compartiment Amazon S3. Le dossier doit contenir le fichier exécutable de votre build et tous les fichiers de support.

    Un URI valide est le préfixe du bucket qui contient tous les fichiers nécessaires à l'exécution et au streaming de l'application. Par exemple, un bucket appelé mygamebuild contient trois versions complètes des fichiers de compilation du jeu, chacune dans un dossier distinct. Vous souhaitez diffuser le build dans le dossiermygamebuild-EN101. Dans cet exemple, l'URI ests3://amzn-s3-demo-bucket/mygamebuild-EN101.

    Vous ne pouvez pas modifier ce champ après le processus de création.

Si la demande aboutit, Amazon GameLift Streams renvoie une réponse similaire à la suivante :

{ "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6", "Description": "MyGame v1", "RuntimeEnvironment": { "Type": "PROTON", "Version": "20241007" }, "ExecutablePath": "launcher.exe", "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/example", "Id": "a-9ZY8X7Wv6", "Status": "PROCESSING", "CreatedAt": "2022-11-18T15:47:11.924000-08:00", "LastUpdatedAt": "2022-11-18T15:47:11.924000-08:00" }

Pour vérifier le statut de votre application, appelez la GetApplicationcommande, comme indiqué dans l'exemple suivant.

aws gameliftstreams get-application / --identifier a-9ZY8X7Wv6

Amazon GameLift Streams met quelques minutes à préparer votre candidature. Pendant ce temps, la nouvelle demande est en cours de traitement. Lorsque votre candidature est prête, vous pouvez passer à l'étape suivante,Création d'un groupe de flux.

Si la demande renvoie une erreur, ou si l'application est créée mais qu'elle affiche le statut Erreur, assurez-vous que vous utilisez des informations d'identification utilisateur qui incluent l'accès à Amazon S3 et à Amazon GameLift Streams.

Note

Lorsqu'une application est prête, Amazon GameLift Streams a correctement copié les fichiers de votre application dans son compartiment Amazon S3 privé. Vous pouvez supprimer les fichiers de votre candidature d'origine sans affecter votre nouvelle application. Cela vous permet également d'optimiser les coûts de stockage. Pour de plus amples informations, veuillez consulter Supprimer une application.

Modifier une application

Vous pouvez mettre à jour les paramètres de n'importe quelle application dont l'état est Prêt. Si vous apportez des modifications à une application existante, ces modifications ont un impact sur le comportement de diffusion des nouveaux groupes de flux et des groupes de flux existants.

Console
Pour modifier une application dans la console Amazon GameLift Streams
  1. Dans la barre de navigation, choisissez Applications pour afficher la liste de vos applications existantes. Choisissez l'application que vous souhaitez modifier.

  2. Sur la page des détails de l'application, recherchez la section contenant les paramètres que vous souhaitez modifier et choisissez Modifier ou Gérer les balises en conséquence.

  3. Vous pouvez modifier les paramètres suivants :

    Description

    Il s'agit d'une étiquette lisible par l'homme pour votre application. Il n'est pas nécessaire que cette valeur soit unique. Pour les meilleures pratiques, utilisez une description, un nom ou une étiquette significatifs pour l'application. Vous pouvez modifier ce champ à tout moment.

    Chemin du journal de l'application

    Il s'agit du chemin (ou des chemins) du dossier ou du fichier de l'application contenant les journaux que vous souhaitez enregistrer. Spécifiez chaque chemin de journal par rapport au chemin de base de votre application. Si vous utilisez cette fonctionnalité, à la fin de chaque session de streaming, Amazon GameLift Streams copie le ou les fichiers que vous spécifiez dans le compartiment Amazon S3 que vous nommez. L'opération de copie n'est pas effectuée de manière récursive dans les sous-dossiers d'un dossier d'application.

    Vous pouvez modifier ce champ à tout moment.

    Sortie du journal des applications

    Il s'agit de l'URI du compartiment Amazon S3 dans lequel Amazon GameLift Streams copiera les fichiers journaux de l'application. Ce champ est obligatoire si vous spécifiez le chemin du journal de l'application.

    Vous pouvez modifier ce champ à tout moment.

    Pour enregistrer des fichiers journaux en votre nom, Amazon GameLift Streams doit être autorisé à enregistrer votre compartiment S3. Si vous autorisez Amazon GameLift Streams à créer le compartiment pour la journalisation, la politique d'autorisation sera appliquée automatiquement lors de la création. Si vous fournissez votre propre bucket, vous devrez appliquer vous-même la politique d'autorisation.

    Pour de plus amples informations, veuillez consulter Politique d'autorisation relative au bucket du journal des applications.

    Balises

    Les tags sont des libellés qui peuvent vous aider à organiser vos AWS ressources. Pour plus d'informations, consultez la section Marquage de vos ressources AWS.

    Par exemple, pour suivre les versions des applications, utilisez une balise telle queapplication-version : my-game-1121.

  4. Sélectionnez Enregistrer les modifications. La console Amazon GameLift Streams revient à la page des détails de l'application, affichant les paramètres mis à jour.

CLI

Prérequis

Vous devez le configurer AWS CLI avec vos informations d'identification utilisateur et celles que vous avez choisies Région AWS. Pour les instructions de configuration, reportez-vous àTéléchargez le AWS CLI.

Pour modifier une application à l'aide du AWS CLI

Lorsque vous AWS CLI utilisez la UpdateApplicationcommande, personnalisée pour votre contenu.

aws gameliftstreams update-application \ --identifier a-9ZY8X7Wv6 \ --description "MyGame v2" \ --application-log-paths '[".\\logs"]' \ --application-log-output-uri "s3://amzn-s3-demo-bucket/mygame"

  • identifier: l'application à modifier.

    Cette valeur est un nom de ressource Amazon (ARN) ou un identifiant identifiant de manière unique la ressource de l'application.

    Exemple d'ARN : arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

    Exemple d'identifiant : a-9ZY8X7Wv6

  • description:

    Il s'agit d'une étiquette lisible par l'homme pour votre application. Il n'est pas nécessaire que cette valeur soit unique. Pour les meilleures pratiques, utilisez une description, un nom ou une étiquette significatifs pour l'application. Vous pouvez modifier ce champ à tout moment.

  • application-log-paths:

    Il s'agit du chemin (ou des chemins) du dossier ou du fichier de l'application contenant les journaux que vous souhaitez enregistrer. Spécifiez chaque chemin de journal par rapport au chemin de base de votre application. Si vous utilisez cette fonctionnalité, à la fin de chaque session de streaming, Amazon GameLift Streams copie le ou les fichiers que vous spécifiez dans le compartiment Amazon S3 que vous nommez. L'opération de copie n'est pas effectuée de manière récursive dans les sous-dossiers d'un dossier d'application.

    Vous pouvez modifier ce champ à tout moment.

  • application-log-output-uri:

    Il s'agit de l'URI du compartiment Amazon S3 dans lequel Amazon GameLift Streams copiera les fichiers journaux de l'application. Ce champ est obligatoire si vous spécifiez le chemin du journal de l'application.

    Vous pouvez modifier ce champ à tout moment.

    Pour enregistrer des fichiers journaux en votre nom, Amazon GameLift Streams doit être autorisé à enregistrer votre compartiment S3. Si vous autorisez Amazon GameLift Streams à créer le compartiment pour la journalisation, la politique d'autorisation sera appliquée automatiquement lors de la création. Si vous fournissez votre propre bucket, vous devrez appliquer vous-même la politique d'autorisation.

    Pour de plus amples informations, veuillez consulter Politique d'autorisation relative au bucket du journal des applications.

Supprimer une application

Supprimez une application si vous n'en avez plus besoin. Cette action supprime définitivement l'application, y compris les fichiers de contenu de l'application stockés avec Amazon GameLift Streams. Toutefois, cela ne supprime pas les fichiers d'origine que vous avez chargés dans votre compartiment Amazon S3 ; vous pouvez les supprimer à tout moment après qu'Amazon GameLift Streams ait créé une application, ce qui est le seul moment où Amazon GameLift Streams accède à votre compartiment Amazon S3.

Vous ne pouvez supprimer qu'une application qui répond aux conditions suivantes :

  • L'application est en état Prêt ou en état d'erreur.

  • L'application n'est l'application par défaut d'aucun groupe de flux. Vous devez d'abord supprimer le groupe de flux à l'aide de la console Amazon GameLift Streams ou DeleteStreamGroupde l'API Amazon GameLift Streams.

  • L'application n'est liée à aucun groupe de flux. Vous devez d'abord dissocier le groupe de flux à l'aide de la console Amazon GameLift Streams ou de DisassociateApplicationsl'API Amazon GameLift Streams.

  • Aucune application n'est diffusée pendant une session de diffusion en cours. Vous devez attendre que le client mette fin à la session de diffusion ou appeler TerminateStreamSessionl'API Amazon GameLift Streams pour mettre fin au flux.

Console
Pour supprimer une application à l'aide de la console Amazon GameLift Streams
  1. Connectez-vous à la console Amazon GameLift Streams AWS Management Console et ouvrez-la.

  2. Dans la barre de navigation, choisissez Applications pour afficher la liste de vos applications existantes. Choisissez l'application que vous souhaitez supprimer.

  3. Sur la page détaillée de l'application, choisissez Supprimer.

  4. Dans la boîte de dialogue Supprimer, confirmez l'action de suppression.

CLI

Prérequis

Vous devez le configurer AWS CLI avec vos informations d'identification utilisateur et celles que vous avez choisies Région AWS. Pour les instructions de configuration, reportez-vous àTéléchargez le AWS CLI.

Pour supprimer une application à l'aide du AWS CLI

Lorsque vous AWS CLI utilisez la DeleteApplicationcommande, personnalisée pour votre contenu.

aws gameliftstreams delete-application \ --identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

  • identifier: application à supprimer.

    Cette valeur est un nom de ressource Amazon (ARN) ou un identifiant identifiant de manière unique la ressource de l'application.

    Exemple d'ARN : arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

    Exemple d'identifiant : a-9ZY8X7Wv6

Amazon GameLift Streams commence à supprimer l'application. Pendant ce temps, le Deleting statut de la demande est en cours. Une fois qu'Amazon GameLift Streams a supprimé l'application, vous ne pouvez plus la récupérer.

Politique d'autorisation relative au bucket du journal des applications

Si vous fournissez votre propre compartiment Amazon S3 pour le journal des applications, vous devrez appliquer une politique d'autorisation au compartiment afin qu'Amazon GameLift Streams puisse y enregistrer les fichiers journaux. Utilisez le modèle suivant pour mettre à jour les autorisations dans Amazon S3.

Modèle de politique d'autorisation de compartiment

Copiez le code de politique suivant et appliquez-le au compartiment que vous souhaitez utiliser pour les journaux d'applications. Assurez-vous de remplacer amzn-s3-demo-bucket par le nom de votre compartiment S3 existant.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "PutPolicy", "Effect": "Allow", "Principal": { "Service": [ "gameliftstreams.amazonaws.com" ] }, "Action": "s3:PutObject", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] }

Groupes de flux liés

Si vous souhaitez diffuser plusieurs applications en utilisant le même pool de ressources de calcul, vous pouvez lier plusieurs applications au même groupe de flux. De même, si vous souhaitez diffuser une application en utilisant différents ensembles de ressources de calcul, vous pouvez lier une application à plusieurs groupes de flux.

Pour plus d'informations sur la liaison d'applications à des groupes de flux, reportez-vous àVue d'ensemble des groupes de flux multi-applications.