# Enregistrement des participants individuels IVS \$1 Diffusion en temps réel
<a name="rt-individual-participant-recording"></a>

Ce document explique comment utiliser l'enregistrement individuel des participants avec la diffusion en temps réel IVS.

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/).

## Introduction
<a name="ind-part-rec-introduction"></a>

L’enregistrement des participants individuels permet aux clients de diffusion en temps réel IVS d’enregistrer chaque diffuseur de publication de scène IVS individuellement dans des compartiments S3. Lorsque l’enregistrement des participants individuels est activé pour une scène, le contenu du diffuseur de publication est enregistré dès qu’il commence à publier sur la scène.

**Remarque :** si vous avez besoin d’enregistrer tous les participants d’une scène dans une seule vidéo, la fonctionnalité d’enregistrement composite est plus adaptée. Consultez la section [Enregistrement](rt-recording.md) pour un résumé sur l’enregistrement du contenu de diffusion en temps réel IVS.

![\[Enregistrement de chaque diffuseur de publication dans un fichier séparé par l’enregistrement des participants individuels.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/images/Individual_Participant_Recording.png)


## Flux de travail
<a name="ind-part-rec-workflow"></a>

![\[Flux de travail pour l’enregistrement de chaque diffuseur de publication dans un fichier séparé par l’enregistrement des participants individuels.\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/images/Workflow_Participant_Recording.png)


### 1. Création d'un compartiment S3
<a name="ind-part-rec-create-s3-bucket"></a>

Vous aurez besoin d’un compartiment S3 pour écrire des vidéos à la demande (VOD). Pour plus de détails, consultez la documentation S3 sur la [création des compartiments](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html). Notez que pour l’enregistrement des participants individuels, les compartiments S3 doivent être créés dans la même région AWS que la scène IVS.

**Important** : si vous utilisez un compartiment S3 existant :
+ Le paramètre **Propriété de l’objet** doit être configuré sur **Application du propriétaire du compartiment** ou **Préférence pour le propriétaire du compartiment**.
+ Le paramètre **Chiffrement par défaut** doit être **Chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3)**.

Pour plus d’informations, 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) et la [protection des données à l’aide du chiffrement](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html).

### 2. Création d’un objet StorageConfiguration
<a name="ind-part-rec-create-storageconfig-object"></a>

Après avoir créé un compartiment, appelez l’API de diffusion en temps réel IVS pour [créer un objet StorageConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStorageConfiguration.html). Une fois la configuration de stockage créée avec succès, IVS aura l’autorisation d’écrire dans le compartiment S3 indiqué. Vous pouvez réutiliser cet objet StorageConfiguration pour plusieurs scènes.

### 3. Création d’une scène avec des jetons de participant
<a name="ind-part-rec-create-stage-with-part-tokens"></a>

Vous devez maintenant [créer une scène IVS](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStage.html) avec l’enregistrement des participants individuels activé (en configurant l’objet AutoParticipantRecordingConfiguration) et des jetons de participant pour chaque diffuseur de publication.

La requête ci-dessous crée une scène avec deux jetons de participant et l’enregistrement des participants individuels activé.

```
POST /CreateStage HTTP/1.1
Content-type: application/json

{
   "autoParticipantRecordingConfiguration": { 
      "mediaTypes": ["AUDIO_VIDEO"],
      "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/AbCdef1G2hij",
      "thumbnailConfiguration": {
         "recordingMode": "INTERVAL",
         "storage": ["LATEST", "SEQUENTIAL"],
         "targetIntervalSeconds": 60
      }
   },
   "name": "TestStage",
   "participantTokenConfigurations": [ 
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "1"
      },
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "2"
      }
   ]
}
```

### 4. Participation à la scène en tant que diffuseur de publication actif
<a name="ind-part-rec-join-stage-as-active-pub"></a>

Distribuez les jetons de participant à vos diffuseurs de publication pour qu’ils rejoignent la scène et commencent à [y publier](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/getting-started-pub-sub.html).

Lorsqu’ils rejoignent la scène et commencent à y publier à l’aide de l’un des [kits SDK de diffusion en temps réel IVS](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/broadcast.html), le processus d’enregistrement des participants démarre automatiquement et vous envoie un [événement EventBridge](eventbridge.md) indiquant que l’enregistrement a commencé. (L’événement est Changement d’état de l’enregistrement des participants IVS – Démarrage de l’enregistrement.) Simultanément, le processus d’enregistrement des participants commence à écrire les fichiers VOD et les métadonnées dans le compartiment S3 configuré. Remarque : l’enregistrement des participants connectés pour des durées extrêmement courtes (moins de 5 secondes) n’est pas garanti.

Il existe deux méthodes pour obtenir le préfixe S3 de chaque enregistrement :
+ Écouter l’événement EventBridge :

  ```
  {
     "version": "0",
     "id": "12345678-1a23-4567-a1bc-1a2b34567890",
     "detail-type": "IVS Participant Recording State Change",
     "source": "aws.ivs",
     "account": "123456789012",
     "time": "2024-03-13T22:19:04Z",
     "region": "us-east-1",
     "resources": ["arn:aws:ivs:us-west-2:123456789012:stage/AbCdef1G2hij"],
     "detail": {
        "session_id": "st-ZyXwvu1T2s",
        "event_name": "Recording Start",
        "participant_id": "xYz1c2d3e4f",
        "recording_s3_bucket_name": "ivs-recordings",
        "recording_s3_key_prefix": "<stage_id>/<session_id>/<participant_id>/2024-01-01T12-00-55Z"
     }
  }
  ```
+ Utiliser l’opération d’API [GetParticipant](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_GetParticipant.html) : la réponse inclut le compartiment S3 et le préfixe indiquant où un participant est enregistré. Voici la requête :

  ```
  POST /GetParticipant HTTP/1.1
  Content-type: application/json
  {
     "participantID": "xYz1c2d3e4f",
     "sessionId": "st-ZyXwvu1T2s",
     "stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/AbCdef1G2hij"
  }
  ```

  Et voici la réponse :

  ```
  Content-type: application/json
  {
     "participant": {
        ...
        "recordingS3BucketName": "ivs-recordings",
        "recordingS3Prefix": "<stage_id>/<session_id>/<participant_id>",
        "recordingState": "ACTIVE",
        ...
     }
  }
  ```

### 5. Lecture de la VOD
<a name="ind-part-rec-play-back-vod"></a>

Une fois l’enregistrement finalisé, vous pouvez le visionner en utilisant le [lecteur IVS](https://debug.ivsdemos.com/?p=ivs). Consultez la section [Lecture du contenu enregistré à partir de compartiments privés](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/rt-composite-recording.html#comp-rec-playback) pour obtenir des instructions sur la configuration des distributions CloudFront pour la lecture de vidéos à la demande.

## Enregistrement audio uniquement
<a name="ind-part-rec-audio-only-recordings"></a>

Lors de la configuration de l’enregistrement des participants individuels, vous pouvez choisir de n’enregistrer que les segments HLS audio dans votre compartiment S3. Pour utiliser cette fonctionnalité, choisissez le `AUDIO_ONLY mediaType` lors de la création de la scène :

```
POST /CreateStage HTTP/1.1
Content-type: application/json

{
   "autoParticipantRecordingConfiguration": { 
      "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/AbCdef1G2hij",
      "mediaTypes": ["AUDIO_ONLY"],
      "thumbnailConfiguration": {
         "recordingMode": "DISABLED"
      }
   },
   "name": "TestStage",
   "participantTokenConfigurations": [ 
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "1"
      },
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "2"
      }
   ]
}
```

## Enregistrement miniatures uniquement
<a name="ind-part-rec-recording-thumbnail-only"></a>

Lors de la configuration de l’enregistrement des participants individuels, vous pouvez choisir de n’enregistrer que les mininatures dans votre compartiment S3. Pour utiliser cette fonctionnalité, définissez `mediaType` sur `NONE` lors de la création de la scène. Cela garantit qu'aucun segment HLS n'est généré ; les miniatures sont toujours créées et écrites dans votre compartiment S3.

```
POST /CreateStage HTTP/1.1
Content-type: application/json
{
   "autoParticipantRecordingConfiguration": { 
      "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/AbCdef1G2hij",
      "mediaTypes": ["NONE"],
      "thumbnailConfiguration": {
         "recordingMode": "INTERVAL",
         "storage": ["LATEST", "SEQUENTIAL"],
         "targetIntervalSeconds": 60
      }
   },
   "name": "TestStage",
   "participantTokenConfigurations": [ 
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "1"
      },
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "2"
      }
   ]
}
```

## Enregistrer des contenus
<a name="ind-part-rec-recording-contents"></a>

Lorsque l’enregistrement des participants individuels est actif, les segments vidéo HLS, les fichiers de métadonnées et les miniatures commenceront à être écrits dans le compartiment S3 spécifié lors de la création de la scène. Ce contenu est disponible pour le post-traitement ou la lecture en tant que vidéo à la demande.

Notez qu’une fois l’enregistrement finalisé, un événement Changement d’état de l’enregistrement des participants IVS – Fin de l’enregistrement est envoyé via EventBridge. Nous vous recommandons de lire ou de traiter les flux enregistrés uniquement après réception de cet événement. 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 :

```
s3://mybucket/stageId/stageSessionId/participantId/timestamp
   events
      recording-started.json
      recording-ended.json
   media
      hls
	 multivariant.m3u8
         high
            playlist.m3u8
            1.mp4
      thumbnails
         high
            1.jpg
            2.jpg
      latest_thumbnail
         high
            thumb.jpg
```

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 dossier `events` contient `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 d’enregistrement et est lisible avec le lecteur IVS. 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 d'enregistrement.

## Fusionner les enregistrements fragmentés de participants individuels
<a name="ind-part-rec-merge-frag"></a>

La propriété `recordingReconnectWindowSeconds` d’une configuration d’enregistrement vous permet de spécifier une fenêtre horaire (en secondes) pendant laquelle, si un éditeur d'étape se déconnecte d'une étape puis se reconnecte, IVS essaie d'enregistrer sur le même préfixe S3 que la session précédente. En d’autres termes, si un éditeur se déconnecte puis se reconnecte dans l’intervalle spécifié, les enregistrements multiples sont considérés comme un seul enregistrement et sont fusionnés.

Si l'enregistrement des miniatures est activé en mode `SEQUENTIAL`, les miniatures sont également fusionnées sous le même `recordingS3Prefix`. Lorsque les enregistrements sont fusionnés, le compteur des miniatures redémarre à partir de la valeur de miniature précédente écrite pour l'enregistrement précédent.

**Événements de changement d’état d’enregistrement IVS dans Amazon EventBridge :** les événements de fin d’enregistrement et les fichiers de métadonnées JSON recording-ended sont retardés d’au moins `recordingReconnectWindowSeconds`, pendant qu’IVS attend de s’assurer qu’un nouveau flux ne démarre pas.

Pour obtenir des instructions sur la configuration de fusion des flux, veuillez consulter la rubrique [Étape 2 : Créer une étape avec enregistrement optionnel des participants](getting-started-create-stage.md) dans *Mise en route avec la diffusion en temps réel d’Amazon IVS*.

### Éligibilité
<a name="ind-part-rec-merge-frag-eligibility"></a>

Pour que plusieurs enregistrements soient fusionnés en utilisant le même préfixe S3, certaines conditions doivent être remplies pour tous les enregistrements :
+ La valeur de la propriété `recordingReconnectWindowSeconds` AutoParticipantRecordingConfiguration pour l’étape est définie sur une valeur supérieure à 0.
+ Le `StorageConfigurationArn` utilisé pour écrire les artefacts de VOD est le même pour chaque enregistrement.
+ La différence de temps en secondes entre le moment où le participant quitte l'étape et celui où il rejoint l'étape est inférieur ou égal à `recordingReconnectWindowSeconds`.

Notez que la valeur par défaut de `recordingReconnectWindowSeconds` est 0, ce qui désactive la fusion.

## Synchroniser les enregistrements de plusieurs participants
<a name="ind-part-rec-sync-multiple"></a>

Les enregistrements individuels des participants incluent des balises `EXT-X-PROGRAM-DATE-TIME` dans les listes de lecture HLS, qui fournissent des horodatages UTC précis avec une précision de l’ordre de la milliseconde pour synchroniser les enregistrements de participants multiples lors du post-traitement.

Lorsque vous enregistrez plusieurs participants individuellement et que vous souhaitez créer un montage synchronisé (comme une mise en page côte à côte ou image en incrustation), vous pouvez utiliser ces horodatages pour aligner les enregistrements avec précision, même si les participants ont rejoint l’étape à des moments différents ou ont connu des discontinuités potentiellement causées par des interruptions du réseau.

La liste de lecture HLS de chaque participant inclut des balises `EXT-X-PROGRAM-DATE-TIME` qui indiquent :
+ Le début de l’enregistrement (premier segment).
+ Tout point de discontinuité pendant l’enregistrement, par exemple lors de l’assemblage.

Ces horodatages utilisent une précision de l’ordre de la milliseconde et sont synchronisés entre tous les participants en utilisant la même référence temporelle.

### Exemple de liste de lecture HLS
<a name="ind-part-rec-sync-multiple-hls-playlist"></a>

```
#EXTM3U
#EXT-X-VERSION:7
#EXT-X-TARGETDURATION:12
#EXT-X-PLAYLIST-TYPE:VOD
#EXT-X-MAP:URI="init-0.mp4"
#EXT-X-PROGRAM-DATE-TIME:2024-01-01T12:00:00.000Z
#EXTINF:3.30091,
0.mp4
#EXTINF:5.63794,
1.mp4
#EXTINF:2.74290,
2.mp4
#EXT-X-DISCONTINUITY
#EXT-X-MAP:URI="init-1.mp4"
#EXT-X-PROGRAM-DATE-TIME:2024-01-01T12:00:52.772Z
#EXTINF:2.54412,
3.mp4
#EXTINF:5.63649,
4.mp4
```

Les balises `EXT-X-PROGRAM-DATE-TIME` fournissent l’heure UTC exacte pour le premier segment et à chaque point de discontinuité, ce qui permet une synchronisation précise avec les enregistrements des autres participants.

### Flux de travail de synchronisation
<a name="ind-part-rec-sync-multiple-workflow"></a>

Pour synchroniser les enregistrements de plusieurs participants, extrayez les horodatages `EXT-X-PROGRAM-DATE-TIME` de la liste de lecture HLS de chaque participant et utilisez-les pour calculer les décalages temporels. Ces décalages peuvent ensuite être appliqués lors du post-traitement du montage à l’aide d’outils de traitement vidéo comme FFmpeg. Lorsque des discontinuités sont présentes dans les enregistrements, les horodatages à ces points fournissent les références temporelles nécessaires pour maintenir une synchronisation précise tout au long de l’enregistrement.

Remarque : pour une sortie synchronisée en temps réel sans post-traitement, envisagez d’utiliser un montage côté serveur plutôt qu’un enregistrement des participants individuels.

## Fichiers de métadonnées JSON
<a name="ind-part-rec-json-metadata-files"></a>

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 d’enregistrement. | 
| `session_id` | chaîne | Oui | Chaîne représentant l’identifiant `session_id` de la scène où le participant est enregistré. | 
| `participant_id` | chaîne | Oui | Chaîne représentant l’identifiant du participant enregistré. | 
| `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`. Consultez également la remarque ci-dessous pour `recording_ended_at`. | 
| `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"`. **Remarque :** `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_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"`. | 
| `media` | objet | Oui | Objet contenant les objets énumérés du contenu multimédia disponibles pour cet enregistrement. Valeur valide : `"hls"`. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-individual-participant-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-individual-participant-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-individual-participant-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-individual-participant-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-individual-participant-recording.html)  | objet | Oui | Tableau des rendus (variantes 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-individual-participant-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-individual-participant-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-individual-participant-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-individual-participant-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-individual-participant-recording.html)  | objet | Oui | Tableau des rendus (variantes de miniatures) 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-individual-participant-recording.html)  | chaîne | Oui | Chemin relatif depuis le préfixe S3 où le contenu des miniatures est stocké pour ce rendu. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ivs/latest/RealTimeUserGuide/rt-individual-participant-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-individual-participant-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-individual-participant-recording.html)  | objet | Oui | Tableau des rendus (variantes de miniatures) 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-individual-participant-recording.html)  | chaîne | Oui | Chemin relatif depuis le préfixe S3 où la dernière miniature est stockée pour ce rendu. | 
| `version` | chaîne | Oui | Version du schéma des métadonnées. | 

### Exemple : recording-started.json
<a name="ind-part-rec-json-ex-rec-start"></a>

```
{
   "version": "v1",
   "stage_arn": "arn:aws:ivs:us-west-2:aws_account_id:stage/AbCdef1G2hij",
   "session_id": "st-ZyXwvu1T2s",
   "participant_id": "xYz1c2d3e4f",
   "recording_started_at": "2024-03-13T13:17:17Z",
   "recording_status": "RECORDING_STARTED",
   "media": {
      "hls": {
         "path": "media/hls",
         "playlist": "multivariant.m3u8",
         "renditions": [
            {
               "path": "high",
               "playlist": "playlist.m3u8"
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "renditions": [
            {
               "path": "high"
            }
         ]
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail",
         "renditions": [
            {
               "path": "high"
            }
         ]
      }
   }
}
```

### Exemple : recording-ended.json
<a name="ind-part-rec-json-ex-rec-end"></a>

```
{
   "version": "v1",
   "stage_arn": "arn:aws:ivs:us-west-2:aws_account_id:stage/AbCdef1G2hij",
   "session_id": "st-ZyXwvu1T2s",
   "participant_id": "xYz1c2d3e4f",
   "recording_started_at": "2024-03-13T19:44:19Z",
   "recording_ended_at": "2024-03-13T19:55:04Z",
   "recording_status": "RECORDING_ENDED",
   "media": {
      "hls": {
         "duration_ms": 645237,
         "path": "media/hls",
         "playlist": "multivariant.m3u8",
         "renditions": [
            {
               "path": "high",
               "playlist": "playlist.m3u8"
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "renditions": [
            {
               "path": "high"
            }
         ]
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail",
         "renditions": [
            {
               "path": "high"
            }
         ]
      }
   }
}
```

### Exemple : recording-failed.json
<a name="ind-part-rec-json-ex-rec-failed"></a>

```
{
   "version": "v1",
   "stage_arn": "arn:aws:ivs:us-west-2:aws_account_id:stage/AbCdef1G2hij",
   "session_id": "st-ZyXwvu1T2s",
   "participant_id": "xYz1c2d3e4f",
   "recording_started_at": "2024-03-13T19:44:19Z",
   "recording_ended_at": "2024-03-13T19:55:04Z",
   "recording_status": "RECORDING_ENDED_WITH_FAILURE",
   "media": {
      "hls": {
         "duration_ms": 645237,
         "path": "media/hls",
         "playlist": "multivariant.m3u8",
         "renditions": [
            {
               "path": "high",
               "playlist": "playlist.m3u8"
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "renditions": [
            {
               "path": "high"
            }
         ]
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail",
         "renditions": [
            {
               "path": "high"
            }
         ]
      }
   }
}
```

## Conversion d'enregistrements en MP4
<a name="ind-part-rec-convert-rec-mp4"></a>

Les enregistrements des participants individuels sont stockés au format HLS, composé de listes de lecture et de segments MP4 fragmentés (fMP4). Pour convertir un enregistrement HLS en un seul fichier MP4, installez FFmpeg et exécutez la commande suivante :

```
ffmpeg -i /path/to/playlist.m3u8 -i /path/to/playlist.m3u8 -map 0:v -map 1:a -c copy output.mp4
```