Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Teilen Sie Stream-Sitzungen mit Stream-URLs

Mit Stream-URLs können Sie Ihre Stream-Sitzungen schnell mit anderen teilen. Empfänger greifen in einem unterstützten Webbrowser auf deine Stream-Sitzungen zu, ohne dass AWS-Konto eine Client-Integration erforderlich ist, und du kontrollierst Ablauf, Nutzung und Widerruf. Nachdem Sie eine Stream-URL erstellt haben, startet jeder, der darauf zugreift, seine eigene Stream-Sitzung, ohne dass Anmeldeinformationen erforderlich sind. Stream-URLs sind ideal, um schnell und einfach Demos, Spieltests, Bewertungen von Interessengruppen und Gastzugänge einzurichten.

Wie funktionieren Stream-URLs

Eine Stream-URL verbindet eine Stream-Gruppe (die Kapazität, auf der der Stream ausgeführt wird) und eine Anwendung in dieser Stream-Gruppe (der auszuführende Inhalt). Wenn Sie eine Stream-URL erstellen, gibt Amazon GameLift Streams eine Stream-URL der folgenden Form zurück:

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

Der Workflow besteht aus vier Schritten:

Da die Stream-URL nicht authentifiziert ist, sieht oder benötigt der Endbenutzer Ihre Anmeldeinformationen nie. AWS Der Service leitet jeden Endbenutzer an einen Standort in der Nähe weiter, basierend auf der Streaming-Standortpräferenz, die Sie bei der Erstellung festgelegt haben. Amazon GameLift Streams ordnet Ihre bevorzugten Streaming-Standorte nach Nähe neu, fügt jedoch niemals Standorte hinzu, die Sie nicht angegeben haben.

Das Endbenutzererlebnis

Benutzer, mit denen Sie eine Stream-URL teilen, benötigen keine AWS-Konto oder eine Softwareinstallation. Sie öffnen die URL in einem unterstützten Webbrowser und streamen von einer Webseite, die Amazon GameLift Streams für Sie hostet. Streaming verwendet WebRTC und hat dieselben Browser- und Geräteanforderungen wie der Amazon GameLift Streams Web SDK-Client. Die unterstützten Browser und Mindestversionen finden Sie unter. Mit Amazon GameLift Streams kompatible Geräte und Browser Wenn für die Stream-Gruppe keine Kapazität verfügbar ist, wenn ein Endbenutzer die URL öffnet, wird auf der Seite eine Meldung angezeigt, dass der Stream vorübergehend ausgelastet ist, und der Endbenutzer kann es erneut versuchen. Wenn der Endbenutzer versucht, den Tab zu schließen oder neu zu laden, fordert ihn die Seite zur Bestätigung auf, da das Verlassen der Seite die Sitzung beendet.

Voraussetzungen

Bevor Sie eine Stream-URL erstellen, benötigen Sie Folgendes:

Eine Stream-URL erstellen

Im folgenden AWS CLI Beispiel wird eine Stream-URL für eine Anwendung in einer Stream-Gruppe erstellt. Die Stream-URL ist zwei Stunden lang gültig und kann bis zu fünf Mal verwendet werden. Sie bevorzugt die us-east-1 Speicherorte us-west-2 und.

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"

Bei einem erfolgreichen Aufruf wird die Stream-URL-Ressource einschließlich ihrer Ressource StreamUrlId (mit Präfixsu-), ihres ARN, der gesamten gemeinsam nutzbaren RessourceStreamUrl, der berechneten Ablaufzeit und der anfänglichen verbleibenden Nutzungen zurückgegeben.

{
    "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"
}

Die folgenden Parameter sind erforderlich:

Die folgenden Parameter sind optional. Alle von Ihnen angegebenen Sitzungseinstellungen werden bei der Erstellung in der Stream-URL eingefroren und auf jede Sitzung angewendet, die über die Stream-URL gestartet wurde.

Überwachen Sie Ihre Stream-URLs

Wird verwendet GetStreamUrl, um eine einzelne Stream-URL abzurufen. Geben Sie die Stream-Gruppe mit --identifier und die Stream-URL mit --stream-url-identifier (eine Stream-URL-ID oder ARN) an. Zusätzlich zur Konfiguration der Stream-URL, aktuell und StatusRemainingUses, enthält die Antwort eine StreamSessions Liste der Sitzungen, die von der Stream-URL aus gestartet wurden, sodass Sie sehen können, wer aktiv streamt.

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

Wird verwendet ListStreamUrls, um die Stream-URLs in Ihrem Konto aufzulisten. Sie können nach Stream-Gruppe filtern Status und die Ergebnisse mit MaxResults (1—100, Standard 25) und durchblättern. NextToken

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

Sie können die Aktivitäten zur Stream-URL-Verwaltung auch in CloudTrail überprüfen. CloudTrail zeichnet Aufrufe vonCreateStreamUrl, GetStreamUrlListStreamUrls, und RevokeStreamUrl als Datenereignisse auf. Ein Endbenutzer, der eine Stream-URL öffnet und eine Sitzung startet, gehört nicht zu Ihren API-Aufrufen und wird nicht als CloudTrail Kundenaktivität aufgezeichnet. Weitere Informationen finden Sie unter Protokollieren von Amazon GameLift Streams-API-Aufrufen mit AWS CloudTrail.

Widerrufen einer Stream-URL

Widerrufen Sie eine Stream-URL, wenn Sie verhindern möchten, dass weitere Sitzungen gestartet werden, z. B. wenn ein Vorschauzeitraum endet oder sie möglicherweise versehentlich geteilt wurde.

RevokeStreamUrlbenötigt einRevocationMode:

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

Eine widerrufene Stream-URL geht in den REVOKED Status über und kann nicht reaktiviert werden. Erstellen Sie eine neue Stream-URL, wenn Sie das Teilen fortsetzen müssen.

Amazon GameLift Streams widerruft auch automatisch eine Stream-URL, wenn eine Ressource, von der sie abhängt, gelöscht wird. Durch das Löschen der Stream-Gruppe werden alle Stream-URLs in dieser Stream-Gruppe gesperrt, und durch das Löschen der Anwendung werden alle Stream-URLs gesperrt, die auf diese Anwendung verweisen. In beiden Fällen wechselt die Stream-URL zu REVOKED einem Statusgrund, der die gelöschte Ressource identifiziert.

Lebenszyklus und Status der Stream-URL

Eine Stream-URL wird ACTIVE erstellt und bleibt so, bis sie abläuft, nicht mehr verwendet wird oder gesperrt wird. Es kehrt nie wieder dorthin zurück, ACTIVE nachdem es diesen Staat verlassen hat.

Wenn es sich um eine Stream-URL handeltREVOKED, GetStreamUrl geben sie ListStreamUrls auch einen Statusgrund zurück, der erklärt, warum.

Unterschiede zu den Sitzungen, mit denen Sie beginnen StartStreamSession

Sitzungen, die über eine Stream-URL gestartet wurden, werden auf derselben Infrastruktur ausgeführt wie Sitzungen, die Sie selbst starten. Sie sind jedoch auf eine kurze, freihändige Einzelbetrachterwiedergabe abgestimmt. Behalte diese Unterschiede im Hinterkopf:

Fehlerbehebung

Amazon GameLift Streams verbirgt bewusst den spezifischen Grund für eine fehlgeschlagene Stream-URL-Aktivierung vor Endbenutzern. Einem Endbenutzer, der eine Stream-URL öffnet, die keinen Stream starten kann, wird unabhängig von der zugrunde liegenden Ursache immer eine generische „Nicht gefunden“ -Seite oder die Meldung „Ausgelastet“ angezeigt. Um die wahre Ursache zu diagnostizieren, überprüfen Sie die Stream-URL von der Seite des Erstellers mit GetStreamUrl undListStreamUrls, überprüfen Sie den Grund Status und den Status und überprüfen Sie die Aktivität der Stream-URL-API unter CloudTrail.