Come funzionano gli URL di streaming L'esperienza dell'utente finale Prerequisiti Creazione di un URL di streaming Monitoraggio degli URL dello streaming Revoca dell'URL di uno stream Ciclo di vita e stato degli URL dello streaming Differenze rispetto alle sessioni con cui inizi StartStreamSession Risoluzione dei problemi

Condividi le sessioni di streaming con gli URL di streaming

Gli URL di streaming ti consentono di condividere rapidamente le tue sessioni di streaming con chiunque. I destinatari accedono alle tue sessioni di streaming in un browser web supportato, senza che Account AWS sia richiesta l'integrazione con il client, e tu controlli la scadenza, l'utilizzo e la revoca. Dopo aver creato un URL di streaming, chiunque vi acceda avvia la propria sessione di streaming senza bisogno di credenziali. Gli URL di streaming sono ideali per configurare in modo rapido e semplice demo, playtest, recensioni degli stakeholder e accesso da parte degli ospiti.

Importante

Chiunque disponga dell'URL completo può avviare una sessione di streaming fino alla scadenza dell'URL dello streaming, al raggiungimento del limite di utilizzo o alla revoca. Considera l'URL dello streaming come una credenziale: condividilo solo attraverso canali affidabili, preferisci il limite di scadenza e utilizzo più breve possibile e revocalo immediatamente in caso di fuga di notizie.

Come funzionano gli URL di streaming

Un URL di streaming collega un gruppo di stream (la capacità che esegue lo stream) e un'applicazione in quel gruppo di stream (il contenuto da eseguire). Quando crei un URL di streaming, Amazon GameLift Streams restituisce un URL di streaming nel seguente formato:


https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN

Il flusso di lavoro è suddiviso in quattro fasi:

Crea. Chiamate un gruppo di stream e un'applicazione, impostando CreateStreamUrl per quanto tempo l'URL dello stream rimane valido (UrlExpiresAfterMinutes) e quante volte può essere utilizzato (UsageLimit). La configurazione della sessione di streaming (argomenti di avvio, variabili di ambiente, durata della sessione, risoluzione dello schermo e così via) viene bloccata nell'URL dello stream al momento della creazione.
Condividi. Distribuisci l'URL dello streaming tramite i tuoi canali, come email, chat o una pagina dell'evento.
Attiva. Ogni volta che un utente apre l'URL dello streaming e avvia lo streaming, Amazon GameLift Streams consuma un utilizzo dell'URL dello streaming e avvia una nuova sessione di streaming utilizzando la configurazione bloccata. Ogni attivazione è una sessione indipendente; non esiste uno stato condiviso tra le persone che utilizzano lo stesso URL di streaming.
Fine. Le sessioni avviate da un URL di streaming sono di breve durata e non supportano la riconnessione. Quando una sessione termina, il suo utilizzo è già stato conteggiato; la riapertura dell'URL dello stream avvia una nuova sessione e ne consuma un altro utilizzo.

Poiché l'URL dello streaming non è autenticato, l'utente finale non vede né ha bisogno delle tue credenziali. AWS Il servizio indirizza ogni utente finale verso una posizione vicina in base alla preferenza sulla posizione di streaming impostata al momento della creazione. Amazon GameLift Streams riordina le tue località di streaming preferite in base alla prossimità, ma non aggiunge mai località che non hai incluso.

L'esperienza dell'utente finale

Gli utenti con cui condividi un URL di streaming non necessitano dell'installazione Account AWS di alcun software. Aprono l'URL in un browser Web supportato e trasmettono in streaming da una pagina Web ospitata da Amazon GameLift Streams per te. Lo streaming utilizza WebRTC e ha gli stessi requisiti di browser e dispositivo del client Amazon GameLift Streams Web SDK. Per i browser supportati e le versioni minime, consulta. Dispositivi e GameLift browser compatibili con Amazon Streams Se il gruppo di stream non ha capacità disponibile quando un utente finale apre l'URL, nella pagina viene visualizzato un messaggio indicante che lo stream è temporaneamente esaurito e l'utente finale può riprovare. Se l'utente finale tenta di chiudere o ricaricare la scheda, la pagina richiede di confermare, poiché l'abbandono della pagina termina la sessione.

Nota

Le sessioni avviate da un URL di streaming sono ottimizzate per una riproduzione breve con un solo visualizzatore. Se l'utente finale perde la connessione o ricarica la pagina, la sessione termina e la riapertura dell'URL dello stream avvia una nuova sessione che consuma un altro utilizzo. Per informazioni, consulta Differenze rispetto alle sessioni con cui inizi StartStreamSession.

Prerequisiti

Prima di creare un URL di streaming, è necessario quanto segue:

Un gruppo di stream attivo e in grado di eseguire sessioni.
Un'applicazione collegata a quel gruppo di stream.
Autorizzazione IAM per le azioni relative agli URL dello stream. La creazione di un URL di streaming richiede anche l'gameliftstreams:StartStreamSessionautorizzazione per l'applicazione a cui punta, poiché l'attivazione dell'URL dello stream avvia una sessione di streaming che esegue quell'applicazione. Vedi l'esempio Crea e gestisci gli URL degli stream di policy.
Se trasferisci un ruolo IAM inRoleArn, hai bisogno anche iam:PassRole dell'autorizzazione per quel ruolo.

Creazione di un URL di streaming

Nota

Puoi creare un URL di streaming nella console Amazon GameLift Streams, con o con l'API. AWS CLI I seguenti esempi utilizzano il. AWS CLI

L' AWS CLI esempio seguente crea un URL di streaming per un'applicazione in un gruppo di stream. L'URL dello stream è valido per due ore e può essere utilizzato fino a cinque volte e preferisce le us-east-1 posizioni us-west-2 e.


aws gameliftstreams create-stream-url \
    --identifier sg-1AB2C3De4 \
    --application-identifier a-9ZY8X7Wv6 \
    --protocol WebRTC \
    --url-expires-after-minutes 120 \
    --usage-limit 5 \
    --locations us-west-2 us-east-1 \
    --description "Preview build - reviewer invites"

Una chiamata riuscita restituisce la risorsa URL dello stream, inclusi StreamUrlId (con prefissosu-), l'ARN, l'intero valore condivisibileStreamUrl, l'ora di scadenza calcolata e gli usi iniziali rimanenti.


{
    "StreamUrlId": "su-1AB2C3De4",
    "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamurl/sg-1AB2C3De4/su-1AB2C3De4",
    "StreamUrl": "https://gameliftstreams.aws.com/su-1AB2C3De4/stream?token=EXAMPLETOKEN",
    "Status": "ACTIVE",
    "UsageLimit": 5,
    "RemainingUses": 5,
    "ExpiresAt": "2026-07-31T20:00:00+00:00"
}

I parametri seguenti sono obbligatori:

Parametro	Description
`Identifier`(gruppo di stream)	Il gruppo di stream la cui capacità gestisce le sessioni. Fornisci l'ID o l'ARN del gruppo di streaming.
`ApplicationIdentifier`	L'applicazione in quel gruppo di stream per lo streaming. Fornisci l'ID o l'ARN dell'applicazione.
`Protocol`	Il protocollo di streaming. `WebRTC`è l'unico valore supportato.
`UrlExpiresAfterMinutes`	Per quanto tempo l'URL dello stream rimane valido, in minuti, dalla creazione. Minimo 1; massimo 1.440 (24 ore). Dopo questa finestra l'URL dello stream diventa`EXPIRED`.
`Locations`	Le tue località preferite, ad esempio Regione AWS codici`us-west-2`, in ordine di priorità. Amazon GameLift Streams le riordina in base alla prossimità dell'utente finale, ma non aggiunge mai località che non hai elencato.

I parametri seguenti sono facoltativi. Tutte le impostazioni di sessione fornite vengono bloccate nell'URL dello stream al momento della creazione e applicate a ogni sessione avviata dall'URL dello stream.

Parametro	Description
`UsageLimit`	Quante volte l'URL dello streaming può avviare una sessione. Impostazione predefinita 1; massimo 50.
`Description`	Un'etichetta per l'URL dello stream, da 1 a 80 caratteri.
`SessionLengthSeconds`	Lunghezza massima di ogni sessione iniziata dall'URL dello stream.
`AdditionalLaunchArgs`	Command-line argomenti passati all'applicazione all'avvio.
`AdditionalEnvironmentVariables`	Variabili di ambiente impostate per l'applicazione all'avvio.
`DisplayConfiguration` (`Resolution`)	La risoluzione di visualizzazione dello stream, espressa come `Resolution` larghezza richiesta `Width` e `Height` in pixel. Ogni dimensione deve essere compresa tra 320 e 4096. Se omesso, il servizio utilizza una risoluzione predefinita.
`RoleArn`	Un ruolo IAM le cui credenziali l'applicazione può utilizzare durante ogni sessione. Il ruolo viene bloccato in ogni sessione avviata dall'URL dello stream. Il passaggio di un ruolo richiede l'`iam:PassRole`autorizzazione.
`ClientToken`	Un identificatore univoco con distinzione tra maiuscole e minuscole che rende la richiesta di creazione idempotente, pertanto un nuovo tentativo con lo stesso token non crea un URL di streaming duplicato.

Monitoraggio degli URL dello streaming

GetStreamUrlUsalo per recuperare un singolo URL di streaming. Specifica il gruppo di stream con --identifier e l'URL dello stream con --stream-url-identifier (un ID URL di streaming o ARN). Oltre alla configurazione dell'URL dello streaming, current, and StatusRemainingUses, la risposta include un StreamSessions elenco delle sessioni avviate da tale URL, in modo da poter vedere chi sta trasmettendo attivamente in streaming.


aws gameliftstreams get-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4

ListStreamUrlsUsalo per enumerare gli URL dello streaming nel tuo account. Puoi filtrare per Status e per gruppo di stream e sfogliare i risultati con MaxResults (1—100, impostazione predefinita 25) e. NextToken


aws gameliftstreams list-stream-urls \
    --status ACTIVE \
    --stream-group-identifier sg-1AB2C3De4

Puoi anche controllare l'attività di gestione degli URL dello stream in. CloudTrail CloudTrail registra le chiamate a CreateStreamUrlGetStreamUrl,ListStreamUrls, e RevokeStreamUrl come eventi di dati. Un utente finale che apre un URL di streaming e avvia una sessione non è una delle tue chiamate API e non viene registrato come CloudTrail attività del cliente. Per ulteriori informazioni, consulta Registrazione delle chiamate API Amazon GameLift Streams utilizzando AWS CloudTrail.

Revoca dell'URL di uno stream

Revoca l'URL di uno streaming quando desideri impedirne l'avvio di altre sessioni, ad esempio quando termina un periodo di anteprima o potrebbe essere stato condiviso involontariamente.

RevokeStreamUrlrichiede un: RevocationMode

RevocationMode	Effetto
`REVOKE_URL` (predefinito)	L'URL dello stream non può più avviare nuove sessioni. Le sessioni già in corso continuano fino a quando non terminano da sole.
`REVOKE_AND_TERMINATE_SESSIONS`	L'URL dello stream non può più avviare nuove sessioni e tutte le sessioni attualmente in esecuzione da esso vengono terminate. Quando una sessione in esecuzione viene terminata in questo modo, l'utente finale viene disconnesso e viene visualizzato un messaggio indicante che lo stream non è più disponibile.


aws gameliftstreams revoke-stream-url \
    --identifier sg-1AB2C3De4 \
    --stream-url-identifier su-1AB2C3De4 \
    --revocation-mode REVOKE_AND_TERMINATE_SESSIONS

L'URL di uno stream revocato passa allo REVOKED stato e non può essere riattivato. Crea un nuovo URL di streaming se devi riprendere la condivisione.

Amazon GameLift Streams inoltre revoca automaticamente l'URL di uno stream quando una risorsa da cui dipende viene eliminata. L'eliminazione del gruppo di stream revoca tutti gli URL di stream su quel gruppo di stream e l'eliminazione dell'applicazione revoca tutti gli URL di stream che fanno riferimento a quell'applicazione. In entrambi i casi, l'URL dello stream viene spostato REVOKED con un motivo di stato che identifica la risorsa eliminata.

Nota

La rimozione di una risorsa da cui dipende l'URL di uno stream non equivale all'eliminazione della stessa e non revoca automaticamente l'URL dello stream. L'URL dello streaming rimaneACTIVE, ma ogni tentativo di avviare una sessione da esso fallisce. Ciò accade se scolleghi l'applicazione dell'URL dello stream dal gruppo di stream o se rimuovi tutte le posizioni dei gruppi di stream con cui è stato creato l'URL dello stream. Solo l'eliminazione del gruppo di stream o dell'applicazione attiva la revoca automatica.

Ciclo di vita e stato degli URL dello streaming

L'URL di uno stream ACTIVE viene creato e rimane tale fino alla scadenza, all'esaurimento degli utilizzi o alla revoca. Non ritorna mai ACTIVE dopo aver lasciato quello stato.

Stato	Significato
`ACTIVE`	L'URL dello stream può avviare nuove sessioni.
`EXPIRED`	La `UrlExpiresAfterMinutes` finestra è scaduta.
`REVOKED`	L'URL dello stream è stato revocato, esplicitamente `RevokeStreamUrl` o automaticamente quando il gruppo di stream o l'applicazione sono stati eliminati.
`LIMIT_REACHED`	L'URL dello stream ha utilizzato tutti i suoi. `UsageLimit`

Quando l'URL di uno stream èREVOKED, GetStreamUrl e restituisce ListStreamUrls anche un motivo di stato che ne spiega il motivo.

Motivo dello stato	Causa
`userRevoked`	Revocato con l'`RevokeStreamUrl`utilizzo di`REVOKE_URL`.
`revokedAndTerminatingSessions`	Revocato con`REVOKE_AND_TERMINATE_SESSIONS`; le sessioni in esecuzione vengono terminate.
`revokedAndSessionsTerminated`	Revocato con`REVOKE_AND_TERMINATE_SESSIONS`; le sessioni in esecuzione sono state terminate.
`streamGroupDeleted`	Il gruppo di stream è stato eliminato.
`applicationDeleted`	L'applicazione di riferimento è stata eliminata.

Differenze rispetto alle sessioni con cui inizi StartStreamSession

Le sessioni avviate da un URL di streaming vengono eseguite sulla stessa infrastruttura delle sessioni avviate tu stesso, ma sono ottimizzate per una riproduzione breve e pratica con un solo visualizzatore. Tieni a mente queste differenze:

Nessuna riconnessione. Se l'utente finale perde la connessione o ricarica la pagina, la sessione termina.
Re-visiting consuma un altro uso. Poiché non vi è alcuna riconnessione, la riapertura dell'URL dello stream avvia una sessione completamente nuova e ne consuma un altro utilizzo. UsageLimit
Nessun canale di dati. Gli stream avviati da un URL di streaming non espongono i canali di dati dell'applicazione. Crea il tuo client con Amazon GameLift Streams Web SDK se ne hai bisogno.

Risoluzione dei problemi

Amazon GameLift Streams nasconde deliberatamente agli utenti finali il motivo specifico della mancata attivazione dell'URL dello stream. Un utente finale che apre un URL di streaming che non può avviare uno stream vede sempre una pagina generica «non trovata» o un messaggio «esaurito», indipendentemente dalla causa sottostante. Per diagnosticare la vera causa, ispeziona l'URL dello stream dal lato del creatore con GetStreamUrl eListStreamUrls, controlla il motivo Status e lo stato e controlla l'attività dell'API URL dello stream in CloudTrail.

L'URL dello stream mostra una pagina di errore generica o «non trovata». Controlla Status conGetStreamUrl. EXPIREDREVOKED, o LIMIT_REACHED ognuno spiega un URL di streaming non avviabile. Se lo stato è ACTIVE ma le attivazioni continuano a fallire, è molto probabile che una risorsa da cui dipende l'URL dello streaming sia stata rimossa (non eliminata): l'applicazione è stata scollegata dal gruppo di stream o tutte le posizioni del gruppo di stream con cui è stato creato l'URL dello stream sono state rimosse. Re-link l'applicazione o ripristina una posizione o crea un nuovo URL di streaming utilizzando risorse valide.
L'utente finale visualizza un messaggio «esaurimento delle capacità». Il gruppo di stream non ha la capacità disponibile di inserire una nuova sessione nella posizione più vicina all'utente finale. Ogni attivazione avvia una nuova sessione e consuma capacità pari StartStreamSession a. Aumenta la capacità minima (sempre attiva) o massima oppure utilizza la capacità inattiva prevista (preriscaldata) per mantenere la capacità pronta in anticipo rispetto alla domanda, soprattutto per eventi temporizzati.
La sessione termina quando l'utente finale si aggiorna o se ne va. Questo è previsto. URL-activatedle sessioni non si riconnettono e ogni visita avvia una nuova sessione che consuma un uso. Consigliate agli utenti finali di non effettuare l'aggiornamento e impostate un valore sufficientemente UsageLimit alto da tollerare ricaricamenti occasionali.
L'utente finale viene disconnesso a metà sessione e visualizza «Questa esperienza non è più disponibile». Gli utenti finali visualizzano questo messaggio generico ogni volta che una sessione termina sul lato server. La causa più comune di un URL di streaming è la revoca conREVOKE_AND_TERMINATE_SESSIONS, che interrompe immediatamente le sessioni in esecuzione, ma lo stesso messaggio viene visualizzato se la sessione raggiunge il limite di lunghezza configurato o viene altrimenti terminata dal servizio. Si tratta di un comportamento normale. Crea un nuovo URL di streaming per riprendere la condivisione.
Lo stream non viene caricato o non viene avviato per l'utente finale. Il browser dell'utente finale potrebbe non soddisfare i requisiti di streaming. Lo streaming richiede un browser che supporti WebRTC e H.264 (AVC); consulta la sezione Dispositivi e GameLift browser compatibili con Amazon Streams per i browser supportati e le versioni minime. Una causa comune è l'apertura dell'URL dello streaming in una visualizzazione del browser in-app, ad esempio un link toccato all'interno di una chat, di un'email o di un'app social su un dispositivo mobile, che può disattivare WebRTC. Consiglia ai destinatari di aprire l'URL dello streaming in un browser autonomo come Chrome, Edge o Safari.
CreateStreamUrlrestituisce. ServiceQuotaExceededException La richiesta supererebbe il limite di numero di stream attivi (20 URL di streaming attivi per account o 5 per gruppo di stream). Revoca gli URL di streaming che non ti servono più per liberare spazio e utilizza i ListStreamUrls filtri per set per visualizzare il conteggio attuale. Status ACTIVE
CreateStreamUrlrestituisce. ValidationException Un valore di input non è compreso nell'intervallo. UsageLimitImpostato tra 1 e 50 e UrlExpiresAfterMinutes tra 1 e 1.440.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Sessioni in streaming

Risoluzione dello stream personalizzata