DVR Configuration

Restart TV lets viewers pause a live stream and seek back inside an available DVR window. The seekable range can come from Akta Cloud event metadata, or from a fixed time window configured in the player.

Akta Cloud requirement

Restart TV requires Akta Cloud configuration before the player can expose DVR controls.

In Akta Cloud, configure DVR from Live Encoders > Edit Encoder > Settings tab > DVR or override it per event from Edit Event > Content Control > DVR. Events are created in Inherit mode by default. The event-level values are:

• Inherit - Uses the encoder DVR setting.
• Enabled - Enables DVR for the event, overriding the encoder.
• Disabled - Disables DVR for the event, overriding the encoder.

In Play Configuration > Edit > Private > Custom, add and keep this block:

dvr:
  enabled: true

Restart TV does not require a separate play configuration. Restart TV is fully compatible only with server-side ads stitched by Akta.

To enable DVR handling in Lura Player, use the following configuration.

Attribute	Type	Required	Description
enabled	boolean	no	Enables DVR handling for live playback.
mode	"event" | "window"	no	event uses Akta event metadata. window uses a sliding lookback window ending at the current time.
availabilityWindow	number	no	DVR window duration in seconds. Used when mode is "window".

Event mode

Use event mode when Akta Cloud provides the Restart TV window from event or encoder metadata.

const config = {
    ...
    content: {
        type: "live",
        dvr: {
            enabled: true,
            mode: "event"
        }
    }
    ...
};
const player = new lura.Player();
player.setConfig(config);

Window mode

Use window mode when the live stream should expose a fixed sliding DVR range.

const config = {
    ...
    content: {
        type: "live",
        dvr: {
            enabled: true,
            mode: "window",
            availabilityWindow: 7200
        }
    }
    ...
};
const player = new lura.Player();
player.setConfig(config);

Start inside the DVR window

For Restart TV, startAt is a UNIX timestamp in seconds, not a relative offset. The timestamp must be inside the DVR availability window.

const config = {
    ...
    content: {
        type: "live",
        dvr: {
            enabled: true,
            mode: "event"
        },
        startAt: 1710528000
    }
    ...
};
const player = new lura.Player();
player.setConfig(config);