Configuring DVR with NextGen Live

DVR functionality allows viewers to pause, rewind, and replay portions of your live stream, providing a more flexible viewing experience. NextGen Live offers robust DVR capabilities designed to ensure optimal performance and user experience.

After completing this guide, you should be able to:

• Understand DVR window limitations in NextGen Live
• Configure DVR settings for your live channels
• Generate proper embed code with playback tokens for DVR functionality
• Reset the DVR window when needed
• Optimize DVR settings for the best viewer experience

Audience

Publishers who need to configure DVR functionality for their live streaming channels using NextGen Live.

DVR Limitations and Considerations

• Maximum DVR Window: NextGen Live supports a maximum DVR window of 86,400 seconds (24 hours).
• Longer DVR windows may impact player performance and user experience.

Steps to configure DVR

To configure DVR for your live channel, you will complete the following tasks:

• Create a new live channel with DVR enabled.
• Configure DVR window settings.
• Publish and embed the channel with playback token.
• Test DVR functionality.
• Reset the DVR window (optional).

Creating a live channel with DVR

1. Log in to Studio.
2. Open the Live module.
3. Click the Create Channel button to create a new channel.
4. Enter a Channel Name.
5. If your account has been configured with required custom fields, make sure the custom fields are assigned values.
6. Select a Live Ingest Profile from the dropdown list.
7. In the Advanced Options section, locate the DVR Window setting.

   

8. Enter your desired DVR window duration in seconds (maximum 86,400 seconds / 24 hours).
9. Configure other channel settings as needed.
10. Click Save to create the channel with DVR enabled.

Configuring DVR window settings

The DVR window determines how far back viewers can rewind in your live stream. Consider these factors when setting your DVR window:

1. Content Type: News broadcasts may need shorter windows (30-60 minutes), while sports channels might benefit from longer windows (2-4 hours).
2. Viewer Behavior: Analyze how your audience typically interacts with live content.
3. Technical Considerations: Longer DVR windows require more resources and may impact performance.

Publishing and embedding DVR-enabled channels

After configuring DVR for your channel, you need to generate the proper embed code to ensure DVR functionality works correctly:

1. In the Control Room for your channel, click Publish and Embed in the top right corner.
2. Select a Player from the dropdown menu.
3. Configure player settings as needed:
   • Sizing: Fixed or Responsive
   • Aspect Ratio: Select your preferred aspect ratio
   • Player Dimensions: Set width and height
4. Important: Check the Allow DVR checkbox to enable DVR functionality in the embed code.

   

5. Choose your embed code type:
   • iframe: Standard iframe embed (includes livePlaybackToken as a URL parameter)
   • JavaScript (Advanced): Advanced embed with video-js tag (includes data-live-playback-token attribute)
6. Copy the generated embed code.

Understanding the playback token

The livePlaybackToken (in iframe embeds) or data-live-playback-token (in JavaScript embeds) is a JWT (JSON Web Token) that contains configuration information for your live stream, including DVR settings. NextGen Live automatically generates this token when you create embed code through the Publish and Embed interface.

Example embed codes

iframe embed with DVR enabled:

<iframe src="https://players.brightcove.net/1234567890001/default_default/index.html?videoId=6378332368112&livePlaybackToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  allowfullscreen
  allow="encrypted-media"
  width="960" 
  height="540"></iframe>

JavaScript (Advanced) embed with DVR enabled:

<video-js 
  data-video-id="6378332368112"
  data-account="1234567890001"
  data-player="default"
  data-embed="default"
  data-live-playback-token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  controls
  class="vjs-fluid"></video-js>
<script src="https://players.brightcove.net/1234567890001/default_default/index.min.js"></script>

Testing DVR functionality

After configuring DVR and embedding your player with the playback token, it's important to test the functionality to ensure it works as expected:

1. Ensure you've embedded the player using the code generated from the Publish and Embed interface (with the playback token included).
2. Start your live stream as normal.
3. Wait for the stream to be active and processing.
4. Open the published player in a browser.
5. Verify the DVR progress bar is displayed and shows the available DVR window.
6. Test the rewind functionality by clicking and dragging the playhead backward.
7. Test seeking to different points within the DVR window.
8. Click the "Live" button to return playhead to the live edge.

   

Resetting the DVR window

NextGen Live provides the ability to flush the DVR content for a channel, effectively resetting the DVR window. This operation clears all buffered DVR content and starts fresh.

What DVR reset does

When you reset the DVR window for a channel:

• All buffered DVR content is permanently removed
• Timeshift playback functionality will no longer work for previously recorded content
• Live-to-VOD clipping features will be unavailable for the flushed content
• Only new content streamed after the reset will be available for DVR, timeshift, and clipping

When to use DVR reset

This operation is useful when you need to:

• Clear the buffer for compliance or content management purposes
• Refresh content after a technical issue or encoder reconnection
• Remove content from the DVR buffer for any reason

How to reset the DVR window

To reset the DVR window for a channel:

1. In the Control Room for your channel, locate the Flush DVR button (next to the DVR Window setting).
2. Click the Flush DVR button.

   

3. Confirm the action when prompted.
4. Wait for the operation to complete. If streaming live, viewers may experience brief playback interruption.

Using the API to reset DVR

You can also reset the DVR window programmatically using the Live API 2.0:

POST https://api.bcovlive.io/v2/accounts/{account_id}/jobs/{id}/reset_origin
Authorization: BC_OAuth2 {access_token}
Content-Type: application/json

For more information, see the Reset DVR Window API reference.