AWS ivs documentation change
Summary
Added sections for merging fragmented recordings and MP4 conversion instructions
Security assessment
Adds operational documentation about recording continuity features and technical instructions. No security controls, vulnerabilities, or security-related configurations are introduced.
Diff
diff --git a/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.md index 7c06bbb67..0ba576418 100644 --- a/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.md +++ b/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.md @@ -5 +5 @@ -IntroductionWorkflowAudio-Only RecordingThumbnail-Only RecordingRecording ContentsJSON Metadata Files +IntroductionWorkflowAudio-Only RecordingThumbnail-Only RecordingRecording ContentsMerge Fragmented Individual Participant RecordingsJSON Metadata FilesConverting Recordings to MP4 @@ -232,0 +233,25 @@ The `media` folder contains the supported media contents. The `hls` subfolder co +## Merge Fragmented Individual Participant Recordings + +The `recordingReconnectWindowSeconds` property on a recording configuration allows you to specify a window of time (in seconds) during which, if a stage publisher disconnects from a stage and then reconnects, IVS tries to record to the same S3 prefix as the previous session. In other words, if a publisher disconnects and then reconnects within the specified interval, the multiple recordings are considered a single recording and merged together. + +If thumbnail recording is enabled in `SEQUENTIAL` mode, then thumbnails are also merged under the same `recordingS3Prefix`. When the recordings are merged, the thumbnail counter restarts from the previous thumbnail value that was written for the previous recording. + +**IVS Recording State Change events in Amazon EventBridge:** Recording End events and recording-ended JSON metadata files are delayed by at least `recordingReconnectWindowSeconds`, as IVS waits to ensure a new stream is not started. + +For instructions on setting up the merge-streams functionality, see [Step 2: Create a Stage with Optional Participant Recording](./getting-started-create-stage.html) in _Getting Started with Amazon IVS Real-Time Streaming_. + +### Eligibility + +For multiple recordings to be merged using the same S3 prefix, certain conditions must be met for all the recordings: + + * The value of the `recordingReconnectWindowSeconds` property of the AutoParticipantRecordingConfiguration for the stage is set greater than 0. + + * The `StorageConfigurationArn` used to write the VOD artifacts is the same for each recording. + + * The time difference in seconds between when the participant leaves and rejoins the stage is less than or equal to `recordingReconnectWindowSeconds`. + + + + +Note that the default value of `recordingReconnectWindowSeconds` is 0, which disables merging. + @@ -432,0 +458,7 @@ Field | Type | Required | Description +## Converting Recordings to MP4 + +Individual participant recordings are stored in the HLS format, consisting of playlists and fragmented MP4 (fMP4) segments. To convert an HLS recording into a single MP4 file, install FFmpeg and run the following command: + + + ffmpeg -i /path/to/playlist.m3u8 -i /path/to/playlist.m3u8 -map 0:v -map 1:a -c copy output.mp4 +