# Enregistrement composite IVS \$1 Diffusion en temps réel
Ce document explique comment utiliser la fonction d’enregistrement composite dans un [montage côté serveur.](server-side-composition.md) L’enregistrement composite vous permet de générer des enregistrements HLS d’une scène IVS. Pour ce faire, il combine efficacement tous les diffuseurs de publication en une seule vue à l’aide d’un serveur IVS, puis enregistre la vidéo obtenue dans un compartiment S3.
Les coûts de stockage et de demande S3 standard s'appliquent. Les miniatures n'entraînent aucun frais IVS supplémentaire. Pour en savoir plus, consultez la [Tarification Amazon IVS](https://aws.amazon.com/ivs/pricing/).
## Conditions préalables
Pour utiliser l’enregistrement composite, vous devez disposer d’une scène avec des diffuseurs de publication actifs ainsi que d’un compartiment S3 comme destination d’enregistrement. Vous trouverez ci-dessous un flux de travail possible qui utilise les événements EventBridge pour enregistrer un montage dans un compartiment S3. Vous pouvez également démarrer et arrêter des montages en fonction de la logique de votre propre application.
1. Créez une [scène IVS](getting-started-create-stage.md) et des jetons de participation pour chaque diffuseur de publication.
1. Créez une configuration [EncoderConfiguration](https://docs.aws.amazon.com/ivs/latest/RealTimeAPIReference/API_CreateEncoderConfiguration.html) (un objet représentant la manière dont la vidéo enregistrée doit être rendue).
1. Créez un [compartiment S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) et une configuration [StorageConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStorageConfiguration.html) (emplacement où le contenu de l’enregistrement sera stocké).
**Important** : si vous utilisez un compartiment S3 existant, le paramètre **Propriété de l’objet** doit être **appliqué par le propriétaire du compartiment** ou **préféré par le propriétaire du compartiment**. Pour plus de détails, consultez la documentation S3 sur le [contrôle de la propriété des objets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html).
1. [Joignez-vous à la scène et diffusez dessus](getting-started-pub-sub.md).
1. Lorsque vous recevez un [événement EventBridge](eventbridge.md) diffusé par un participant, appelez [StartComposition](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_StartComposition.html) avec un objet S3 DestinationConfiguration comme destination
1. Au bout de quelques secondes, vous devriez être en mesure de voir que les segments HLS sont conservés dans vos compartiments S3.
![\[Enregistrer une scène dans un compartiment S3 à l’aide d’un montage côté serveur.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/images/Composite_Recording_Workflow.png)
**Remarque** : un montage s’arrête automatiquement après 60 secondes d’inactivité de la part du diffuseur de publication participant à la scène. À ce stade, le montage prend fin et passe à un état `STOPPED`. Un montage est automatiquement supprimé après quelques minutes passées dans l’état `STOPPED`. Pour plus de détails, consultez la section [Cycle de vie des montages](ssc-overview.md#ssc-composition-endpoint) dans *Montage côté serveur*.
## Exemple d’enregistrement composite : StartComposition avec une destination de compartiment S3
L’exemple ci-dessous montre un appel typique à l’opération [StartComposition](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_StartComposition.html), spécifiant S3 comme seule destination pour le montage. Une fois que le montage passe à un état `ACTIVE`, les segments vidéo et les métadonnées commencent à être écrits dans le compartiment S3 spécifié par l’objet `storageConfiguration`. Pour créer des montages avec différentes mises en page, consultez la rubrique « Mises en page » de la section [Montage côté serveur](ssc-overview.md#ssc-api-layouts) ainsi que la [Référence de l’API de diffusion en temps réel IVS](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_LayoutConfiguration.html).
### Demande
```
POST /StartComposition HTTP/1.1
Content-type: application/json
{
"destinations": [
{
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:ap-northeast-1:927810967299:encoder-configuration/PAAwglkRtjge"
],
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:927810967299:storage-configuration/ZBcEbgbE24Cq",
"thumbnailConfigurations": [
{
"storage": ["LATEST", "SEQUENTIAL"],
"targetIntervalSeconds": 30
}
]
}
}
],
"idempotencyToken": "db1i782f1g9",
"stageArn": "arn:aws:ivs:ap-northeast-1:927810967299:stage/WyGkzNFGwiwr"
}
```
### Réponse
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:927810967299:composition/s2AdaGUbvQgp",
"destinations": [
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:ap-northeast-1:927810967299:encoder-configuration/PAAwglkRtjge"
],
"recordingConfiguration": {
"format": "HLS"
},
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:927810967299:storage-configuration/ZBcEbgbE24Cq",
"thumbnailConfigurations": [
{
"storage": ["LATEST", "SEQUENTIAL"],
"targetIntervalSeconds": 30
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "MNALAcH9j2EJ/s2AdaGUbvQgp/2pBRKrNgX1ff/composite"
}
},
"id": "2pBRKrNgX1ff",
"state": "STARTING"
}
],
"layout": null,
"stageArn": "arn:aws:ivs:ap-northeast-1:927810967299:stage/WyGkzNFGwiwr",
"startTime": "2023-11-01T06:25:37Z",
"state": "STARTING",
"tags": {}
}
}
```
Le champ `recordingPrefix`, présent dans la réponse StartComposition, peut être utilisé pour déterminer l’emplacement où le contenu de l’enregistrement sera stocké.
## Enregistrer des contenus
Lorsque le montage passe à un état `ACTIVE`, les segments vidéo HLS, les fichiers de métadonnées et les miniatures (si configurées) commenceront à être écrits dans le compartiment S3 spécifié lors de l'appel de StartComposition. Ce contenu est disponible pour le post-traitement ou la lecture en tant que vidéo à la demande.
Notez qu’une fois qu’un montage est mis en ligne, un événement « IVS Composition State Change » est émis et cela peut prendre un peu de temps avant que les fichiers manifestes, les segments vidéo et les miniatures ne soient écrits. Nous vous recommandons de ne lire ou de ne traiter les flux enregistrés qu’après réception de l’événement « Changement d’état du montage IVS (fin de session) ». Pour plus de détails, consultez [Utilisation d’Amazon EventBridge avec le streaming en temps réel IVS](eventbridge.md).
Voici un exemple de structure de répertoire et de contenu d’un enregistrement d’une session IVS en direct :
```
MNALAcH9j2EJ/s2AdaGUbvQgp/2pBRKrNgX1ff/composite
events
recording-started.json
recording-ended.json
media
hls
thumbnails
latest_thumbnail
```
Le dossier `events` contient les fichiers de métadonnées correspondant à l’événement d’enregistrement. Les fichiers de métadonnées JSON sont générés lorsque l’enregistrement démarre, se termine avec succès ou se termine avec des échecs :
+ `events/recording-started.json`
+ `events/recording-ended.json`
+ `events/recording-failed.json`
Un fichier `events` contiendra `recording-started.json` et `recording-ended.json` ou `recording-failed.json`.
Ceux-ci contiennent des métadonnées relatives à la session enregistrée et à ses formats de sortie. Les détails JSON sont fournis ci-dessous.
Le dossier `media` contient le contenu multimédia pris en charge. Le sous-dossier `hls` contient tous les fichiers multimédia et manifestes générés au cours de la session de montage et est lisible avec le lecteur Amazon IVS. Le manifeste HLS se trouve dans le dossier `multivariant.m3u8`. S'ils sont configurés, les sous-dossiers `thumbnails` et `latest_thumbnail` contiennent des fichiers multimédias miniatures JPEG générés au cours de la session de composition.
## Politique de compartiment pour la configuration du stockage
Lorsqu’un objet StorageConfiguration est créé, IVS disposera de l’accès nécessaire pour écrire du contenu dans le compartiment S3 spécifié. Cet accès est accordé en apportant des modifications à la politique du compartiment S3. *Si la politique du compartiment est modifiée de manière à supprimer l’accès d’IVS, les enregistrements en cours et les nouveaux enregistrements échoueront.*
L’exemple ci-dessous montre une politique de compartiment S3 qui permet à IVS d’écrire dans le compartiment S3 :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CompositeWrite-y1d212y",
"Effect": "Allow",
"Principal": {
"Service": "ivs-composite.ap-northeast-1.amazonaws.com"
},
"Action": [
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": "arn:aws:s3:::my-s3-bucket/*",
"Condition": {
"StringEquals": {
"s3:x-amz-acl": "bucket-owner-full-control"
},
"Bool": {
"aws:SecureTransport": "true"
}
}
}
]
}
```
------
## Fichiers de métadonnées JSON
Ces métadonnées sont au format JSON. Il contient les informations suivantes :
| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `stage_arn` | chaîne | Oui | ARN de la scène utilisée comme source du montage. |
| `media` | objet | Oui | Objet contenant les objets énumérés du contenu multimédia disponibles pour cet enregistrement. Valeurs valides : `"hls"`. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | objet | Oui | Champ énuméré qui décrit la sortie du format Apple HLS. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | entier | Conditionnel | Durée du contenu HLS enregistré en millisecondes. Celle-ci n’est disponible que lorsque `recording_status` est `"RECORDING_ENDED"` ou `"RECORDING_ENDED_WITH_FAILURE"`. Si un échec s’est produit avant l’enregistrement, la valeur est 0. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Chemin relatif depuis le préfixe S3 où le contenu HLS est stocké. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Nom du fichier de la liste de lecture principale HLS. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | objet | Oui | Tableau des rendus (variante HLS) d’objets de métadonnées. Il y a toujours au moins un rendu. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Chemin relatif depuis le préfixe S3 où le contenu HLS est stocké pour ce rendu. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Nom du fichier de la liste de lecture des médias pour ce rendu. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | ent | Conditionnel | Hauteur de résolution en pixels de la vidéo encodée. Cette option n’est disponible que lorsque le rendu contient une piste vidéo. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | ent | Conditionnel | Largeur de résolution en pixels de la vidéo encodée. Cette option n’est disponible que lorsque le rendu contient une piste vidéo. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | objet | Conditionnel | Champ énuméré qui décrit la sortie des miniatures. Ce champ n’est disponible que lorsque le champ `storage` de la configuration des miniatures comprend `SEQUENTIAL` |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Chemin relatif depuis le préfixe S3 où le contenu des miniatures séquentielles est stocké. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | objet | Oui | Tableau des résolutions (variantes de miniatures) d’objets de métadonnées. Il y a toujours au moins une résolution. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Chemin relatif depuis le préfixe S3 où le contenu des miniatures est stocké pour cette résolution. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Oui | Hauteur de résolution en pixels des miniatures. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Oui | Largeur de résolution en pixels des miniatures. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | objet | Conditionnel | Champ énuméré qui décrit la sortie des miniatures. Ce champ n’est disponible que lorsque le champ `storage` de la configuration des miniatures comprend `LATEST`. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Chemin relatif depuis le préfixe S3 où est stocké `latest_thumbnail`. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | objet | Oui | Tableau des résolutions (variantes de miniatures) d’objets de métadonnées. Il y a toujours au moins une résolution. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | chaîne | Oui | Chemin relatif depuis le préfixe S3 où la dernière miniature est stockée pour cette résolution. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Oui | Hauteur de résolution en pixels de la dernière miniature. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Oui | Largeur de résolution en pixels de la dernière miniature. |
| `recording_ended_at` | chaîne | Conditionnel | Horodatage RFC 3339 UTC à la fin de l’enregistrement. Disponible uniquement lorsque `recording_status` est `"RECORDING_ENDED"` ou `"RECORDING_ENDED_WITH_FAILURE"`. `recording_started_at` et `recording_ended_at` sont des horodatages lorsque ces événements sont générés et peuvent ne pas correspondre exactement aux horodatages du segment vidéo HLS. Pour déterminer avec précision la durée d’un enregistrement, utilisez le champ `duration_ms`. |
| `recording_started_at` | chaîne | Conditionnel | Horodatage RFC 3339 UTC lorsque l’enregistrement a démarré. Ceci n’est pas disponible quand `recording_status` est à l’état `RECORDING_START_FAILED`. Veuillez lire la note ci-dessus relative à `recording_ended_at`. |
| `recording_status` | chaîne | Oui | Statut de l’enregistrement. Valeurs valides: `"RECORDING_STARTED"`, `"RECORDING_ENDED"`, `"RECORDING_START_FAILED"`, `"RECORDING_ENDED_WITH_FAILURE"`. |
| `recording_status_message` | chaîne | Conditionnel | Informations descriptives sur le statut. Disponible uniquement lorsque `recording_status` est `"RECORDING_ENDED"` ou `"RECORDING_ENDED_WITH_FAILURE"`. |
| `version` | chaîne | Oui | Version du schéma des métadonnées. |
### Exemple : recording-started.json
```
{
"version": "v1",
"stage_arn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/aAbBcCdDeE12",
"recording_started_at": "2023-11-01T06:01:36Z",
"recording_status": "RECORDING_STARTED",
"media": {
"hls": {
"path": "media/hls",
"playlist": "multivariant.m3u8",
"renditions": [
{
"path": "720p30-abcdeABCDE12",
"playlist": "playlist.m3u8",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"thumbnails": {
"path": "media/thumbnails",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"latest_thumbnail": {
"path": "media/latest_thumbnail",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
}
}
}
```
### Exemple : recording-ended.json
```
{
"version": "v1",
"stage_arn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/aAbBcCdDeE12",
"recording_started_at": "2023-10-27T17:00:44Z",
"recording_ended_at": "2023-10-27T17:08:24Z",
"recording_status": "RECORDING_ENDED",
"media": {
"hls": {
"duration_ms": 460315,
"path": "media/hls",
"playlist": "multivariant.m3u8",
"renditions": [
{
"path": "720p30-abcdeABCDE12",
"playlist": "playlist.m3u8",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"thumbnails": {
"path": "media/thumbnails",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"latest_thumbnail": {
"path": "media/latest_thumbnail",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
}
}
}
```
### Exemple : recording-failed.json
```
{
"version": "v1",
"stage_arn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/aAbBcCdDeE12",
"recording_started_at": "2023-10-27T17:00:44Z",
"recording_ended_at": "2023-10-27T17:08:24Z",
"recording_status": "RECORDING_ENDED_WITH_FAILURE",
"media": {
"hls": {
"duration_ms": 460315,
"path": "media/hls",
"playlist": "multivariant.m3u8",
"renditions": [
{
"path": "720p30-abcdeABCDE12",
"playlist": "playlist.m3u8",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"thumbnails": {
"path": "media/thumbnails",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"latest_thumbnail": {
"path": "media/latest_thumbnail",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
}
}
}
```
## Lecture de contenu enregistré à partir de compartiments privés
Par défaut, le contenu enregistré est privé ; par conséquent, ces objets sont inaccessibles à la lecture à l’aide de l’URL directe S3. Si vous essayez d’ouvrir la liste de lecture multivariée HLS (fichier m3u8) pour la lecture à l’aide du lecteur IVS ou d’un autre lecteur, vous obtiendrez une erreur (par exemple, « Vous n’avez pas l’autorisation d’accéder à la ressource demandée »). Au lieu de cela, vous pouvez lire ces fichiers avec le CDN (réseau de diffusion de contenu) Amazon CloudFront.
Les distributions CloudFront peuvent être configurées pour diffuser du contenu à partir de compartiments privés. Généralement, il est préférable d’utiliser cette configuration plutôt que d’avoir des compartiments ouvertement accessibles où les lectures contournent les contrôles proposés par CloudFront. Votre pouvez configurer votre distribution pour diffuser à partir d’un compartiment privé en créant un contrôle d’accès d’origine (OAC), qui est un utilisateur CloudFront spécial qui dispose d’autorisations de lecture sur le compartiment d’origine privé. Vous pouvez créer l’OAC après avoir créé votre distribution, via la console ou l’API CloudFront. Consultez la section [Créer un nouveau contrôle d’accès à l’origine](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html#create-oac-overview-s3) dans le *Guide du développeur Amazon CloudFront*.
### Configurer la lecture à l’aide de CloudFront avec CORS activé
Cet exemple explique comment un développeur peut configurer une distribution CloudFront avec CORS activé ; cela permet de lire ses enregistrements depuis n’importe quel domaine. Cela est particulièrement utile pendant la phase de développement. N’hésitez pas à modifier l’exemple ci-dessous pour l’adapter à vos besoins de production.
#### Étape 1 : Créer un compartiment S3
Créez un compartiment S3 qui sera utilisé pour stocker les enregistrements. Notez que le compartiment doit se trouver dans la même région que celle que vous utilisez pour votre flux de travail IVS.
Ajouter une poilitque d’autorisation CORS au compartiment :
1. Dans la console AWS, accédez à l’onglet **Autorisations du compartiment S3**.
1. Copiez la stratégie CORS ci-dessous et collez-la sous ** Partage de ressources inter-origines (CORS)**. Cela permettra d’activer l’accès CORS sur le compartiment S3.
```
[
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"PUT",
"POST",
"DELETE",
"GET"
],
"AllowedOrigins": [
"*"
],
"ExposeHeaders": [
"x-amz-server-side-encryption",
"x-amz-request-id",
"x-amz-id-2"
]
}
]
```
#### Étape 2 : Créer une distribution CloudFront
Consultez la section [Créer d’une distribution CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) dans le *Guide du développeur CloudFront*.
Dans la console AWS, entrez les informations suivantes :
| Pour ce champ … | Choisissez ceci... |
| --- | --- |
| Domaine de l’origine | Compartiment S3 que vous avez créé à l’étape précédente |
| Accès à l’origine | Paramètres de contrôle d’accès à l’origine (recommandés) |
| Comportement du cache par défaut : politique de protocole du visualiseur | Redirect HTTP to HTTPS |
| Comportement du cache par défaut : méthodes HTTP autorisées | GET, HEAD et OPTIONS |
| Comportement de cache par défaut : clé de cache et demandes d’origine | Politique de désactivation de la mise en cache |
| Comportement du cache par défaut : politique de demande d’origine | CORS-S3Origin |
| Comportement du cache par défaut : politique des en-têtes de réponse | SimpleCORS |
| Pare-feu d’application Web | Activez les protections de sécurité |
Enregistrez ensuite la distribution CloudFront.
#### Étape 3 : Configurer la stratégie de compartiment S3
1. Supprimez toute configuration de stockage que vous avez configurée pour le compartiment S3. Cela supprimera toutes les politiques de compartiment qui ont été automatiquement ajoutées au moment de la création de la politique pour ce compartiment.
1. Accédez à votre distribution CloudFront, assurez-vous que tous les champs de distribution sont dans les états définis à l’étape précédente, puis **copiez la politique de compartiment** en utilisant le bouton **Copier la politique**.
1. Accédez à votre compartiment S3. Dans l’onglet **Autorisations**, sélectionnez **Modifier la politique de compartiment** puis collez la politique de compartiment que vous avez copiée à l’étape précédente. Lors de cette étape, la politique de compartiment doit être exclusivement basée sur la politique CloudFront.
1. Créez une configuration de stockage en spécifiant le compartiment S3.
Une fois la configuration de stockage créée, vous verrez deux éléments dans la politique du compartiment S3 : l’un permet à CloudFront de lire le contenu, et l’autre autorise IVS à écrire du contenu. Un exemple de politique de compartiment final avec accès CloudFront et IVS est présenté dans [Exemple : politique de compartiment S3 avec CloudFront et IVS Access](#comp-rec-playback-example).
#### Étape 4 : Lire des enregistrements
Après avoir correctement configuré la distribution CloudFront et mis à jour la politique de compartiment, vous devriez pouvoir lire les enregistrements à l’aide du lecteur IVS :
1. Démarrez correctement un montage et assurez-vous qu’un enregistrement est stocké dans le compartiment S3.
1. Après avoir suivi les étapes 1 à 3 de cet exemple, les fichiers vidéo devraient être disponibles pour consommation via l’URL CloudFront. Votre URL CloudFront est le **Nom de domaine de distribution** sur l’onglet **Détails** dans la console Amazon CloudFront. Elle doit ressembler à ceci :
`a1b23cdef4ghij.cloudfront.net`
1. Pour lire la vidéo enregistrée via la distribution CloudFront, recherchez la clé d’objet de votre fichier `multivariant.m3u8` dans le compartiment S3. Elle doit ressembler à ceci :
`FDew6Szq5iTt/9NIpWJHj0wPT/fjFKbylPb3k4/composite/media/hls/multivariant.m3u8`
1. Ajoutez la clé d’objet à la fin de votre URL CloudFront. Votre URL finale ressemblera à ce qui suit :
`https://a1b23cdef4ghij.cloudfront.net/FDew6Szq5iTt/9NIpWJHj0wPT/fjFKbylPb3k4/composite/media/hls/multivariant.m3u8`
1. Vous pouvez désormais ajouter l’URL finale à l’attribut source d’un lecteur IVS pour visionner l’enregistrement complet. Pour visionner la vidéo enregistrée, vous pouvez utiliser la démonstration fournie dans la section [Démarrer](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/web-getting-started.html) du *Guide Web : SDK du lecteur IVS*.
### Exemple : politique de compartiment S3 avec CloudFront et IVS Access
L’extrait ci-dessous illustre une politique de compartiment S3 qui permet à CloudFront de lire du contenu dans le compartiment privé, et à IVS d’écrire du contenu dans le compartiment. **Remarque : ne faites pas un copier/coller de l’extrait ci-dessous dans votre propre compartiment. Votre politique doit contenir les identifiants qui correspondent à votre distribution CloudFront et à votre configuration de stockage.**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CompositeWrite-7eiKaIGkC9DO",
"Effect": "Allow",
"Principal": {
"Service": "ivs-composite.ap-northeast-1.amazonaws.com"
},
"Action": [
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": "arn:aws:s3:::eicheane-test-1026-2-ivs-recordings/*",
"Condition": {
"StringEquals": {
"s3:x-amz-acl": "bucket-owner-full-control"
},
"Bool": {
"aws:SecureTransport": "true"
}
}
},
{
"Sid": "AllowCloudFrontServicePrincipal",
"Effect": "Allow",
"Principal": {
"Service": "cloudfront.amazonaws.com"
},
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::eicheane-test-1026-2-ivs-recordings/*",
"Condition": {
"StringEquals": {
"AWS:SourceArn": "arn:aws:cloudfront::844311324168:distribution/E1NG4YMW5MN25A"
}
}
}
]
}
```
------
## Résolution des problèmes
+ **La montage n’est pas écrit dans le compartiment S3**. Assurez-vous que le compartiment S3 et les objets StorageConfiguration sont créés et se trouvent dans la même région. Assurez-vous également qu’IVS a accès au compartiment en vérifiant votre politique de compartiment ; consultez [Politique de compartiment pour StorageConfiguration](#comp-rec-bucket-policy).
+ **Je ne trouve pas de montages lorsque j’exécute *ListCompositions* :** Les montages sont des ressources éphémères. Une fois qu’ils sont passés à un état final, ils sont automatiquement supprimés au bout de quelques minutes.
+ **Mon montage s’arrête automatiquement :** un montage s’arrête automatiquement si aucun diffuseur de publication n’est présent sur la scène pendant plus de 60 secondes.
## Problème connu
La liste de lecture multimédia écrite par enregistrement composite possède la balise `#EXT-X-PLAYLIST-TYPE:EVENT` pendant que le montage est en cours. Lorsque le montage est terminé, la balise est mise à jour vers `#EXT-X-PLAYLIST-TYPE:VOD`. Pour une expérience de lecture fluide, nous vous recommandons de n’utiliser cette liste de lecture qu’une fois le montage terminé avec succès.