timescale

The 'timescale' directive configures the playback speed of media segments served by the Kaltura Media Framework.

Syntaxtimescale number;
Defaultnone
Context
Arguments1

Description

The 'timescale' directive is an important feature within the Kaltura Media Framework's NGINX module that governs how media segments are played back. By adjusting the timescale, users can effectively manipulate playback speed, allowing for adaptive streaming of content according to network conditions or user preferences. This directive takes a single argument, which represents the factor by which the normal playback speed is multiplied. For instance, a timescale of 2.0 would indicate that the media should play back at double speed, while a timescale of 0.5 would reduce playback speed to half of the normal rate.

The behavior of the 'timescale' directive is context-specific but is primarily utilized in scenarios requiring changes to playback characteristics based on external inputs or internal logic dictated by the media player's capabilities. When set properly, it facilitates a seamless experience for end-users during variable network loads or when specific user interaction is necessary, such as skipping through content or slowing down to catch details. The directive, therefore, enhances the adaptability of media delivery by allowing real-time adjustments to the playback speed through HTTP headers, making it highly relevant in live streaming scenarios where latency and bandwidth can affect performance.

The implementation of the 'timescale' directive also interacts with the Kaltura Media Protocol (KMP) and Kaltura Segmented Media Protocol (KSMP), ensuring that this playback speed adjustment aligns with the expected performance and quality standards of streaming media through these protocols. Proper understanding and configuration of the 'timescale' directive can greatly affect user experience and resource utilization in live streaming scenarios, providing a necessary tool for content providers aiming for optimal delivery efficiency.

Config Example

timescale 1.0;

Ensure the timescale value is a valid numerical format; otherwise, the configuration may fail to load properly.

Using extreme values (too high or too low) may lead to playback issues or negatively affect the viewer experience.

Make sure to test playback at different timescale settings to verify that all media segments are appropriately handled.

← Back to all directives