Esporta file di sessione di streaming - Amazon GameLift Stream
Come funzionaImpatto sui costiEsporta file (Console)File di esportazione (CLI)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esporta file di sessione di streaming

Durante una sessione di streaming, l'applicazione genera file di output che possono aiutarvi a eseguire il debug o a verificare l'applicazione. I file possono essere registri, informazioni diagnostiche, crash dump, file di salvataggio, dati utente, schermate e così via. I file possono essere definiti dal motore o dai framework utilizzati dall'applicazione oppure dalle informazioni per le quali l'applicazione è stata programmata.

avvertimento

Prima di esportare i file, tenete presente quanto segue:

  • I file possono contenere informazioni riservate scritte dall'applicazione, incluse le informazioni sulle credenziali.

  • Le dimensioni dei file possono essere elevate a seconda delle dimensioni dell'applicazione, il che influisce sui costi di storage di Amazon S3.

  • Se selezioni un bucket Amazon S3 in un Regione AWS bucket diverso dalla regione del gruppo di stream, i file di sessione di streaming esportati verranno spostati tra le regioni.

Come funziona

È necessario richiamare manualmente questa operazione su una sessione di streaming attiva per esportare i file generati durante quella sessione. La sessione di streaming deve essere attiva, in particolare in uno dei seguenti statiACTIVE, CONNECTEDPENDING_CLIENT_RECONNECTION, e. RECONNECTING Al termine della sessione, Amazon GameLift Streams esporta i file nel tuo bucket in Amazon Simple Storage Service (Amazon S3). Pertanto, tutti i dati esportati sono di tua proprietà e sono soggetti alla politica di autorizzazione del bucket Amazon S3.

Ecco una guida dettagliata del ciclo di vita della sessione di streaming con i file di esportazione attivati:

  1. Amazon GameLift Streams avvia una sessione collegando l'utente all'applicazione in esecuzione sulla risorsa di elaborazione.

  2. Durante lo streaming, l'applicazione crea o modifica i file nel filesystem dell'ambiente di runtime.

  3. Al termine della sessione, Amazon GameLift Streams ottiene una copia di tutti i file nuovi o modificati nel file system ed esporta i file nel tuo bucket Amazon S3.

Amazon GameLift Streams raccoglie i seguenti file generati e modificati. Trovali nelle cartelle corrispondenti nell'.ziparchivio.

  • application/: La cartella in cui è archiviata l'applicazione o il gioco.

  • profile/: la cartella del profilo dell'utente contiene le impostazioni personali, le configurazioni e i dati dell'utente.

  • temp/: La cartella temporanea del sistema contiene i file e i dati temporanei creati dall'applicazione e dal sistema. Ciò può includere file di cache, file di registro o dati di elaborazione intermedi.

Per eliminare i file, elimina l'oggetto nel bucket Amazon S3.

Impatto sui costi

L'archiviazione dei file in Amazon S3 comporta un costo. Una sessione di streaming potrebbe generare una grande quantità di dati a seconda dell'applicazione. Tieni presente che con molte sessioni di streaming in cui questa funzionalità è abilitata, il costo può aumentare.

Per ulteriori informazioni, consulta i prezzi di Amazon S3.

Esporta file (console)

Per abilitare l'esportazione di file di sessione di streaming nella console Amazon GameLift Streams

  1. Accedi AWS Management Console e apri la console Amazon GameLift Streams.

  2. Nella barra di navigazione, scegli Sessioni per visualizzare un elenco di sessioni di streaming attive e passate negli ultimi 90 giorni.

  3. Nella scheda Sessioni, seleziona una sessione di streaming attiva.

  4. Scegli Esporta file per abilitare la funzionalità di esportazione dei file per quella sessione di streaming.

  5. Nella finestra di dialogo Esporta file di sessioni di streaming, scegli Crea un nuovo bucket S3 o Seleziona un bucket S3 esistente. Segui i passaggi nella console per creare o selezionare un oggetto S3 in cui archiviare i dati esportati.

    avvertimento

    Se il nome del file ZIP corrisponde a uno esistente nella directory, quello precedente verrà sovrascritto.

  6. Scegli Conferma. È ora possibile trovare la sessione elencata nella scheda File esportati.

  7. Attendi la fine della sessione e l'esportazione dei file.

Amazon GameLift Streams esporterà i file quando la sessione è in stato Terminato. Puoi controllare lo stato della sessione nella scheda Sessioni.

Puoi anche controllare lo stato dei file esportati nella scheda Esportazioni di sessioni. Se lo stato è In sospeso, la sessione di streaming è ancora attiva, quindi Amazon GameLift Streams non ha ancora esportato i file. Se lo stato è Riuscito, puoi scaricare i file da Amazon S3. Se lo stato è Non riuscito, passa il mouse sullo stato per visualizzarne il motivo.

File di esportazione (CLI)

Prerequisito

È necessario configurarli AWS CLI con le proprie credenziali utente e quelle scelte. Regione AWS Per le istruzioni di configurazione, fare riferimento a. Scarica il AWS CLI

Per esportare i file delle sessioni di streaming in AWS CLI

Nel tuo AWS CLI caso usa il ExportStreamSessionFilescomando, personalizzato per i tuoi contenuti. 

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

Dove

identifier

Un Amazon Resource Name (ARN) o un ID che identifica in modo univoco la risorsa del gruppo di stream.

Esempio ARN: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4

Esempio di ID: sg-1AB2C3De4

stream-session-identifier

Un Amazon Resource Name (ARN) o un ID che identifica in modo univoco la risorsa della sessione di streaming.

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

Esempio di ID: ABC123def4567

output-uri

L'URI del bucket Amazon S3 in cui Amazon GameLift Streams carica il set di file compressi esportati per questa sessione di streaming.

Puoi fornire due formati validi. Se l'URI ha un'estensione di .ZIP file .zip or, Amazon GameLift Streams memorizza i file esportati nell'URI fornito. Altrimenti, Amazon GameLift Streams genera il nome per una cartella compressa e lo archivia nell'URI. Il nome generato segue lo schema:. date-time-applicationId-streamGroupId-streamSessionId Per esempio:

  • Se fornisci un URI chiamatos3://amzn-s3-demo-bucket/MyGame_Session1.zip, Amazon GameLift Streams salva i file in quella cartella ZIP esatta.

  • Se fornisci un URI chiamatos3://amzn-s3-demo-bucket/MyGame_Session1/, Amazon GameLift Streams salverà i file ins3://amzn-s3-demo-bucket/MyGame_Session1/YYYYMMDD-HHMMSS-applicationId-streamGroupId-sessionId.zip.

Assicurati che il nome del tuo file ZIP sia conforme alle linee guida per la denominazione delle chiavi Object contenute nella Amazon Simple Storage Service User Guide.

avvertimento

Se il nome del file ZIP corrisponde a un nome esistente nella directory, quello precedente verrà sovrascritto.

Puoi controllare lo stato della sessione attiva richiamando l'GetStreamSessionAPI. Dal riepilogo della sessione di streaming, puoi ottenere dettagli sullo stato dei file esportati. Se lo stato è In sospeso, la sessione di streaming è ancora attiva, quindi Amazon GameLift Streams non ha ancora esportato i file. Se lo stato è Riuscito, accedi all'URI di output per visualizzare i file in Amazon S3. Se lo stato è Fallito, controlla StatusReason in. ExportFilesMetaData