Powered by the recording capability of CSS, the time shifting feature allows viewers to rewind and play back a video stream from earlier time points. When time shifting is enabled for a VOD playback domain, TS segment URLs and TS files for the video are saved in VOD, and the user can play back earlier video content by passing a time parameter in the request URL under the playback domain.
In HLS streaming, a video stream is split into TS segments. Viewers use an M3U8 file to access a TS segment URL, get the TS file, and play the video content starting from that TS segment.
TS files are not saved permanently, so there is a limit to how far back in time playback can start from.
The time shifting feature has been in beta testing so far. However, we will start charging for use of the feature starting from 00:00 on June 1, 2022. For details, see Notice: Time Shifting to Become Paid Feature. Time shifting relies on recording, so you will also be charged live recording fees by CSS and storage and playback fees by VOD.
Follow the steps below to add a VOD domain name for time shifting:
- Choose HLS as the recording format.
- Enter a custom storage period, which cannot be shorter than the time-shift duration.
Submit a ticket to enable the time shifting feature. You need to select CSS as the product and provide the following information:
- The time-shift duration indicates how far back from the current time you can play back the video stream. Currently, the longest time-shift duration allowed is 30 days.
- Given that the time-shift duration you configure may not exactly match the actual time-shift duration, we recommend you set the duration a little longer than you actually need.
- For example, if the parameter is set to
7200(2 hours), you will be able to request content generated 2 hours ago or later, and the value range for the playback delay parameter
delayis 90 seconds to 2 hours. If
delayis set to a value larger than 2 hours,
HTTP 404will be returned even if there is live streaming content at that time point.
|[Domain]||The VOD domain name added in Step 2 for time shifting.|
|timeshift||A non-customizable parameter.|
|[AppName]||The application name. For example, if your application name is
|[StreamName]||The stream name. Set this parameter to the name of the stream for which you want to enable time shifting.|
|timeshift.m3u8||A non-customizable parameter.|
|delay||The playback delay time (seconds). If you pass in a value smaller than
Suppose the time-shift domain name is
testtimeshift.com, application name is
live, and stream name is
SLPUrIFzGPE. To play back video content from 5 minutes ago, you should use the following request URL: