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.
**Important**
Toute personne disposant de l'URL complète peut démarrer une session de streaming jusqu'à ce que l'URL du stream expire, atteigne sa limite d'utilisation ou soit révoquée. Traitez l'URL du stream comme un identifiant : partagez-la uniquement via des canaux fiables, préférez la limite d'expiration et d'utilisation la plus courte possible, et révoquez-la immédiatement en cas de fuite.
## 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 :
+ **Créez. ** Vous appelez un groupe [ CreateStreamUrl ](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_CreateStreamUrl.html) de flux et une application, en définissant la durée de validité de l'URL du flux (`UrlExpiresAfterMinutes`) et le nombre de fois qu'elle peut être utilisée (`UsageLimit`). La configuration de la session de diffusion (arguments de lancement, variables d'environnement, durée de session, résolution d'affichage, etc.) est figée dans l'URL du flux au moment de la création.
+ **Partagez. ** Vous distribuez l'URL du stream via vos propres canaux, tels que le courrier électronique, le chat ou une page d'événement.
+ **Activez. ** Chaque fois qu'un utilisateur ouvre l'URL du flux et commence à diffuser, Amazon GameLift Streams utilise une seule fois l'URL du flux et démarre une toute nouvelle session de diffusion en utilisant la configuration figée. Chaque activation est une session indépendante ; il n'y a pas d'état partagé entre les personnes qui utilisent la même URL de flux.
+ **Fin. ** Les sessions démarrées à partir d'une URL de diffusion sont de courte durée et ne permettent pas la reconnexion. Lorsqu'une session se termine, son utilisation a déjà été comptabilisée ; la réouverture de l'URL du flux démarre une nouvelle session et entraîne une autre utilisation.
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, consultez[Appareils et navigateurs compatibles avec Amazon GameLift Streams](compatible-devices-browsers.md). 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.
**Note**
Les sessions démarrées à partir d'une URL de diffusion sont configurées pour une lecture courte devant un seul utilisateur. Si l'utilisateur final perd sa connexion ou recharge la page, la session se termine et la réouverture de l'URL du flux démarre une nouvelle session qui consomme une autre utilisation. Consultez [Différences par rapport aux sessions par lesquelles vous commencez StartStreamSession](#stream-urls-differences).
## Conditions préalables
Avant de créer une URL de diffusion, vous devez disposer des éléments suivants :
+ Un groupe de diffusion actif et capable d'exécuter des sessions.
+ Une application liée à ce groupe de flux.
+ Autorisation IAM pour les actions relatives à l'URL du flux. La création d'une URL de flux nécessite également l'`gameliftstreams:StartStreamSession`autorisation de l'application vers laquelle elle pointe, car l'activation de l'URL de flux démarre une session de diffusion qui exécute cette application. Consultez l'exemple [Création et gestion d'URL de flux](security_iam_id-based-policy-examples.md#create-and-manage-streamurls-iam) de politique.
+ Si vous transmettez un rôle IAM dans`RoleArn`, vous avez également besoin d'une `iam:PassRole` autorisation pour ce rôle.
## Création d'une URL de flux
**Note**
Vous pouvez créer une URL de flux dans la console Amazon GameLift Streams, à l' AWS CLI aide de l'API ou de l'API. Les exemples suivants utilisent le AWS CLI.
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ée`su-`), son ARN, l'intégralité du contenu partageable`StreamUrl`, 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 :
| Paramètre | Description |
| --- | --- |
| Identifier(groupe de diffusion) | Le groupe de diffusion dont la capacité gère les sessions. Fournissez l'ID ou l'ARN du groupe de flux. |
| ApplicationIdentifier | L'application de ce groupe de flux à diffuser. Indiquez l'ID ou l'ARN de l'application. |
| Protocol | Le protocole de diffusion. WebRTCest la seule valeur prise en charge. |
| UrlExpiresAfterMinutes | Durée de validité de l'URL du flux, en minutes, à compter de sa création. Minimum 1 ; maximum 1 440 (24 heures). Après cette fenêtre, l'URL du flux devientEXPIRED. |
| Locations | Vos emplacements préférés, sous forme de Région AWS codes tels queus-west-2, par ordre de priorité. Amazon GameLift Streams les réorganise en fonction de la proximité avec l'utilisateur final, mais n'ajoute jamais de lieux que vous n'avez pas répertoriés. |
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.
| Paramètre | Description |
| --- | --- |
| UsageLimit | Combien de fois l'URL du stream peut démarrer une session. Par défaut 1 ; maximum 50. |
| Description | Une étiquette pour l'URL du flux, de 1 à 80 caractères. |
| SessionLengthSeconds | Durée maximale de chaque session démarrée à partir de l'URL du stream. |
| AdditionalLaunchArgs | Command-line arguments transmis à l'application lors du lancement. |
| AdditionalEnvironmentVariables | Variables d'environnement définies pour l'application au lancement. |
| DisplayConfiguration (Resolution) | Résolution d'affichage du flux, donnée Resolution en pixels Width et Height en pixels. Chaque dimension doit être comprise entre 320 et 4096. En cas d'omission, le service utilise une résolution par défaut. |
| RoleArn | Rôle IAM dont les informations d'identification peuvent être utilisées par l'application à chaque session. Le rôle est figé dans chaque session au cours de laquelle l'URL du stream démarre. La transmission d'un rôle nécessite une iam:PassRole autorisation. |
| ClientToken | Identifiant unique distinguant les majuscules et minuscules qui rend la demande de création idempotente, de sorte qu'une nouvelle tentative avec le même jeton ne crée pas d'URL de flux dupliquée. |
## Surveillance des URL de vos flux
[GetStreamUrl](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamUrl.html)À 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` et`RemainingUses`, 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
```
[ListStreamUrls](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_ListStreamUrls.html)Utilisez-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) et`NextToken`.
```
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 vers`CreateStreamUrl`, `GetStreamUrl``ListStreamUrls`, 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](logging-using-cloudtrail.md).
## 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.
[RevokeStreamUrl](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_RevokeStreamUrl.html)prend un `RevocationMode` :
| RevocationMode | Effet |
| --- | --- |
| REVOKE\_URL (par défaut) | L'URL du stream ne permet plus de démarrer de nouvelles sessions. Les sessions déjà en cours se poursuivent jusqu'à ce qu'elles se terminent d'elles-mêmes. |
| REVOKE\_AND\_TERMINATE\_SESSIONS | L'URL du flux ne peut plus démarrer de nouvelles sessions et toutes les sessions en cours d'exécution sont terminées. Lorsqu'une session en cours est interrompue de cette manière, l'utilisateur final est déconnecté et reçoit un message indiquant que le flux n'est plus disponible. |
```
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.
**Note**
Supprimer une ressource dont dépend l'URL d'un flux n'est pas la même chose que la supprimer et ne révoque pas automatiquement l'URL du flux. L'URL du flux est `ACTIVE` conservée, mais chaque tentative de démarrage d'une session à partir de celui-ci échoue. Cela se produit si vous dissociez l'application de l'URL du flux du groupe de flux ou si vous supprimez tous les emplacements des groupes de flux avec lesquels l'URL du flux a été créée. Seule la suppression du groupe de flux ou de l'application déclenche la révocation automatique.
## 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.
| Statut | Signification |
| --- | --- |
| ACTIVE | L'URL du stream peut démarrer de nouvelles sessions. |
| EXPIRED | La UrlExpiresAfterMinutes fenêtre est écoulée. |
| REVOKED | L'URL du flux a été révoquée, soit explicitement, soit automatiquement lorsque son groupe de flux ou son application ont été supprimés. RevokeStreamUrl |
| LIMIT\_REACHED | L'URL du flux a utilisé tous sesUsageLimit. |
Quand l'URL d'un flux est`REVOKED`, `GetStreamUrl` et renvoie `ListStreamUrls` également une raison de statut qui explique pourquoi.
| Motif du statut | Cause |
| --- | --- |
| userRevoked | Révoqué en RevokeStreamUrl utilisantREVOKE\_URL. |
| revokedAndTerminatingSessions | Révoqué avec REVOKE\_AND\_TERMINATE\_SESSIONS ; les sessions en cours sont terminées. |
| revokedAndSessionsTerminated | Révoqué avec REVOKE\_AND\_TERMINATE\_SESSIONS ; les sessions en cours ont été interrompues. |
| streamGroupDeleted | Le groupe de flux a été supprimé. |
| applicationDeleted | L'application référencée a été supprimée. |
## 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 :
+ **Aucune reconnexion. ** Si l'utilisateur final perd sa connexion ou recharge la page, la session se termine.
+ **Re-visiting consomme un autre usage. ** Comme il n'y a pas de reconnexion, la réouverture de l'URL du flux démarre une toute nouvelle session et consomme une autre utilisation de celle-ci`UsageLimit`.
+ **Aucun canal de données. ** Les flux démarrés à partir d'une URL de flux n'exposent pas les canaux de données de l'application. Créez votre propre client avec le SDK Web Amazon GameLift Streams si vous en avez besoin.
## 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` et`ListStreamUrls`, vérifiez la raison `Status` et le statut, puis examinez l'activité de l'API de l'URL du flux dans CloudTrail.
+ **L'URL du flux affiche une page d'erreur « introuvable » ou générique. ** Vérifiez `Status` avec`GetStreamUrl`. `EXPIRED``REVOKED`, ou `LIMIT_REACHED` chacun explique une URL de flux non démarrable. Si le statut est le même `ACTIVE` mais que les activations échouent toujours, une ressource dont dépend l'URL du flux a probablement été supprimée (et non supprimée) : l'application a été dissociée du groupe de flux ou tous les emplacements des groupes de flux avec lesquels l'URL du flux a été créée ont été supprimés. Re-link l'application ou restaurez un emplacement, ou créez une nouvelle URL de flux à partir de ressources valides.
+ **L'utilisateur final voit apparaître un message « à pleine capacité ». ** Le groupe de diffusion n'a aucune capacité disponible pour placer une nouvelle session dans l'emplacement le plus proche de l'utilisateur final. Chaque activation démarre une nouvelle session et consomme de la capacité, par exemple`StartStreamSession`. Augmentez la capacité minimale (toujours active) ou maximale, ou utilisez la capacité cible inactive (préchauffée) pour maintenir la capacité prête avant la demande, en particulier pour les événements limités dans le temps.
+ **La session se termine lorsque l'utilisateur final actualise la page ou quitte la page. ** C'est ce qui est attendu. URL-activatedles sessions ne se reconnectent pas et chaque visite démarre une nouvelle session qui consomme une utilisation. Conseillez aux utilisateurs finaux de ne pas actualiser et définissez une valeur suffisamment `UsageLimit` élevée pour tolérer des rechargements occasionnels.
+ **L'utilisateur final est déconnecté en cours de session et le message « Cette expérience n'est plus disponible » s'affiche. ** Les utilisateurs finaux voient ce message générique chaque fois qu'une session se termine côté serveur. La cause la plus courante d'une URL de flux est sa révocation`REVOKE_AND_TERMINATE_SESSIONS`, ce qui met fin immédiatement aux sessions en cours, mais le même message apparaît si la session atteint la limite de longueur configurée ou est interrompue par le service. Ceci est normal. Créez une nouvelle URL de diffusion pour reprendre le partage.
+ **Le flux ne se charge pas ou ne démarre pas pour l'utilisateur final. ** Le navigateur de l'utilisateur final ne répond peut-être pas aux exigences de streaming. Le streaming nécessite un navigateur prenant en charge WebRTC et H.264 (AVC) ; voir [Appareils et navigateurs compatibles avec Amazon GameLift Streams](compatible-devices-browsers.md) pour les navigateurs pris en charge et les versions minimales. L'une des causes les plus courantes est l'ouverture de l'URL du stream dans un affichage du navigateur intégré à l'application, par exemple en cliquant sur un lien dans un chat, un e-mail ou une application sociale sur un appareil mobile, ce qui peut désactiver WebRTC. Conseillez aux destinataires d'ouvrir l'URL du stream dans un navigateur autonome tel que Chrome, Edge ou Safari.
+ **`CreateStreamUrl`retours`ServiceQuotaExceededException`. ** La demande dépasserait la limite du nombre d'URL actives (20 URL de flux actifs par compte ou 5 par groupe de flux). Révoquez les URL des flux dont vous n'avez plus besoin pour libérer de la marge de manœuvre, et `ListStreamUrls` utilisez-les pour filtrer par `Status` ensemble `ACTIVE` pour voir votre nombre actuel.
+ **`CreateStreamUrl`retours`ValidationException`. ** Une valeur d'entrée est hors plage. Réglez `UsageLimit` de 1 à 50 et `UrlExpiresAfterMinutes` de 1 à 1 440.