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.

Partagez des sessions de streaming avec des URL de flux

Les URL de streaming vous permettent de partager rapidement vos sessions de streaming avec n'importe qui. Les destinataires accèdent à vos sessions de streaming dans un navigateur Web compatible, sans intégration Compte AWS ni intégration client requise, et vous contrôlez l'expiration, l'utilisation et la révocation. Après avoir créé une URL de flux, toute personne qui y accède démarre sa propre session de streaming sans avoir besoin d'informations d'identification. Les URL des streams sont idéales pour configurer rapidement et facilement des démos, des playtests, des évaluations des parties prenantes et l'accès des invités.

Comment fonctionnent les URL des flux

Une URL de flux relie un groupe de flux (la capacité qui exécute le flux) et une application de ce groupe de flux (le contenu à exécuter). Lorsque vous créez une URL de flux, Amazon GameLift Streams renvoie une URL de flux de la forme suivante :

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

Le flux de travail comporte quatre étapes :

L'URL du flux n'étant pas authentifiée, l'utilisateur final ne voit jamais vos AWS informations d'identification et n'en a jamais besoin. Le service achemine chaque utilisateur final vers un lieu proche en fonction de la préférence de localisation de diffusion que vous avez définie au moment de la création. Amazon GameLift Streams réorganise vos sites de diffusion préférés en fonction de leur proximité, mais n'ajoute jamais de sites que vous n'avez pas inclus.

L'expérience de l'utilisateur final

Les utilisateurs avec lesquels vous partagez l'URL d'un stream n'ont pas besoin Compte AWS d'installer de logiciel. Ils ouvrent l'URL dans un navigateur Web compatible et diffusent depuis une page Web hébergée par Amazon GameLift Streams pour vous. Le streaming utilise WebRTC et répond aux mêmes exigences en matière de navigateur et d'appareil que le client Amazon GameLift Streams Web SDK. Pour les navigateurs pris en charge et les versions minimales, consultezAppareils et navigateurs compatibles avec Amazon GameLift Streams. Si la capacité du groupe de flux n'est pas disponible lorsqu'un utilisateur final ouvre l'URL, la page affiche un message indiquant que le flux est temporairement à pleine capacité et l'utilisateur final peut réessayer. Si l'utilisateur final essaie de fermer ou de recharger l'onglet, la page l'invite à confirmer, car quitter la page met fin à la session.

Conditions préalables

Avant de créer une URL de diffusion, vous devez disposer des éléments suivants :

Création d'une URL de flux

L' AWS CLI exemple suivant crée une URL de flux pour une application appartenant à un groupe de flux. L'URL du flux est valide pendant deux heures et peut être utilisée jusqu'à cinq fois, et elle préfère les us-east-1 emplacements us-west-2 et.

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"

Un appel réussi renvoie la ressource URL du flux, y compris sa ressource StreamUrlId (préfixéesu-), son ARN, l'intégralité du contenu partageableStreamUrl, l'heure d'expiration calculée et les utilisations initiales restantes.

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

Les paramètres suivants sont obligatoires :

Les paramètres suivants sont facultatifs. Tous les paramètres de session que vous fournissez sont figés dans l'URL du flux au moment de la création et appliqués à chaque session démarrée à partir de l'URL du flux.

Surveillance des URL de vos flux

GetStreamUrlÀ utiliser pour récupérer l'URL d'un seul flux. Spécifiez le groupe de flux avec --identifier et l'URL du flux avec --stream-url-identifier (un ID d'URL de flux ou un ARN). En plus de la configuration de l'URL du flux, en cours Status etRemainingUses, la réponse inclut une StreamSessions liste des sessions démarrées à partir de celle-ci, afin que vous puissiez voir qui diffuse activement.

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

ListStreamUrlsUtilisez-le pour énumérer les URL des flux de votre compte. Vous pouvez filtrer par Status et par groupe de flux, et faire défiler les résultats avec MaxResults (1 à 100, par défaut 25) etNextToken.

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

Vous pouvez également auditer l'activité de gestion des URL des flux dans CloudTrail. CloudTrail enregistre les appels versCreateStreamUrl, GetStreamUrlListStreamUrls, et RevokeStreamUrl en tant qu'événements de données. Un utilisateur final ouvrant l'URL d'un stream et démarrant une session ne fait pas partie de vos appels d'API et n'est pas enregistré comme CloudTrail activité client. Pour de plus amples informations, veuillez consulter Journalisation des appels d'API Amazon GameLift Streams à l'aide de AWS CloudTrail.

Révocation de l'URL d'un flux

Révoquez l'URL d'un stream lorsque vous souhaitez l'empêcher de démarrer d'autres sessions, par exemple lorsqu'une période de prévisualisation se termine ou qu'il a peut-être été partagé par inadvertance.

RevokeStreamUrlprend un RevocationMode :

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

L'URL d'un flux révoquée passe au REVOKED statut et ne peut pas être réactivée. Créez une nouvelle URL de diffusion si vous devez reprendre le partage.

Amazon GameLift Streams révoque également automatiquement l'URL d'un flux lorsqu'une ressource dont il dépend est supprimée. La suppression du groupe de flux révoque toutes les URL de flux de ce groupe de flux, et la suppression de l'application révoque toutes les URL de flux qui font référence à cette application. Dans les deux cas, l'URL du flux est REVOKED déplacée avec une raison de statut qui identifie la ressource supprimée.

Cycle de vie et statut de l'URL du stream

L'URL d'un ACTIVE flux est créée et le reste jusqu'à son expiration, sa fin d'utilisation ou sa révocation. Il ne revient jamais ACTIVE après avoir quitté cet état.

Quand l'URL d'un flux estREVOKED, GetStreamUrl et renvoie ListStreamUrls également une raison de statut qui explique pourquoi.

Différences par rapport aux sessions par lesquelles vous commencez StartStreamSession

Les sessions démarrées à partir d'une URL de diffusion s'exécutent sur la même infrastructure que les sessions que vous démarrez vous-même, mais elles sont configurées pour une lecture courte, directe et par visionnage unique. Gardez ces différences à l'esprit :

Résolution des problèmes

Amazon GameLift Streams cache délibérément aux utilisateurs finaux la raison spécifique de l'échec de l'activation de l'URL d'un stream. Un utilisateur final qui ouvre l'URL d'un flux qui ne peut pas démarrer un flux voit toujours une page générique « introuvable » ou un message « à pleine capacité », quelle qu'en soit la cause sous-jacente. Pour diagnostiquer la véritable cause, inspectez l'URL du flux du côté du créateur avec GetStreamUrl etListStreamUrls, vérifiez la raison Status et le statut, puis examinez l'activité de l'API de l'URL du flux dans CloudTrail.