# Mise en route avec le streaming à faible latence IVS
Ce document vous guide à travers les étapes de configuration de votre premier flux en direct Amazon Interactive Video Service (IVS).
**Topics**
+ [Étape 1 : créer un compte AWS](getting-started-create-account.md)
+ [Étape 2 : configurer les utilisateurs root et administratifs](getting-started-setup-users.md)
+ [Étape 3 : configurer des autorisations IAM](getting-started-iam-permissions.md)
+ [Étape 4 : créer un canal avec une option d'enregistrement facultative](getting-started-create-channel.md)
+ [Étape 5 : configurer le logiciel de streaming](getting-started-set-up-streaming.md)
+ [Étape 6 : voir votre diffusion en direct](getting-started-view-stream.md)
+ [Étape 7 : vérifiez vos limites Service Quotas (facultatif)](getting-started-check-service-quota.md)
+ [Étape 8 : Empêcher le contenu et les spectateurs indésirables (recommandé)](getting-started-prevent-undesired-content.md)
# Étape 1 : créer un compte AWS
Pour utiliser Amazon IVS, vous avez besoin d’un compte AWS. Si vous n'en avez pas déjà un, vous serez invité à le créer lors de votre inscription. Pour créer un compte AWS :
1. Ouvrez [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d'inscription, vous recevrez un appel téléphonique ou un SMS et serez invité à saisir un code de vérification. En outre, bien que le service de base soit gratuit, vous devrez fournir des informations de facturation. Vous n'êtes pas facturé pour les services AWS auxquels vous souscrivez, sauf si vous les utilisez.
1. Une fois votre compte créé, vous recevrez un e-mail avec votre **URL de connexion** et votre **nom d’utilisateur**, ainsi qu’un autre e-mail de votre administrateur de compte AWS avec votre mot de passe. Vous devrez modifier ce dernier à votre première connexion.
Si vous voulez utiliser un compte AWS existant, vérifiez qu'il utilise une région AWS prise en charge pour Amazon IVS :
1. Accédez à la [console Amazon IVS](https://console.aws.amazon.com/ivs). Si vous voyez la page habituelle de la console IVS (affichant « Global Solution, regional content » [Solution globale, contenu régional]), tout va bien ; passez à l'[Étape 2 : configurer les utilisateurs root et administratifs](getting-started-setup-users.md). Si vous êtes redirigé vers une page d'AWS « unsupported region » (région non prise en charge), vous devez sélectionner une nouvelle région.
1. Sélectionnez l’onglet approprié (**Diffusion en direct** pour IVS ; **Chat de flux** pour IVS Chat), puis sélectionnez l’une des régions répertoriées. *Notez la région que vous choisissez ; vous en aurez besoin plus tard*.
À tout moment, vous pouvez consulter l'activité de votre compte AWS et gérer votre compte en accédant à [https://aws.amazon.com/](https://aws.amazon.com/) et en cliquant sur **Mon compte**.
# Étape 2 : configurer les utilisateurs root et administratifs
Lorsque vous vous inscrivez pour un compte AWS, un utilisateur root du compte AWS est créé. L'utilisateur root a accès à tous les services et ressources AWS du compte. En tant que bonne pratique de sécurité, [attribuez un accès administratif à un utilisateur administratif](https://docs.aws.amazon.com/singlesignon/latest/userguide/useraccess.html), et n'utilisez l'utilisateur root que pour effectuer des [tâches nécessitant un accès utilisateur root](https://docs.aws.amazon.com/IAM/latest/UserGuide/root-user-tasks.html).
## Sécuriser l'utilisateur root de votre compte AWS
1. Pour vous connecter en tant qu'utilisateur administratif dans IAM Identity Center, utilisez l'URL de connexion qui a été envoyée à votre adresse e-mail lorsque vous avez créé l'utilisateur IAM Identity Center. Pour obtenir de l'aide afin de vous connecter à l'aide d'un utilisateur IAM Identity Center, consultez la section [Connexion au portail d'accès AWS](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) dans le *Guide de l'utilisateur de connexion à AWS*.
Pour obtenir de l'aide pour vous connecter en utilisant l'utilisateur root, consultez la section [Connexion en tant qu'utilisateur root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) dans le *Guide de l'utilisateur de connexion à AWS*.
1. Activez l’authentification multifactorielle (MFA) pour votre utilisateur racine.
Pour obtenir des instructions, consultez la section [Activation d'un dispositif MFA virtuel pour l'utilisateur root de votre compte AWS (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_enable_virtual.html#enable-virt-mfa-for-root) dans le *Guide de l'utilisateur IAM*.
## Créer un utilisateur administratif
Vous devez créer un utilisateur administratif afin de ne pas utiliser l'utilisateur root pour les tâches quotidiennes.
+ Pour vos tâches administratives quotidiennes, attribuez un accès administratif à un utilisateur administratif dans AWS IAM Identity Center (successeur d'AWS Single Sign-On). Pour obtenir des instructions, consultez la section [Mise en route](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) dans le *Guide de l'utilisateur d'AWS IAM Identity Center (successeur d'AWS Single Sign-On)*.
+ Pour vous connecter en tant qu'utilisateur administratif dans IAM Identity Center, utilisez l'URL de connexion qui a été envoyée à votre adresse e-mail lorsque vous avez créé l'utilisateur IAM Identity Center. Pour obtenir de l'aide afin de vous connecter à l'aide d'un utilisateur IAM Identity Center, consultez la section [Connexion au portail d'accès AWS](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) dans le *Guide de l'utilisateur de connexion à AWS*.
# Étape 3 : configurer des autorisations IAM
Ensuite, vous devez créer une politique AWS Identity and Access Management (IAM) qui donne aux utilisateurs un ensemble d'autorisations de base (par exemple, pour créer un canal Amazon IVS, obtenir des informations sur la diffusion et l'enregistrement automatique vers S3) et affecter cette politique aux utilisateurs. Vous pouvez soit attribuer les autorisations lors de la création d'un [nouvel utilisateur](#iam-permissions-new-user), soit ajouter des autorisations à un [utilisateur existant](#iam-permissions-existing-user). Les deux procédures sont données ci-dessous.
Pour plus d’informations (par exemple, pour en savoir plus sur les utilisateurs et les politiques IAM, comment attacher une politique à un utilisateur et comment limiter les actions des utilisateurs sur Amazon IVS), consultez :
+ [Création d’un utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#Using_CreateUser_console) dans le *Guide de l’utilisateur IAM*
+ Les informations dans [Sécurité Amazon IVS](security.md) concernent l’IAM et les « politiques gérées pour IVS ».
+ Pour la fonctionnalité record-to-S3 : [Utilisation des rôles liés à un service](security-service-linked-roles.md) et [Enregistrement automatique vers Amazon S3](record-to-s3.md) dans le *Guide de l’utilisateur Amazon IVS*
Vous pouvez utiliser une politique gérée par AWS existante pour Amazon IVS ou créer une politique qui personnalise les autorisations que vous souhaitez accorder à un ensemble d’utilisateurs, de groupes ou de rôles. Les deux approches sont décrites ci-dessous.
## Utiliser une politique existante pour les autorisations IVS
Dans la plupart des cas, vous souhaiterez utiliser une politique gérée par AWS pour Amazon IVS. Elles sont décrites en détail dans la section [Managed Policies for IVS](security-iam-awsmanpol.md) de *Sécurité IVS*.
+ Utilisez la politique gérée par AWS `IVSReadOnlyAccess` pour permettre à vos développeurs d’applications d’accéder à toutes les opérations des API IVS Get et List (pour la diffusion à faible latence et en temps réel).
+ Utilisez la politique gérée par AWS `IVSFullAccess` pour permettre à vos développeurs d’applications d’accéder à toutes les opérations des API IVS (pour la diffusion à faible latence et en temps réel).
## Facultatif : créer une politique personnalisée pour les autorisations Amazon IVS
Procédez comme suit :
1. Connectez-vous à la console de gestion AWS et ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le panneau de navigation, sélectionnez **Politicies** (Politiques), puis **Create policy** (Créer une politique). La fenêtre **Spécifier les autorisations** s’ouvre.
1. Dans la fenêtre **Spécifier les autorisations**, choisissez l’onglet **JSON** et copiez/collez la politique IVS suivante dans la zone de texte de l’**Éditeur de politique**. (La politique n’inclut pas toutes les actions Amazon IVS. Vous pouvez ajouter/supprimer (Autoriser/Refuser) des autorisations d’accès aux opérations selon vos besoins. Consultez [Référence de l’API de diffusion à faible latence IVS](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/Welcome.html) pour en savoir plus sur les opérations IVS.)
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ivs:CreateChannel",
"ivs:CreateRecordingConfiguration",
"ivs:GetChannel",
"ivs:GetRecordingConfiguration",
"ivs:GetStream",
"ivs:GetStreamKey",
"ivs:GetStreamSession",
"ivs:ListChannels",
"ivs:ListRecordingConfigurations",
"ivs:ListStreamKeys",
"ivs:ListStreams",
"ivs:ListStreamSessions"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"cloudwatch:DescribeAlarms",
"cloudwatch:GetMetricData",
"s3:CreateBucket",
"s3:GetBucketLocation",
"s3:ListAllMyBuckets",
"servicequotas:ListAWSDefaultServiceQuotas",
"servicequotas:ListRequestedServiceQuotaChangeHistoryByQuota",
"servicequotas:ListServiceQuotas",
"servicequotas:ListServices",
"servicequotas:ListTagsForResource"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"iam:AttachRolePolicy",
"iam:CreateServiceLinkedRole",
"iam:PutRolePolicy"
],
"Resource":
"arn:aws:iam::*:role/aws-service-role/ivs.amazonaws.com/AWSServiceRoleForIVSRecordToS3*"
}
]
}
```
------
1. Toujours dans la fenêtre **Spécifier les autorisations**, choisissez **Suivant** (faites défiler la fenêtre vers le bas pour voir ceci). Une fenêtre **Vérifier et créer** s’ouvre.
1. Dans la fenêtre **Vérifier et créer**, saisissez un **Nom de politique** et ajoutez éventuellement une **Description**. Notez le nom de la politique, car vous en aurez besoin lors de la création des utilisateurs (ci-dessous). En bas de la fenêtre, choisissez **Create policy** (Créer la politique).
1. Vous êtes renvoyé à la fenêtre de la console IAM, où vous devriez voir une bannière confirmant que votre nouvelle politique a été créée.
## Créer un nouvel utilisateur et ajouter des autorisations
### Clés d’accès utilisateur IAM
Les clés d'accès IAM sont constituées d'un ID de clé d'accès et d'une clé d'accès secrète. Elles permettent de signer les demandes de manière programmatique auprès des services AWS. Si vous n’avez pas de clés d’accès, vous pouvez en créer à l’aide de la console de gestion AWS. En guise de bonnes pratiques, ne créez pas de clés d’accès pour l’utilisateur root.
*La seule fois où vous pouvez visualiser ou télécharger une clé d’accès secrète est lors de sa création. Vous ne pouvez pas la récupérer par la suite.* Toutefois, pour créer des clés d’accès, vous devez disposer des autorisations permettant d’effectuer les opérations IAM nécessaires.
Conservez toujours les clés d’accès en lieu sûr. Ne les partagez jamais avec des tiers (même si une demande semble provenir d’Amazon). Pour de plus amples informations, veuillez consulter [Gestion des clés d’accès pour les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dans le *Guide de l’utilisateur IAM*.
### Procédure
Procédez comme suit :
1. Dans le panneau de navigation, choisissez **Utilisateurs**, puis **Créer un utilisateur**. Une fenêtre **Spécifier les détails de l’utilisateur** s’ouvre.
1. Dans la fenêtre **Spécifier les détails de l’utilisateur** :
1. Sous **Détails de l’utilisateur**, saisissez le nouveau **Nom d’utilisateur** à créer.
1. Cochez **Fournir un accès utilisateur à l’AWS Management Console**.
1. Lorsque vous y êtes invité, sélectionnez **Je souhaite créer un utilisateur IAM**.
1. Sous **Mot de passe de la console**, sélectionnez **Mot de passe généré automatiquement**.
1. Cochez **Les utilisateurs doivent créer un nouveau mot de passe lors de la prochaine connexion**.
1. Choisissez **Suivant**. Une fenêtre **Définir les autorisations** s’ouvre.
1. Pour **Définir les autorisations**, sélectionnez **Attacher directement les politiques**. Une fenêtre **Politiques d’autorisations** s’ouvre.
1. Dans le champ de recherche, entrez le nom d’une politique IVS (soit une politique gérée par AWS, soit une politique personnalisée que vous avez créée précédemment). Lorsqu’elle est trouvée, cochez la case pour sélectionner la politique.
1. Choisissez **Suivant** (en bas de la fenêtre). Une fenêtre **Vérifier et créer** s’ouvre.
1. Dans la fenêtre **Vérifier et créer**, vérifiez que toutes les informations utilisateur sont correctes, puis choisissez **Créer un utilisateur** (en bas de la fenêtre).
1. La fenêtre **Récupérer le mot de passe** s’ouvre et contient les **Informations de connexion à la console**. *Enregistrez ces informations de manière sécurisée pour pouvoir vous y référer ultérieurement*. Une fois que vous avez termin, choisissez **Retourner à la liste des utilisateurs**.
## Ajouter des autorisations à un utilisateur existant
Procédez comme suit :
1. Connectez-vous à la console de gestion AWS et ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le panneau de navigation, choisissez**Users** (Utilisateurs), puis choisissez un nom d’utilisateur existant à mettre à jour. (Choisissez le nom en cliquant dessus ; ne cochez pas la case de sélection.)
1. Sur la page **Récapitulatif**, dans l’onglet **Autorisations**, choisissez **Ajouter des autorisations**. La fenêtre **Ajouter des autorisations** s’ouvre.
1. Sélectionnez **Attach existing policies directly (Attacher directement les politiques existantes)**. Une fenêtre **Politiques d’autorisations** s’ouvre.
1. Dans le champ de recherche, entrez le nom d’une politique IVS (soit une politique gérée par AWS, soit une politique personnalisée que vous avez créée précédemment). Lorsque la politique est trouvée, cochez la case pour la sélectionner.
1. Choisissez **Suivant** (en bas de la fenêtre). Une fenêtre **Vérifier** s’ouvre.
1. Dans la fenêtre **Vérifier**, sélectionnez **Ajouter des autorisations** (en bas de la fenêtre).
1. Sur la page **Summary** (Récapitulatif), confirmez que la politique IVS a été ajoutée.
# Étape 4 : créer un canal avec une option d'enregistrement facultative
Un canal Amazon IVS stocke les informations de configuration relatives à votre flux en direct. Une fois le canal créé, vous pouvez y ajouter une vidéo à l'aide de la touche de diffusion et démarrer votre flux en direct.
Lors de la création d’un canal, les éléments suivants sont attribués :
+ Un *serveur d'ingestion* identifie un composant Amazon IVS spécifique qui reçoit le flux, ainsi qu'un protocole d'ingestion (RTMPS ou RTMP).
+ Amazon IVS attribue une *clé de flux* lorsque vous créez un canal et l’utilisez pour le streaming. ***Traitez la clé de flux comme un secret, car elle permet à n’importe qui de diffuser sur le canal***.
+ Une *URL de lecture* identifie le point de terminaison pour démarrer la lecture d'un canal spécifique. Ce point de terminaison peut être utilisé à l'échelle mondiale. Il sélectionne automatiquement le meilleur emplacement sur le réseau mondial de diffusion de contenu Amazon IVS pour qu'un utilisateur puisse diffuser la vidéo. (Remarque : Amazon IVS ne prend pas en charge les domaines personnalisés pour la lecture. *N'utilisez pas de proxy pour l'URL de lecture avec votre propre domaine ; en plus de ne pas fonctionner, cela pourrait entraîner des problèmes.*)
Vous pouvez créer un canal, avec ou sans enregistrement, via la console Amazon IVS ou AWS CLI. La création et l'enregistrement des canaux sont discutés ci-dessous.
# Enregistrement automatique vers Amazon S3
Vous avez la possibilité d'activer l'enregistrement pour un canal. Si la fonction d'enregistrement automatique vers S3 est activée, tous les flux sur le canal sont enregistrés et stockés dans un compartiment de stockage Amazon S3 que vous possédez. Par la suite, l'enregistrement est disponible pour la lecture à la demande.
*Cette configuration est une option avancée.* L'enregistrement est désactivé par défaut lors de la création d'un canal.
Avant de pouvoir configurer un canal pour l'enregistrement, vous devez créer une *configuration d'enregistrement*. Il s'agit d'une ressource qui spécifie un emplacement Amazon S3 où les flux enregistrés pour le canal sont stockés. Vous pouvez créer et gérer des configurations d'enregistrement à l'aide de la console ou de la CLI ; les deux procédures sont présentées ci-dessous. Une fois la configuration d'enregistrement créée, vous pouvez l'associer à un canal de deux façons : lorsque vous créez le canal (comme décrit ci-dessous) ou lorsque vous mettez à jour un canal existant. (Dans l’API, consultez [CreateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_CreateChannel.html) et [UpdateChannel](https://docs.aws.amazon.com//ivs/latest/LowLatencyAPIReference/API_UpdateChannel.html).) Vous pouvez associer plusieurs canaux avec la même configuration d’enregistrement. Vous pouvez supprimer une configuration d'enregistrement qui n'est plus associée à aucun canal.
Gardez les contraintes suivantes à l'esprit :
+ Vous devez être propriétaire du compartiment S3. Autrement dit, le compte qui configure un canal à enregistrer doit posséder le compartiment S3 où les enregistrements seront stockés.
+ Le canal, la configuration d'enregistrement et l'emplacement S3 doivent se situer dans la même région AWS. Si vous créez des canaux dans d'autres régions et souhaitez les enregistrer, vous devez également configurer des configurations d'enregistrement et des compartiments S3 dans ces régions.
L'enregistrement dans votre compartiment S3 nécessite une autorisation avec vos informations d'identification AWS. Pour donner à IVS l'accès requis, un [Rôle lié à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR) AWS IAM est créé automatiquement lors de la création de la configuration d'enregistrement : le SLR ne peut donner l'autorisation d'écriture IVS que sur le compartiment spécifique.
Notez que les problèmes de réseau entre l'emplacement de streaming et AWS, ou au sein d'AWS, peuvent entraîner une perte de données lors de l'enregistrement de votre flux. Dans ce cas, Amazon IVS accorde la priorité au flux en direct et non aux enregistrements. Pour la redondance, enregistrez localement via votre outil de streaming.
Pour plus d'informations (y compris comment configurer le post-traitement ou la lecture de VOD sur vos fichiers enregistrés), consultez [Enregistrement automatique IVS vers Amazon S3 \$1 Diffusion à faible latence](record-to-s3.md).
## Comment désactiver l’enregistrement
Pour désactiver l'enregistrement Amazon S3 sur un canal existant :
+ Console — Sur la page relative aux détails du canal, dans la section **Record and store (Enregistrer et stocker les flux)**, choisissez **Disabled (Désactivé)**, puis **Save Channel (Enregistrer le canal)**. Cette action dissocie la configuration d’enregistrement du canal ; les flux de ce canal ne seront plus enregistrés.
+ CLI : exécutez la commande `update-channel` et indiquez une chaîne vide pour l'ARN de la configuration d'enregistrement.
```
aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn ""
```
Cette action renvoie un objet de canal avec une chaîne vide pour `recordingConfigurationArn`, indiquant que l’enregistrement a été désactivé.
# Instructions de console pour la création d’un canal IVS
Ces étapes sont divisées en trois phases : configuration initiale du canal, configuration de l'enregistrement automatique vers Amazon S3 (facultatif) et création finale du canal.
## Configuration initiale du canal
1. Ouvrez la [console Amazon IVS](https://console.aws.amazon.com/ivs).
(Vous pouvez également accéder à la console Amazon IVS via la [console de gestion AWS](https://console.aws.amazon.com/).)
1. Choisissez une région dans le menu déroulant de la barre de navigation **Select a Region (Sélectionner une région)**. Le nouveau canal sera créé dans la région choisie.
1. Dans **Get started** (Mise en route) (en haut à droite), sélectionnez **Create Channel** (Créer un canal).
1. Sous **Channel configuration (Configuration du canal)**, acceptez la **Default configuration (Configuration par défaut)**. Si vous le souhaitez, vous pouvez renommer le canal dans le champ **Channel name (Nom du canal)**. Les noms de canaux ne sont pas uniques, mais permettent une distinction en plus de l’ARN (Amazon Resource Name).
Remarque : la **configuration personnalisée** peut être utilisée pour spécifier d'autres valeurs que celles par défaut, telles que le type de canal ou l'ingestion RTMP (au lieu de RTMPS). Les spécifications personnalisées ne sont pas documentées ici.
![\[Pour créer un canal à l’aide de la console IVS : spécifiez la configuration du canal dans la fenêtre Create Channel (Créer un canal).\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/LowLatencyUserGuide/images/Accept_Default_Configuration.png)
1. Si vous souhaitez enregistrer automatiquement sur Amazon S3, poursuivez avec [Configurer l'enregistrement automatique sur Amazon S3 (facultatif)](#getting-started-create-channel-console-record-s3) ci-dessous. Sinon, ignorez cette étape et passez directement à [Création finale du canal](#getting-started-create-channel-console-final-creation).
## Configurer l'enregistrement automatique sur Amazon S3 (facultatif)
Procédez comme suit pour activer l’enregistrement lors de la création d’un canal :
1. Sur la page **Créer un canal**, sous **Enregistrement et stockage des flux**, choisissez **Activer l'enregistrement automatique**. Des champs supplémentaires s’affichent pour le choix d’une **configuration d’enregistrement** existante ou pour la création d’une nouvelle.
![\[Pour créer un canal à l'aide de la console IVS : sélectionnez Auto-record to Amazon S3 (Enregistrement automatique vers Amazon S3).\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/LowLatencyUserGuide/images/Select_Auto_Record.png)
1. Choisissez **Create recording configuration** (Créer une configuration d'enregistrement). Une nouvelle fenêtre s'ouvre, avec des options permettant de créer un compartiment Amazon S3 et de le joindre à la nouvelle configuration d'enregistrement.
![\[Pour créer un canal à l’aide de la console IVS : spécifiez les options de stockage pour la configuration d’enregistrement.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/LowLatencyUserGuide/images/Click_Create_Recording_Config.png)
1. Renseignez les champs :
1. Saisissez éventuellement un **nom de configuration d’enregistrement**.
1. Sous **Configuration du canal**, acceptez la **Configuration par défaut**. Remarque : la **Configuration personnalisée** peut être utilisée pour spécifier certaines valeurs autres que celles par défaut, telles que des rendus enregistrés ou la fusion de flux fragmentés. Les spécifications personnalisées ne sont pas documentées ici.
1. Entrez un **nom de compartiment**.
1. Sélectionnez **Create recording configuration** (Créer une configuration d’enregistrement) pour créer une ressource de configuration d’enregistrement avec un ARN unique. La création d'une configuration d'enregistrement ne prend que quelques secondes, mais cela peut aller jusqu'à 20 secondes. Une fois la configuration d’enregistrement créée, vous revenez à la fenêtre **Create channel (Créer un canal)**. Vous verrez dans la zone **Enregistrer et stocker les flux** votre nouvelle **Configuration d’enregistrement** avec son **État** comme étant **Actif** et le compartiment S3 (**Stockage**) que vous avez créé.
![\[Pour créer un canal à l’aide de la console IVS : nouvelle configuration d’enregistrement créée.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/LowLatencyUserGuide/images/Create_Recording_Config.png)
## Création finale du canal
1. En bas de la fenêtre **Créer un canal**, sélectionnez **Créer un canal** pour créer un nouveau canal avec un ARN unique. Pour afficher les détails du canal, développez **Détails**. (Remarque : si vous n'avez pas activé l'option d'enregistrement, l'**enregistrement automatique vers S3** est défini sur **Désactivé** et la mention **Configuration d'enregistrement** n'apparaît pas à l'écran.)
![\[Pour créer un canal à l'aide de la console IVS : dans la fenêtre Channel Details (Détails du canal), vous pouvez voir le flux du canal, la configuration de la lecture et de l'enregistrement, ainsi que les sessions de flux.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/LowLatencyUserGuide/images/Final_Channel_Creation.png)
1. **Important**:
+ Mémorisez le **Ingest server** (Serveur d’ingestion) ainsi que la **Stream key** (Clé de flux) apparaissant dans la zone **Stream configuration** (Configuration du flux). Ils vous serviront à l'étape suivante pour configurer le streaming.
+ Dans la zone **Playback configuration (Configuration de lecture)**, mémorisez la valeur figurant dans **Playback URL (URL de lecture)**. Vous l'utiliserez plus tard pour lire votre flux.
**Remarque** : pour afficher les valeurs du SRT (point de terminaison et phrase de passe), développez **Autres options d’ingestion** dans la zone **Configuration du flux**.
# Instructions de CLI pour la création d’un canal IVS
La création d'un canal avec l'AWS CLI est une option avancée et nécessite le téléchargement et la configuration de la CLI sur votre machine. Pour plus de détails, consultez le [Guide de l’utilisateur de l’Interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
Suivez l'une des deux procédures ci-dessous en fonction de ce que vous souhaitez : créer un canal avec ou sans enregistrement.
## Créer un canal sans enregistrement
1. Exécutez la commande `create-channel` et renseignez un nom (facultatif).
```
aws ivs create-channel --name test-channel
```
1. Cela renvoie un nouveau canal.
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "none",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **Important** : notez les valeurs `ingestEndpoint`, `streamKey value` et `playbackUrl`. Elles vous seront utiles pour configurer le streaming et la lecture.
## Créer un canal avec enregistrement
**Prérequis :** avant de commencer cette procédure, créez un compartiment Amazon S3 et notez l'ARN. Consultez [Mise en route avec Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/GetStartedWithS3.html). Le compartiment S3 doit se trouver dans la même région que la configuration d'enregistrement. Prenez connaissance du problème rencontré à l'étape 1 ci-dessous.
Suivez ensuite ces étapes pour créer le canal :
1. Exécutez la commande `create-recording-configuration` et renseignez l’ARN d’un compartiment Amazon S3 existant :
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket}
```
Vous pouvez également passer le paramètre `thumbnail-configuration` pour définir manuellement le mode d’enregistrement des miniatures et l’intervalle entre les miniatures :
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60
```
Si vous le souhaitez, transmettez le paramètre `recording-reconnect-window-seconds` permettant d'activer la fonctionnalité de fusion de flux fragmentés :
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60
```
**Problème connu :** dans la région us-east-1, si vous utilisez l'AWS CLI pour créer une configuration d'enregistrement, cela fonctionne même si le compartiment S3 se trouve dans une autre région. Le cas échéant, la valeur `state` de la configuration d'enregistrement est la suivante : `CREATE_FAILED` (et non `ACTIVE`). (Dans d'autres régions, la CLI bloque l'action si le compartiment est dans une autre région.)
**Solution de contournement :** assurez-vous que votre compartiment S3 se trouve dans la même région que la configuration d'enregistrement. Si vous créez une configuration d’enregistrement dans une autre région que votre compartiment S3, supprimez-la et créez-en une nouvelle avec un compartiment S3 dans la bonne région.
1. Cette action renvoie une nouvelle configuration d’enregistrement avec un ARN unique. La configuration d’enregistrement affiche le statut « `CREATING` », ce qui signifie qu’elle est en cours de création.
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "CREATING",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. La création d’une configuration d’enregistrement ne prend que quelques secondes, mais cela peut aller jusqu’à 20 secondes. Pour vérifier que la configuration d’enregistrement a été créée, exécutez la commande `get-recording-configuration` :
```
aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. Cette action renvoie une réponse indiquant que la configuration d’enregistrement a été créée (`state` est `ACTIVE`) :
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "ACTIVE",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. Pour créer un canal et activer l’enregistrement sur ce dernier, exécutez la commande `create-channel` et indiquez l’ARN de configuration d’enregistrement :
```
aws ivs create-channel --name channel-live --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
De la même façon, pour activer l’enregistrement sur un canal existant, exécutez la commande `update-channel` et indiquez l’ARN de configuration d’enregistrement :
```
aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. Cette action renvoie un objet de canal pour `recordingConfigurationArn` avec une autre valeur que « Aucun », indiquant que l'enregistrement est activé. (La réponse ci-dessous provient de `create-channel`. La réponse `update-channel` n’inclut pas l’objet `streamKey`.)
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **Important** : notez les valeurs `ingestEndpoint`, `streamKey value` et `playbackUrl`. Elles vous seront utiles pour configurer le streaming et la lecture.
# Étape 5 : configurer le logiciel de streaming
Vous pouvez diffuser (faible latence) sur Amazon IVS avec :
+ Les [kits SDK de diffusion IVS](#broadcast-sdk) natifs, qui prennent en charge RTMPS. Nous l'avons recommandé, en particulier pour les scénarios de production.
+ La [console Amazon IVS](#ivs-console) : elle convient pour tester les flux.
+ D’autres logiciels et encodeurs matériels de diffusion : vous pouvez utiliser tout encodeur prenant en charge les protocoles RTMP, RTMPS ou SRT. Plusieurs exemples sont décrits ci-dessous, utilisant Open Broadcast Software (OBS) et FFmpeg avec RTMPS et SRT. RTMPS renforce la sécurité grâce à un flux TLS crypté.
Les paramètres clés de l’encodeur sont l’intervalle entre images clés (2 secondes) et la résolution, le débit binaire et la fréquence d’images (qui sont interdépendants). Pour plus de détails sur les paramètres de l'encodeur, consultez :
+ [Configuration du streaming](streaming-config.md) dans le *Guide de l’utilisateur Amazon IVS*.
+ Cet article de blog : [Configuration du streaming avec Amazon Interactive Video Service](https://aws.amazon.com/blogs/media/setting-up-for-streaming-with-amazon-ivs/)
**Remarques:**
+ La durée maximale des flux Amazon IVS est de 48 heures. Passé ce délai, le flux est terminé et la session de streaming déconnectée. Une reconnexion, automatique ou manuelle, démarre un nouveau flux.
+ Si votre encodeur arrête d'envoyer des données (par exemple, en raison d'un problème temporaire de réseau), Amazon IVS attend 30 secondes. En l'absence de réception de données du diffuseur pendant ce délai, Amazon IVS se déconnecte.
## Streaming avec le kit SDK de diffusion Amazon IVS
Pour diffuser à partir de vos applications iOS ou Android, vous pouvez utiliser le kit SDK de diffusion Amazon IVS. Le kit SDK de diffusion tire parti de l'architecture Amazon IVS et nous y apporterons continuellement des améliorations et de nouvelles fonctionnalités, en plus d'Amazon IVS. En tant que kit SDK de diffusion mobile natif, il est conçu pour minimiser l’impact sur les performances de votre application et sur les périphériques avec lesquels vos utilisateurs accèdent à votre application.
| Pour diffuser depuis ... | Vous pouvez utiliser … | Remarques |
| --- | --- | --- |
| Vos applications Android ou iOS | Le kit SDK de diffusion pour Amazon IVS sur Android ou iOS | En tant que kit SDK de diffusion mobile natif, il est conçu pour minimiser l’impact sur les performances de votre application et sur les périphériques avec lesquels vos utilisateurs accèdent à votre application. |
| Un environnement Web | Le kit SDK de diffusion Web pour Amazon IVS | Comme kit SDK de diffusion web, le kit SDK de diffusion Web pour Amazon IVS vous permet de diffuser à partir d'environnements web à l'aide de WebRTC. Il offre un support multinavigateur et multiplateforme. |
Pour en savoir plus, consultez [Kit SDK de diffusion IVS \$1 Diffusion à faible latence](broadcast.md).
## Streaming avec la console Amazon IVS
1. Ouvrez la [console Amazon IVS](https://console.aws.amazon.com/ivs).
(Vous pouvez également accéder à la console Amazon IVS via la [console de gestion AWS](https://console.aws.amazon.com/).)
1. Dans le panneau de navigation, choisissez **Canaux**. (Si le panneau de navigation est réduit, agrandissez-le en sélectionnant une icône en forme de hamburger.)
1. Choisissez un canal sur lequel vous souhaitez diffuser, pour accéder à sa page de détails.
1. Sélectionnez l'onglet **Diffusion**. (Les onglets se trouvent sous la section **Configuration générale**.)
1. Vous serez invité à autoriser la console IVS à accéder à votre caméra et à votre microphone ; **autorisez** ces autorisations.
1. Au bas de l'onglet **Diffusion**, utilisez les listes déroulantes pour sélectionner les périphériques d'entrée pour le microphone et la caméra.
1. Pour commencer le streaming, sélectionnez **Commencer la diffusion**.
1. Pour visionner le flux en direct, accédez à l'onglet **Lecture**.
**Remarque** : Après avoir démarré le flux, attendez-vous à un bref délai (généralement inférieur à 30 secondes) avant qu'il ne soit visible dans l'onglet Lecture.
Vous pouvez utiliser cette fonctionnalité pour diffuser simultanément sur plusieurs canaux.
**Remarque** : Le streaming depuis la console consomme des ressources et vous devrez payer des frais d'entrée vidéo en direct. Pour en savoir plus, consultez la section [Coûts d'entrée vidéo en direct](https://aws.amazon.com/ivs/pricing/#Low-Latency_Streaming) sur la page de tarification de l'IVS.
## Diffusion avec OBS Studio en utilisant RTMPS
([OBS Studio](https://obsproject.com/)) est une suite logicielle gratuite et open source pour l'enregistrement et la diffusion en direct. OBS fournit la capture en temps réel des sources et des périphériques, la composition des scènes, l'encodage, l'enregistrement et le streaming.
Suivez ces étapes pour vous mettre rapidement en jambes avec OBS Studio v30.2 ou une version ultérieure :
1. Téléchargez et installez le logiciel : [https://obsproject.com/download](https://obsproject.com/download).
1. Exécutez l'**assistant de configuration automatique** d'OBS Studio, qui apparaît lorsque vous chargez OBS Studio pour la première fois. Suivez les différentes étapes et acceptez les valeurs par défaut.
1. Dans **Informations sur le flux**, sélectionnez **Amazon IVS** dans le menu déroulant **Service** et saisissez la **clé de flux**.
Si vous avez créé le canal avec la console Amazon IVS, la **clé de flux** que vous saisissez dans OBS est la **clé de flux** de la console : `sk_us-west-2_abcd1234efgh5678ijkl`
Si vous avez créé le canal avec l’AWS CLI, la **clé de flux** que vous saisissez dans OBS est la **valeur de streamKey** de la réponse CLI `sk_us-west-2_abcd1234efgh5678ijkl`
Si votre canal IVS est configuré pour une entrée vidéo multipiste, sélectionnez **Activer la vidéo multipiste**. Vous pouvez également configurer les paramètres **Nombre maximal de pistes vidéo** et **Largeur de bande maximale de diffusion**, qui sont utilisés pour limiter les paramètres de flux configurés automatiquement.
1. Pour **Video Output Resolution** (Résolution de sortie vidéo) et **Bitrate**, référez-vous aux [Channel Types](streaming-config.md#streaming-config-settings-channel-types) (Types de canaux) dans la *Amazon IVS Streaming Configuration* (Configuration du streaming Amazon IVS). Si l'une des valeurs choisies par l'assistant OBS dépasse les valeurs autorisées par Amazon IVS, vous devez ajuster manuellement les valeurs pour éviter un échec de connexion à Amazon IVS. Une fois l'assistant terminé :
1. Pour régler la résolution vidéo, utilisez **Settings > Video > Output (Scaled) Resolution** (Paramètres > Vidéo > Résolution de sortie [mise à l'échelle]).
1. Pour régler le débit vidéo, utilisez **Settings > Output > Streaming > Video Bitrate** (Paramètres > Sortie > Streaming > Débit vidéo).
**Remarque** : cela n’affecte pas le flux en direct si vous avez précédemment coché l’option **Activer la vidéo multipiste**.
1. Nous recommandons une durée de 2 secondes pour **Keyframe Interval** (Intervalle entre images clés) pour améliorer la stabilité du flux et éviter la mise en mémoire tampon dans la lecture de la visionneuse. À la fin de l’assistant, accédez à **Paramètres > Sortie > Mode de sortie**, sélectionnez **Avancé**, et sur l’onglet **Diffusion**, assurez-vous que **Intervalle entre images clés** est 2.
**Remarque** : l’intervalle entre les images clés est configuré automatiquement si vous avez coché l’option **Activer la vidéo multipiste**.
1. Dans la fenêtre principale d’OBS Studio, choisissez **Start Streaming** (Démarrer le streaming).
Pour en savoir plus sur le streaming via OBS Studio, consultez le [Guide de démarrage rapide d’OBS Studio](https://obsproject.com/wiki/OBS-Studio-Quickstart).
Vous pouvez modifier manuellement vos paramètres OBS :
1. Choisissez **Settings > Stream (Paramètres > Diffuser en direct)**.
1. Sélectionnez **Amazon IVS** dans la liste déroulante.
1. Collez la **clé de flux**.
Vous pouvez réexécuter l'assistant à tout moment : choisissez **Tools > Auto-Configuration Wizard (Outils > Assistant de configuration automatique)**.
Vous pouvez activer l’enregistrement local dans **Settings > General** (Paramètres > Général) si vous souhaitez enregistrer votre diffusion en direct pour une utilisation ultérieure. Comme mentionné précédemment, des problèmes de réseau entre l'emplacement de diffusion et AWS, ou au sein d'AWS, peuvent entraîner une perte de données lors de l'enregistrement de votre flux. Dans ce cas, Amazon IVS accorde la priorité au flux en direct et non aux enregistrements. L'enregistrement local via votre outil de streaming assure la redondance.
Il est conseillé de vérifier régulièrement les mises à jour d’OBS Studio et de passer à la dernière version. Par exemple, si vous obtenez une erreur « Failed to connect to server » (Échec de la connexion au serveur), il est possible que vous utilisiez une ancienne version d'OBS Studio ne prenant pas en charge RTMPS.
## Diffusion avec OBS Studio en utilisant SRT
Suivez ces étapes pour démarrer rapidement avec le protocole Secure Reliable Transport :
1. Téléchargez et installez le logiciel : [https://obsproject.com/download](https://obsproject.com/download).
1. Exécutez l'**assistant de configuration automatique** d'OBS Studio, qui apparaît lorsque vous chargez OBS Studio pour la première fois. Suivez les différentes étapes et acceptez les valeurs par défaut.
1. Pour **Stream Information** (Informations de flux), choisissez **Custom...** (Personnalisé...) à partir du menu déroulant **Service** et saisissez le **Server (Ingest server)** (Serveur [serveur d'ingestion]) et la **Stream Key** (Clé de flux).
Si vous avez créé le canal avec l'AWS CLI :
+ Le **serveur** que vous saisissez dans OBS est une combinaison de cinq éléments :
+ Un protocole d'ingestion : `srt://`
+ Le **point de terminaison** de la struct `srt` dans la réponse CLI :
`a1b2c3d4e5f6.srt.live-video.net`
+ Un port : `9000`
+ Un streamid, qui est la **valeur de streamKey** de la réponse CLI :
`sk_us-west-2_abcd1234efgh5678ijkl`
+ Une phrase de passe, utilisée pour chiffrer le contenu. N’utilisez cette valeur que si l’**ingestion non sécurisée** n’est pas activée.
`ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ`
L’entrée complète est la suivante :
`srt://a1b2c3d4e5f6.srt.live-video.net:9000?streamid=sk_us-west-2_abcd1234efgh5678ijkl&passphrase=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ`
+ La **clé de flux** que vous saisissez dans OBS restera vide pour le protocole SRT.
1. Pour **Video Output Resolution** (Résolution de sortie vidéo) et **Bitrate**, référez-vous aux [Channel Types](streaming-config.md#streaming-config-settings-channel-types) (Types de canaux) dans la *Amazon IVS Streaming Configuration* (Configuration du streaming Amazon IVS). Si l'une des valeurs choisies par l'assistant OBS dépasse les valeurs autorisées par Amazon IVS, vous devez ajuster manuellement les valeurs pour éviter un échec de connexion à Amazon IVS. Une fois l'assistant terminé :
1. Pour régler la résolution vidéo, utilisez **Settings > Video > Output (Scaled) Resolution** (Paramètres > Vidéo > Résolution de sortie [mise à l'échelle]).
1. Pour régler le débit vidéo, utilisez **Settings > Output > Streaming > Video Bitrate** (Paramètres > Sortie > Streaming > Débit vidéo).
1. Nous recommandons une durée de 2 secondes pour **Keyframe Interval** (Intervalle entre images clés) pour améliorer la stabilité du flux et éviter la mise en mémoire tampon dans la lecture de la visionneuse. À la fin de l’assistant, accédez à **Paramètres > Sortie > Mode de sortie**, sélectionnez **Avancé**, et sur l’onglet **Diffusion**, assurez-vous que **Intervalle entre images clés** est 2.
1. Dans la fenêtre principale d’OBS Studio, choisissez **Start Streaming** (Démarrer le streaming).
Vous pouvez modifier manuellement vos paramètres OBS :
1. Choisissez **Settings > Stream (Paramètres > Diffuser en direct)**.
1. Choisissez l’option **Custom** (Personnalisé) dans le menu déroulant.
1. Collez le **serveur** et/ou la **clé de flux**.
Vous pouvez réexécuter l'assistant à tout moment : choisissez **Tools > Auto-Configuration Wizard (Outils > Assistant de configuration automatique)**.
Vous pouvez activer l’enregistrement local dans **Settings > General** (Paramètres > Général) si vous souhaitez enregistrer votre diffusion en direct pour une utilisation ultérieure. Comme mentionné précédemment, des problèmes de réseau entre l'emplacement de diffusion et AWS, ou au sein d'AWS, peuvent entraîner une perte de données lors de l'enregistrement de votre flux. Dans ce cas, Amazon IVS accorde la priorité au flux en direct et non aux enregistrements. L'enregistrement local via votre outil de streaming assure la redondance.
Il est conseillé de vérifier régulièrement les mises à jour d’OBS Studio et de passer à la dernière version. (Par exemple, si vous obtenez une erreur « Échec de la connexion au serveur », il est possible que vous utilisiez une ancienne version d’OBS Studio ne prenant pas en charge RTMPS.)
## Diffusion d’une vidéo enregistrée avec FFmpeg en utilisant RTMPS
Procédez comme suit :
1. Téléchargez et installez FFmpeg : [https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html).
1. Dans `$VIDEO_FILEPATH`, saisissez l'emplacement d'une vidéo MP4 :
```
VIDEO_FILEPATH=/home/test/my_video.mp4
```
1. Dans `STREAM_KEY`, entrez la **valeur** de la clé de flux :
```
STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl
```
1. Dans `INGEST_ENDPOINT`, entrez votre **ingestEndpoint** (à partir de l'AWS CLI) :
```
INGEST_ENDPOINT=a1b2c3d4e5f6.global-contribute.live-video.net
```
1. Commencez le streaming avec la commande de terminal suivante (il s'agit d'une ligne entière) :
```
ffmpeg -re -stream_loop -1 -i $VIDEO_FILEPATH -r 30 -c:v libx264 -pix_fmt yuv420p -profile:v main -preset veryfast -x264opts "nal-hrd=cbr:no-scenecut" -minrate 3000 -maxrate 3000 -g 60 -c:a aac -b:a 160k -ac 2 -ar 44100 -f flv rtmps://$INGEST_ENDPOINT:443/app/$STREAM_KEY
```
*La commande ci-dessus est un exemple. Pour le streaming, réglez les paramètres en fonction de vos besoins.*
## Diffusion d’une vidéo enregistrée avec FFmpeg en utilisant SRT
1. Téléchargez et installez FFmpeg : [https://www.ffmpeg.org/download.html](https://www.ffmpeg.org/download.html). Si vous utilisez une version ancienne/compilée de FFmpeg, compilez une nouvelle version avec l’option `--enable-libsrt`.
1. Vérifiez que SRT est disponible dans FFmpeg : exécutez la commande suivante et assurez-vous que `libsrt` est dans la sortie. Si `libsrt` n’est pas présent, recompilez ou obtenez une version plus récente de FFmpeg qui prend en charge SRT.
```
ffmpeg -version | grep enable-libsrt
```
1. Dans `$VIDEO_FILEPATH`, saisissez l'emplacement d'une vidéo MP4 :
```
VIDEO_FILEPATH=/home/test/my_video.mp4
```
1. Dans `STREAM_KEY`, entrez la **valeur** de la clé de flux :
```
STREAM_KEY=sk_us-west-2_abcd1234efgh5678ijkl
```
1. Définissez `INGEST_ENDPOINT` sur votre **point de terminaison** (à partir de l’AWS CLI sous l’objet `srt`) :
```
INGEST_ENDPOINT=a1b2c3d4e5f6.srt.live-video.net
```
1. Définissez `PASSPHRASE` sur votre **phrase de passe** (à partir de l’AWS CLI sous l’objet `srt`). N’utilisez la phrase de passe que si l’ingestion non sécurisée n’est pas activée pour le canal.
```
PASSPHRASE=ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ
```
1. Commencez le streaming avec la commande de terminal suivante (il s'agit d'une ligne entière) :
```
ffmpeg -re -i $VIDEO_FILEPATH -c copy -f mpegts "srt://$INGEST_ENDPOINT:9000?streamid=$STREAM_KEY&passphrase=$PASSPHRASE”
```
# Étape 6 : voir votre diffusion en direct
Vous pouvez visionner votre flux en direct avec :
+ Les [kits SDK natifs du lecteur IVS](#view-stream-player-sdks).
+ La [console Amazon IVS](#view-stream-console).
## Visionnage avec les kits SDK du lecteur Amazon IVS
1. Configurez le lecteur IVS. Commencez par la [présentation du kit SDK du lecteur IVS](player.md), puis lisez le(s) guide(s) du lecteur spécifique(s) à la plateforme appropriée.
1. Dans la [console Amazon IVS](https://console.aws.amazon.com/ivs), récupérez l’**URL de lecture** générée lors de la création de votre canal. (Consultez [Création finale d’un canal](create-channel-console.md#getting-started-create-channel-console-final-creation) plus haut dans ce *guide de démarrage*.)
1. Appelez `player.load()` avec l’URL de lecture.
## Visionnage avec la console Amazon IVS
1. Ouvrez la [console Amazon IVS](https://console.aws.amazon.com/ivs).
(Vous pouvez également accéder à la console Amazon IVS via la [console de gestion AWS](https://console.aws.amazon.com/).)
1. Dans la console de navigation, choisissez **Live channels** (Canaux en direct). (Si le volet de navigation est réduit, ouvrez-le d'abord en choisissant l'icône en forme de hamburger.)
1. Choisissez le canal dont vous souhaitez afficher le flux. Cela ouvrira une page avec toutes les informations le concernant.
Le flux en direct est en cours de lecture dans la section **Live stream** (Flux en direct) de la page.
**Remarque** : La lecture depuis la console consomme des ressources et vous devrez payer des frais de sortie vidéo en direct. Pour en savoir plus, consultez la section [Coûts de sortie vidéo en direct](https://aws.amazon.com/ivs/pricing/#Live_Video_Output_Costs) sur la page de tarification de l'IVS.
**Remarque :** une fois le streaming lancé, le flux ne sera pas visible dans la console avant quelques secondes (jusqu’à 30 secondes).
# Étape 7 : vérifiez vos limites Service Quotas (facultatif)
Les comptes ont un nombre limite de diffusions et d’utilisateur simultanés. *Assurez-vous de définir des limites adéquates et augmentez-les si nécessaire, surtout si vous prévoyez un événement de streaming à large échelle*. Consultez la section [Service Quotas IVS](service-quotas.md).
# Étape 8 : Empêcher le contenu et les spectateurs indésirables (recommandé)
Des utilisateurs malveillants peuvent tenter de rediffuser des contenus indésirables (par exemple, du sport professionnel) sur votre plateforme ou d’intégrer les flux de votre plateforme sur un autre site Web sans en avoir l’autorisation. Ce type de streaming peut considérablement augmenter la quantité de vidéos diffusées en direct par votre application, ainsi que les coûts qui y sont associés, sans apporter de valeur ajoutée à votre entreprise. En plus de vous fournir des contrôles pour arrêter les flux actifs, Amazon IVS fournit des ressources pour aider à détecter et à prévenir ce type de comportement ; consultez la section [Contenu indésirable et spectateurs dans IVS](undesired-content.md).
Pour limiter la lecture à des origines et/ou des pays spécifiques, utilisez une politique de restriction de lecture. Notez que ces politiques ne peuvent être utilisées qu'avec les canaux publics. [Contenu et utilisateurs indésirables dans IVS](undesired-content.md) aborde également l'utilisation de canaux privés pour contrôler le contenu indésirable.
Notez que les politiques de restriction de lecture (les restrictions géographiques, par exemple) ne peuvent pas être utilisées simultanément avec l’autorisation de lecture. Si l’autorisation de lecture est activée pour une chaîne, toutes les politiques de restriction de lecture configurées seront ignorées. Pour appliquer des restrictions géographiques sur une chaîne privée, validez l’emplacement de l’utilisateur dans votre logique de génération de jetons avant d’émettre un jeton de lecture.