gst-plugins-rs/net/hlssink3
Piotr Brzeziński c4bcdea830 hlscmafsink: Add new-playlist signal
Allows you to switch output between folders without having to state change to READY to close the current playlist.
Closes the current playlist immediately and starts a new one at the currently set location.
Should be used after changing the relevant location properties.
Makes use of the send-headers signal in cmafmux.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/merge_requests/1692>
2024-08-22 02:06:51 +00:00
..
examples Fix various new clippy 1.79 warnings 2024-06-14 08:33:49 +03:00
src hlscmafsink: Add new-playlist signal 2024-08-22 02:06:51 +00:00
tests hlssink3: Fix racy test by separating events (signals) from bus messages 2024-08-21 19:49:09 +00:00
build.rs Add hlssink3 plugin 2021-11-16 08:23:44 +00:00
Cargo.toml Use workspace features for crates metadata/deps 2024-02-05 15:34:31 +01:00
LICENSE-MPL-2.0 git: replace LICENSE file symlinks with copies 2023-04-04 14:26:37 +01:00
README.md hlssink3: Update README 2023-09-25 21:34:05 +09:00

GStreamer HTTP Live Streaming Plugin

A GStreamer HLS sink plugin. Based on the "hlssink2" element.

The hlssink3 plugin consists of hlssink3 and hlscmafsink elements. hlssink3 element generates traditional MPEG-TS based HLS segments and playlist while hlscmafsink generates CMAF (fragmented mp4) segments.

NOTE: hlssink3 element is feature-equivalent to the hlssink2 element. Any pipeline that uses hlssink2 can use the hlssink3 element and the result should be the same.

Both elements have a playlist-type property used to control the behavior of the HLS playlist file. The available values for this property are:

  • null (default): The tag #EXT-X-PLAYLIST-TYPE won't be present in the playlist during the pipeline processing. The playlist will be updated in sync as new segments are available, old segments are removed, keeping N segments as defined in the property playlist-length. This is the default behavior, and is compatible with how "hlssink2" works;
  • "event": The playlist is updated as new segments are available, and the tag #EXT-X-PLAYLIST-TYPE:EVENT is present during processing. No segments will be removed from the playlist.
  • "vod": The playlist behaves like the event option (a live event), but at the end of the processing, the playlist will be set to #EXT-X-PLAYLIST-TYPE:VOD.

At the end of the processing, #EXT-X-ENDLIST is added to the playlist if a enable-endlist property is enabled (default is true).

Live playlist generation

In case of live recording with multiple playlists, the #EXT-X-PROGRAM-DATE-TIME tags can be useful hint for clients when mapping each stream time to the wall-clock.

The #EXT-X-PROGRAM-DATE-TIME tags will be written to the playlist if enable-program-date-time property is enabled.