dash_playlist_length

The `dash_playlist_length` directive defines the maximum length of the DASH playlist in milliseconds.

Syntaxdash_playlist_length length;
Defaultnone
Context
Arguments1

Description

The dash_playlist_length directive is part of the NGINX RTMP module, specifically used for configuring Dynamic Adaptive Streaming over HTTP (DASH). By setting this directive, the administrator defines the duration of the DASH playlist that will be generated for the media content being streamed. This duration is important for letting media players know how long they can expect to stream and allows efficient buffering and playback without unnecessary delays.

This directive takes a single argument that specifies the length in milliseconds. The value set for dash_playlist_length directly influences how the DASH content is consumed by clients. If the value is too short, it may lead to frequent interruptions or the client being unable to access the complete stream. Conversely, setting it to a very long duration can lead to increased latency. Therefore, a well-considered value should be provided based on the use case of the streaming application. Generally, a balance must be found based on the streaming content and the capabilities of the clients consuming it.

Additionally, this directive can only be utilized within certain contexts, which are yet to be fully specified in the current documentation, thus careful attention should be paid to where it is placed in the server configuration to avoid potential misconfigurations or unexpected behavior.

Config Example

rtmp {
    server {
        listen 1935;
        application live {
            live on;
            dash_playlist_length 30000;
        }
    }
}

Ensure the value is within acceptable limits for your application's requirements.

Using this directive in an improper context might lead to configuration errors.

Setting a very long playlist length can result in undesirable buffering behavior for clients.

← Back to all directives