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à.
Preparare un'applicazione in Amazon GameLift Streams
Per configurare lo streaming con Amazon GameLift Streams, devi prima caricare il gioco o l'altra applicazione che desideri trasmettere in streaming, quindi configuri una risorsa applicativa all'interno di Amazon GameLift Streams per definire i metadati relativi al gioco. Un'applicazione Amazon GameLift Streams è composta dai file caricati (file eseguibili e qualsiasi file di supporto) e da una configurazione che indica ad Amazon GameLift Streams quale eseguibile eseguire durante lo streaming.
Ogni applicazione Amazon GameLift Streams rappresenta una singola versione dei tuoi contenuti. Se disponi di più versioni, devi creare un'applicazione separata per ogni versione. Dopo aver creato un'applicazione, non è possibile aggiornare i file. Se devi aggiornare l'eseguibile o qualsiasi file di supporto, devi creare una nuova applicazione Amazon GameLift Streams.
Prima del caricamento
Prima di creare un'applicazione Amazon GameLift Streams, verifica che il gioco rispetti le seguenti limitazioni.
Nome |
Predefinita |
Adattabile |
Descrizione |
File per applicazione |
30.000 file |
Sì* |
Il numero massimo di file che puoi avere in un'applicazione, in questo account. |
Dimensione di un singolo file |
80 GiB |
No |
La dimensione massima di un singolo file in un'applicazione. Nota che un gibibyte (GiB) è uguale a 1024*1024*1024 byte. |
Dimensioni dell'applicazione |
100 GiB |
Sì* |
La dimensione totale massima di un'applicazione Amazon GameLift Streams, in questo account. Nota che un gibibyte (GiB) è uguale a 1024*1024*1024 byte. |
*Per richiedere un aumento, accedi AWS Management Console e apri la console Service Quotas su GameLift Amazon Streams, dove puoi rivedere le tue quote attuali nella colonna Valore della quota applicata a livello di account e inviare una richiesta per aumentare un valore.
Per risparmiare tempo e fatica, verifica che i file che sei pronto a caricare siano la versione corretta dell'applicazione. Sebbene sia possibile caricare nuove versioni in un secondo momento, è necessario ripetere il Creazione di un'applicazione passaggio per ogni versione.
Carica la tua applicazione in un bucket Amazon S3
Ora che hai preparato il gioco per Amazon GameLift Streams, è il momento di caricarlo in un bucket Amazon Simple Storage Service (Amazon S3) del tuo account. AWS
La classe di storage Amazon S3 richiesta da Amazon GameLift Streams è lo standard S3 predefinito. Altre classi di storage come S3 Glacier o oggetti spostati in Infrequent Access o Archive Access di S3 Intelligent-Tiering non sono supportate da Amazon Streams. GameLift
Per ottimizzare i costi di storage, puoi eliminare l'applicazione dal tuo bucket S3 dopo averla completata e aver raggiunto lo stato Ready. Creazione di un'applicazione
Per caricare la tua applicazione su Amazon S3
Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/
Creare un bucket Amazon S3. Inserisci il nome del bucket e seleziona un. Regione AWS Questa regione deve essere la stessa dell'applicazione e del gruppo di stream che creerai in seguito. Consulta Regioni AWS e postazioni remote supportate da Amazon GameLift Streams l'elenco dei paesi Regioni AWS in cui è disponibile Amazon GameLift Streams. Per i campi rimanenti, mantieni le impostazioni predefinite.
Per ulteriori istruzioni, consulta la sezione Creazione di un bucket nella Guida per l'utente di Amazon Simple Storage Service.
Apri il nuovo bucket e carica la cartella con i file dell'applicazione.
È necessario caricare i file dell'applicazione come cartella non compressa. Non caricare una .zip
cartella.
Creazione di un'applicazione
Un'applicazione Amazon GameLift Streams è una risorsa che contiene il gioco o altro software che desideri trasmettere in streaming e le impostazioni per eseguirlo. Quando crei un'applicazione, fornisci il percorso dei file dell'applicazione che hai caricato nel tuo bucket Amazon S3.
Amazon GameLift Streams non sincronizza automaticamente i file di gioco dal bucket Amazon S3 che hai creato. Se desideri aggiornare i file di gioco, devi creare una nuova applicazione Amazon GameLift Streams.
- Console
-
Per creare un'applicazione Amazon GameLift Streams utilizzando la console Amazon GameLift Streams
-
Accedi AWS Management Console e apri la console Amazon GameLift Streams. Scegli lo Regione AWS stesso del bucket Amazon S3 in cui hai caricato il set di file. Per ulteriori informazioni, consulta Scelta di una regione nella AWS Management Console Guida introduttiva.
-
Nella barra di navigazione, scegli Applicazioni, quindi scegli Crea applicazione.
-
Nelle impostazioni di runtime, inserisci quanto segue:
-
Ambiente di runtime
Questo è l'ambiente di runtime su cui eseguire l'applicazione. Amazon GameLift Streams può essere eseguito su Windows, Ubuntu 22.04 LTS o Proton.
Non puoi modificare questo campo dopo il flusso di lavoro di creazione.
Scegliete uno dei seguenti ambienti di runtime .
Consultate le descrizioni e utilizzate la checklist di confronto per aiutarvi a selezionare l'ambiente di runtime ottimale per la vostra applicazione.
-
In Impostazioni generali, inserisci quanto segue:
-
Descrizione
Questa è un'etichetta leggibile dall'uomo per la tua applicazione. Questo valore non deve essere univoco. Come procedura ottimale, utilizzate una descrizione, un nome o un'etichetta significativi per l'applicazione. Puoi modificare questo campo in qualsiasi momento.
-
Percorso base
Si tratta dell'URI Amazon S3 della cartella principale dell'applicazione nel bucket Amazon S3. La cartella deve contenere il file eseguibile della build e tutti i file di supporto.
Un URI valido è il prefisso del bucket che contiene tutti i file necessari per eseguire e trasmettere l'applicazione. Ad esempio, un bucket chiamato mygamebuild
contiene tre versioni complete dei file di build del gioco, ciascuna in una cartella separata. Vuoi trasmettere in streaming la build nella cartellamygamebuild-EN101
. In questo esempio, l'URI ès3://amzn-s3-demo-bucket/mygamebuild-EN101
.
Non è possibile modificare questo campo dopo il flusso di lavoro di creazione.
-
Percorso di avvio eseguibile
Si tratta dell'URI Amazon S3 del file eseguibile che Amazon GameLift Streams trasmetterà in streaming. Il file deve essere contenuto nella cartella principale dell'applicazione.
Non è possibile modificare questo campo dopo il flusso di lavoro di creazione.
-
(Facoltativo) Nel percorso del registro dell'applicazione, immettete quanto segue:
-
Percorso del registro dell'applicazione
Questo è il percorso (o i percorsi) della cartella o del file dell'applicazione che contiene i log che si desidera salvare. Specificate ogni percorso di registro relativo al percorso di base dell'applicazione. Se utilizzi questa funzionalità, alla fine di ogni sessione di streaming, Amazon GameLift Streams copierà i file specificati nel bucket Amazon S3 da te indicato. L'operazione di copia non viene eseguita in modo ricorsivo nelle sottocartelle di una cartella dell'applicazione.
È possibile modificare questo campo in qualsiasi momento.
-
Output del registro dell'applicazione
Si tratta dell'URI del bucket Amazon S3 in cui Amazon GameLift Streams copierà i file di registro delle applicazioni. Questo campo è obbligatorio se si specifica un percorso di log dell'applicazione.
È possibile modificare questo campo in qualsiasi momento.
Per salvare i file di registro per tuo conto, Amazon GameLift Streams deve avere l'autorizzazione al salvataggio del tuo bucket S3. Se GameLift consenti ad Amazon Streams di creare il bucket per la registrazione, la politica di autorizzazione verrà applicata automaticamente al momento della creazione. Se fornisci il tuo bucket, dovrai applicare tu stesso la politica di autorizzazione.
Modello di policy di autorizzazione Bucket
Copia il seguente codice di policy e applicalo al bucket che desideri utilizzare per i log delle applicazioni. Assicurati di sostituire amzn-s3-demo-bucket con il nome del bucket S3 esistente.
{
"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
/*"
}
]
}
-
(Facoltativo) In Tag, assegna i tag a questa applicazione.
I tag sono etichette che possono aiutarti a organizzare AWS le tue risorse. Per ulteriori informazioni, consulta Tagging your AWS resources.
Ad esempio, per tenere traccia delle versioni delle applicazioni, utilizza un tag comeapplication-version : my-game-1121
.
-
Scegli Crea applicazione.
- 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 creare un'applicazione utilizzando il AWS CLI
Nel tuo AWS CLI caso usa il CreateApplicationcomando, personalizzato per i tuoi contenuti.
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
"
dove
-
description
:
Questa è un'etichetta leggibile dall'uomo per la tua applicazione. Questo valore non deve essere univoco. Come procedura ottimale, utilizzate una descrizione, un nome o un'etichetta significativi per l'applicazione. Puoi modificare questo campo in qualsiasi momento.
-
runtime-environment
:
Questo è l'ambiente di runtime su cui eseguire l'applicazione. Amazon GameLift Streams può essere eseguito su Windows, Ubuntu 22.04 LTS o Proton.
Non puoi modificare questo campo dopo il flusso di lavoro di creazione.
Scegliete uno dei seguenti ambienti di runtime .
-
Per applicazioni Linux
-
Per applicazioni 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
:
Si tratta dell'URI Amazon S3 del file eseguibile che Amazon GameLift Streams trasmetterà in streaming. Il file deve essere contenuto nella cartella principale dell'applicazione. Immettete il percorso relativo aapplication-source-uri
.
Non è possibile modificare questo campo dopo il flusso di lavoro di creazione.
-
application-source-uri
:
Si tratta dell'URI Amazon S3 della cartella principale dell'applicazione nel bucket Amazon S3. La cartella deve contenere il file eseguibile della build e tutti i file di supporto.
Un URI valido è il prefisso del bucket che contiene tutti i file necessari per eseguire e trasmettere l'applicazione. Ad esempio, un bucket chiamato mygamebuild
contiene tre versioni complete dei file di build del gioco, ciascuna in una cartella separata. Vuoi trasmettere in streaming la build nella cartellamygamebuild-EN101
. In questo esempio, l'URI ès3://amzn-s3-demo-bucket/mygamebuild-EN101
.
Non è possibile modificare questo campo dopo il flusso di lavoro di creazione.
Se la richiesta ha esito positivo, Amazon GameLift Streams restituisce una risposta simile alla seguente:
{
"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"
}
Per verificare lo stato della tua applicazione, chiama il GetApplicationcomando, come mostrato nell'esempio seguente.
aws gameliftstreams get-application /
--identifier a-9ZY8X7Wv6
Amazon GameLift Streams impiega alcuni minuti per preparare l'applicazione. Durante questo periodo, la nuova applicazione è in stato di Elaborazione. Quando la tua domanda è in stato Pronto, puoi andare al passaggio successivo,Crea un gruppo di stream.
Se la richiesta restituisce un errore o se l'applicazione viene creata ma ha lo stato Errore, assicurati di utilizzare credenziali utente che includono l'accesso sia ad Amazon S3 che ad Amazon Streams. GameLift
Quando un'applicazione è in stato Pronto, Amazon GameLift Streams ha copiato con successo i file dell'applicazione nel suo bucket Amazon S3 privato. Puoi eliminare i file dell'applicazione originale senza influire sulla nuova applicazione. Ciò consente inoltre di ottimizzare i costi di archiviazione. Per ulteriori informazioni, consulta Eliminazione di un'applicazione.
Modificare un'applicazione
È possibile aggiornare le impostazioni per qualsiasi applicazione con lo stato Pronto. Se apporti modifiche a un'applicazione esistente, tali modifiche influiscono sul comportamento di streaming sia per i gruppi di stream nuovi che per quelli esistenti.
- Console
-
Per modificare un'applicazione nella console Amazon GameLift Streams
-
Nella barra di navigazione, scegli Applicazioni per visualizzare un elenco delle applicazioni esistenti. Scegli l'applicazione che desideri modificare.
-
Nella pagina dei dettagli dell'applicazione, individua la sezione che contiene le impostazioni che desideri modificare e scegli Modifica o Gestisci tag di conseguenza.
-
È possibile modificare le impostazioni seguenti:
- Descrizione
-
Questa è un'etichetta leggibile dall'uomo per la tua applicazione. Questo valore non deve essere univoco. Come procedura ottimale, utilizzate una descrizione, un nome o un'etichetta significativi per l'applicazione. Puoi modificare questo campo in qualsiasi momento.
- Percorso del registro dell'applicazione
-
Questo è il percorso (o i percorsi) della cartella o del file dell'applicazione che contiene i log che si desidera salvare. Specificate ogni percorso di registro relativo al percorso di base dell'applicazione. Se utilizzi questa funzionalità, alla fine di ogni sessione di streaming, Amazon GameLift Streams copierà i file specificati nel bucket Amazon S3 da te indicato. L'operazione di copia non viene eseguita in modo ricorsivo nelle sottocartelle di una cartella dell'applicazione.
È possibile modificare questo campo in qualsiasi momento.
- Output del registro dell'applicazione
-
Si tratta dell'URI del bucket Amazon S3 in cui Amazon GameLift Streams copierà i file di registro delle applicazioni. Questo campo è obbligatorio se si specifica un percorso di log dell'applicazione.
È possibile modificare questo campo in qualsiasi momento.
Per salvare i file di registro per tuo conto, Amazon GameLift Streams deve avere l'autorizzazione al salvataggio del tuo bucket S3. Se GameLift consenti ad Amazon Streams di creare il bucket per la registrazione, la politica di autorizzazione verrà applicata automaticamente al momento della creazione. Se fornisci il tuo bucket, dovrai applicare tu stesso la politica di autorizzazione.
Per ulteriori informazioni, consulta Politica di autorizzazione del bucket di log dell'applicazione.
- Tag
-
I tag sono etichette che possono aiutarti a organizzare AWS le tue risorse. Per ulteriori informazioni, consulta Tagging your AWS resources.
Ad esempio, per tenere traccia delle versioni delle applicazioni, utilizza un tag comeapplication-version : my-game-1121
.
-
Scegli Save changes (Salva modifiche). La console Amazon GameLift Streams torna alla pagina dei dettagli dell'applicazione, visualizzando le impostazioni aggiornate.
- CLI
-
Prerequisito
Devi configurarlo AWS CLI con le tue credenziali utente e quelle scelte. Regione AWS Per le istruzioni di configurazione, fare riferimento a. Scarica il AWS CLI
Per modificare un'applicazione utilizzando il AWS CLI
Nel tuo AWS CLI caso usa il UpdateApplicationcomando, personalizzato per i tuoi contenuti.
aws gameliftstreams update-application \
--identifier a-9ZY8X7Wv6
\
--description "MyGame v2
" \
--application-log-paths '[".\\logs
"]' \
--application-log-output-uri "s3://amzn-s3-demo-bucket/mygame
"
dove
-
identifier
: L'applicazione da modificare.
Questo valore è un Amazon Resource Name (ARN) o ID che identifica in modo univoco la risorsa dell'applicazione.
Esempio ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
Esempio di ID: a-9ZY8X7Wv6
-
description
:
Questa è un'etichetta leggibile dall'uomo per la tua applicazione. Questo valore non deve essere univoco. Come procedura ottimale, utilizzate una descrizione, un nome o un'etichetta significativi per l'applicazione. Puoi modificare questo campo in qualsiasi momento.
-
application-log-paths
:
Questo è il percorso (o i percorsi) della cartella o del file dell'applicazione che contiene i registri che si desidera salvare. Specificate ogni percorso di registro relativo al percorso di base dell'applicazione. Se utilizzi questa funzionalità, alla fine di ogni sessione di streaming, Amazon GameLift Streams copierà i file specificati nel bucket Amazon S3 da te indicato. L'operazione di copia non viene eseguita in modo ricorsivo nelle sottocartelle di una cartella dell'applicazione.
È possibile modificare questo campo in qualsiasi momento.
-
application-log-output-uri
:
Si tratta dell'URI del bucket Amazon S3 in cui Amazon GameLift Streams copierà i file di registro delle applicazioni. Questo campo è obbligatorio se si specifica un percorso di log dell'applicazione.
È possibile modificare questo campo in qualsiasi momento.
Per salvare i file di registro per tuo conto, Amazon GameLift Streams deve avere l'autorizzazione al salvataggio del tuo bucket S3. Se GameLift consenti ad Amazon Streams di creare il bucket per la registrazione, la politica di autorizzazione verrà applicata automaticamente al momento della creazione. Se fornisci il tuo bucket, dovrai applicare tu stesso la politica di autorizzazione.
Per ulteriori informazioni, consulta Politica di autorizzazione del bucket di log dell'applicazione.
Eliminazione di un'applicazione
Elimina un'applicazione se non ti serve più. Questa azione elimina definitivamente l'applicazione, inclusi i file di contenuto dell'applicazione archiviati con Amazon GameLift Streams. Tuttavia, ciò non elimina i file originali che hai caricato nel tuo bucket Amazon S3; puoi eliminarli in qualsiasi momento dopo che Amazon Streams ha creato un'applicazione, che è l'unica volta in cui Amazon GameLift Streams GameLift accede al tuo bucket Amazon S3.
Puoi eliminare solo un'applicazione che soddisfa le seguenti condizioni:
-
L'applicazione è nello stato Pronto o Errore.
-
L'applicazione non è l'applicazione predefinita di nessun gruppo di stream. Devi prima eliminare il gruppo di stream utilizzando la console Amazon GameLift Streams o utilizzando l'DeleteStreamGroupAPI Amazon GameLift Streams.
-
L'applicazione non è collegata a nessun gruppo di stream. Devi prima scollegare il gruppo di stream utilizzando la console Amazon GameLift Streams o utilizzando l'API DisassociateApplicationsAmazon GameLift Streams.
-
Un'applicazione non è in streaming in nessuna sessione di streaming in corso. Devi attendere che il client termini la sessione di streaming o chiamare TerminateStreamSessionl'API Amazon GameLift Streams per terminare lo streaming.
- Console
-
Per eliminare un'applicazione utilizzando la console Amazon GameLift Streams
-
Accedi AWS Management Console e apri la console Amazon GameLift Streams.
-
Nella barra di navigazione, scegli Applicazioni per visualizzare un elenco delle applicazioni esistenti. Scegli l'applicazione che desideri eliminare.
-
Nella pagina dei dettagli dell'applicazione, scegli Elimina.
-
Nella finestra di dialogo Elimina, confermate l'azione di eliminazione.
- 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 eliminare un'applicazione utilizzando il AWS CLI
Nel tuo AWS CLI caso usa il DeleteApplicationcomando, personalizzato per i tuoi contenuti.
aws gameliftstreams delete-application \
--identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
dove
-
identifier
: L'applicazione da eliminare.
Questo valore è un Amazon Resource Name (ARN) o ID che identifica in modo univoco la risorsa dell'applicazione.
Esempio ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
Esempio di ID: a-9ZY8X7Wv6
Amazon GameLift Streams inizia a eliminare l'applicazione. Durante questo periodo, l'applicazione è in Deleting
stato. Dopo che Amazon GameLift Streams ha eliminato l'applicazione, non puoi più recuperarla.
Politica di autorizzazione del bucket di log dell'applicazione
Se fornisci il tuo bucket Amazon S3 per il log delle applicazioni, dovrai applicare una politica di autorizzazione al bucket in modo che Amazon GameLift Streams possa salvare i file di log nel bucket. Utilizza il seguente modello per aggiornare le autorizzazioni in Amazon S3.
Modello di policy di autorizzazione Bucket
Copia il seguente codice di policy e applicalo al bucket che desideri utilizzare per i log delle applicazioni. Assicurati di sostituire amzn-s3-demo-bucket con il nome del bucket S3 esistente.
{
"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
/*"
}
]
}
Gruppi di stream collegati
Se desideri eseguire lo streaming di più applicazioni utilizzando lo stesso pool di risorse di calcolo, puoi collegare più applicazioni allo stesso gruppo di flussi. Allo stesso modo, se desideri eseguire lo streaming di un'applicazione utilizzando diversi set di risorse di calcolo, puoi collegare un'applicazione a più gruppi di stream.
Per ulteriori informazioni sul collegamento delle applicazioni ai gruppi di stream, consulta. Panoramica dei gruppi di stream multiapplicazione