hls_nested
The 'hls_nested' directive enables or disables the HLS nested playlist feature in the NGINX RTMP module.
Description
The 'hls_nested' directive is utilized within the NGINX RTMP module's configuration to control whether the generated HLS playlist should incorporate nested playlists for segments. When set to 'on', it allows for the creation of child playlists, which organize segments into sub-playlists. This is particularly useful for implementing features like adaptive bitrate streaming, where different quality levels can be represented as separate playlists. Such nesting facilitates more versatile client playback options and better network bandwidth management.
By default, when 'hls_nested' is not explicitly configured, the corresponding functionality will not be enabled, making it a critical directive for those seeking to enhance their streaming structure. It is typically included within an application configuration context under the RTMP server block. Users should ensure they properly configure related HLS settings such as segment length to optimize performance and playback experience. Furthermore, it’s essential to recognize that enabling nested playlists may increase the complexity of stream management due to the additional playlists that need to be maintained.
Config Example
rtmp {
server {
listen 1935;
application live {
live on;
hls on;
hls_nested on;
hls_fragment 5s;
}
}
}Make sure to properly set other related HLS parameters to avoid configuration conflicts.
Enabling 'hls_nested' may impact server performance due to increased playlist management overhead.
Ensure your HLS clients support nested playlists for expected behavior.