Exporter les fichiers de session de streaming - Amazon GameLift Streams
Comment ça marcheImpact sur les coûtsExporter des fichiers (console)Exporter des fichiers (CLI)

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.

Exporter les fichiers de session de streaming

Au cours d'une session de streaming, votre application génère des fichiers de sortie qui peuvent vous aider à déboguer ou à vérifier votre application. Les fichiers peuvent être des journaux, des informations de diagnostic, des crash dumps, des fichiers de sauvegarde, des données utilisateur, des captures d'écran, etc. Les fichiers peuvent être définis par le moteur ou les frameworks utilisés par votre application, ou par les informations que vous avez programmées pour générer.

Avertissement

Avant d'exporter des fichiers, tenez compte des points suivants :

  • Les fichiers peuvent contenir des informations sensibles rédigées par votre application, notamment des informations d'identification.

  • La taille des fichiers peut être importante en fonction de la taille de votre application, ce qui a un impact sur vos coûts de stockage Amazon S3.

  • Si vous sélectionnez un compartiment Amazon S3 dans un Région AWS compartiment différent de la région du groupe de flux, les fichiers de session de flux exportés seront déplacés d'une région à l'autre.

Fonctionnement

Vous devez appeler manuellement cette opération sur une session de streaming active pour exporter les fichiers générés au cours de cette session. La session de diffusion doit être active, en particulier dans l'un des statuts suivantsACTIVE, CONNECTEDPENDING_CLIENT_RECONNECTION, etRECONNECTING. À la fin de la session, Amazon GameLift Streams exporte les fichiers vers votre compartiment dans Amazon Simple Storage Service (Amazon S3). Ainsi, toutes les données exportées vous appartiennent et sont soumises à la politique d'autorisation du compartiment Amazon S3.

Voici un aperçu du cycle de vie des sessions de streaming lorsque les fichiers d'exportation sont activés :

  1. Amazon GameLift Streams démarre une session en connectant l'utilisateur à votre application qui s'exécute sur la ressource de calcul.

  2. Lorsque votre application diffuse, elle crée ou modifie des fichiers dans le système de fichiers de l'environnement d'exécution.

  3. À la fin de la session, Amazon GameLift Streams obtient une copie de tous les fichiers nouveaux ou modifiés du système de fichiers et exporte les fichiers vers votre compartiment Amazon S3.

Amazon GameLift Streams collecte les fichiers générés et modifiés suivants. Trouvez-les dans les dossiers correspondants de l'.ziparchive.

  • application/: dossier dans lequel votre application ou votre jeu est stocké.

  • profile/: le dossier de profil de l'utilisateur contient les paramètres personnels, les configurations et les données de l'utilisateur.

  • temp/: Le dossier temporaire du système contient les fichiers temporaires et les données créés par votre application et le système. Cela peut inclure des fichiers de cache, des fichiers journaux ou des données de traitement intermédiaires.

Pour supprimer les fichiers, supprimez l'objet dans le compartiment Amazon S3.

Impact sur les coûts

Le stockage des fichiers dans Amazon S3 entraîne des frais. Une session de streaming peut générer une grande quantité de données en fonction de votre application. Sachez qu'avec de nombreuses sessions de streaming où cette fonctionnalité est activée, le coût peut s'accumuler.

Pour plus d'informations, consultez la tarification d'Amazon S3.

Exporter des fichiers (console)

Pour activer l'exportation de fichiers de session de streaming dans 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 Sessions pour afficher la liste des sessions de streaming actives et passées au cours des 90 derniers jours.

  3. Dans l'onglet Sessions, sélectionnez une session de diffusion active.

  4. Choisissez Exporter des fichiers pour activer la fonctionnalité d'exportation de fichiers pour cette session de diffusion.

  5. Dans la boîte de dialogue Exporter un fichier de sessions de streaming, choisissez Créer un nouveau compartiment S3 ou Sélectionner un compartiment S3 existant. Suivez les étapes de la console pour créer ou sélectionner un objet S3 dans lequel stocker les données exportées.

    Avertissement

    Si le nom du fichier ZIP correspond à un nom existant dans le répertoire, le nom précédent sera remplacé.

  6. Choisissez Confirmer. Vous pouvez désormais trouver la session répertoriée dans l'onglet Fichiers exportés.

  7. Attendez que la session soit terminée et que les fichiers soient exportés.

Amazon GameLift Streams exportera les fichiers lorsque la session sera terminée. Vous pouvez vérifier l'état de la session dans l'onglet Sessions.

Vous pouvez également vérifier l'état des fichiers exportés dans l'onglet Exportations de session. Si le statut est En attente, la session de diffusion est toujours active. Amazon GameLift Streams n'a donc pas encore exporté les fichiers. Si le statut est Réussi, vous pouvez télécharger les fichiers depuis Amazon S3. Si le statut est Échoué, passez le curseur sur le statut pour voir la raison du statut.

Exporter des fichiers (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 exporter des fichiers de session de streaming dans AWS CLI

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

aws gameliftstreams export-stream-session-files \ 
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --stream-session-identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567
    --ouput-uri s3://amzn-s3-demo-bucket/prefix

Où

identifier

Un nom de ressource Amazon (ARN) ou un identifiant identifiant de manière unique la ressource du groupe de flux.

Exemple d'ARN : arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4

Exemple d'identifiant : sg-1AB2C3De4

stream-session-identifier

Un nom de ressource Amazon (ARN) ou un identifiant identifiant de manière unique la ressource de session de streaming.

Exemple d'ARN : arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567

Exemple d'identifiant : ABC123def4567

output-uri

L'URI du compartiment Amazon S3 dans lequel Amazon GameLift Streams télécharge l'ensemble des fichiers exportés compressés pour cette session de streaming.

Il existe deux formats valides que vous pouvez fournir. Si l'URI possède une extension de .ZIP fichier .zip ou, Amazon GameLift Streams stocke les fichiers exportés dans l'URI fourni. Sinon, Amazon GameLift Streams génère le nom d'un dossier compressé et le stocke dans l'URI. Le nom généré suit le modèle :date-time-applicationId-streamGroupId-streamSessionId. Par exemple :

  • Si vous fournissez un URI appelés3://amzn-s3-demo-bucket/MyGame_Session1.zip, Amazon GameLift Streams enregistre les fichiers exactement dans ce dossier ZIP.

  • Si vous fournissez un URI appelés3://amzn-s3-demo-bucket/MyGame_Session1/, Amazon GameLift Streams enregistrera les fichiers à l'adresses3://amzn-s3-demo-bucket/MyGame_Session1/YYYYMMDD-HHMMSS-applicationId-streamGroupId-sessionId.zip.

Assurez-vous que le nom de votre fichier ZIP est conforme aux directives de dénomination des clés d'objet du guide de l'utilisateur d'Amazon Simple Storage Service.

Avertissement

Si le nom du fichier ZIP correspond à un nom existant dans le répertoire, le nom précédent sera remplacé.

Vous pouvez vérifier l'état de la session active en appelant l'GetStreamSessionAPI. À partir du résumé de la session de streaming, vous pouvez obtenir des informations sur l'état des fichiers exportés. Si le statut est En attente, cela signifie que la session de diffusion est toujours active. Amazon GameLift Streams n'a donc pas encore exporté les fichiers. Si le statut est Réussi, accédez à l'URI de sortie pour voir les fichiers dans Amazon S3. Si le statut est Échoué, StatusReason cochez leExportFilesMetaData.