Configuring DVR with NextGen Live

This guide explains how to configure DVR (Digital Video Recording) functionality with Brightcove NextGen Live, including limitations and best practices for optimal viewer experience.

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:

Audience

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

DVR Limitations and Considerations

Steps to configure DVR

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

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.

    DVR Window Configuration
  8. Enter your desired DVR window duration in seconds (maximum 28,800 seconds / 8 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.

    Allow DVR Checkbox
  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.

    Live Button