Skip to main content

Amazon Elemental

Note

This integration is a premium integration. To activate the integration, you must follow a typical software development life cycle, which will incur additional costs. For more details on this integration or on other premium integrations, please contact your Brightspot representative.

With Amazon Elemental, you can easily convert and edit videos that you added to Brightspot, providing a personalized experience for your visitors. Amazon Elemental also provides live streaming capabilities with the opportunity for later playback.

Brightspot provides the following services with Amazon Elemental: MediaConvert, MediaLive, and MediaTailor. You can configure all three components, or only those components you use.

Configuration​

The following table lists the dependencies required to include the Amazon Elemental integration in your build.

DependencyGroup IDArtifact ID
AWS: Elementalcom.psddevaws-elemental

Configuring the Amazon Elemental region​

If you manage your own Amazon Elemental account, you may need to configure the AWS region in Brightspot.

To configure the Amazon Elemental region:

  1. Click > Admin > Sites & Settings > Sites > Global.
  2. Under Integrations, expand AWS Elemental.
  3. In the Region field, enter the region to use when making requests to AWS Elemental (or leave blank to use the region in your Brightspot server's configuration).
  4. Click Save.

Configuring MediaConvert​

Brightspot integrates with Amazon's MediaConvert service to provide video conversion to a wide variety of resolutions, bit rates, file formats, refresh rates, and other settings.

To configure Elemental MediaConvert:

  1. Configure the Amazon Elemental region as described above.
  2. In the Edit Global widget, under Integrations, expand AWS Elemental MediaConvert.
  3. Toggle on Enable MediaConvert Service.
  4. In the MediaConvert Role ARN and MediaConvert SQS Queue Name fields, enter the corresponding values from your AWS console.
  5. In the MediaConvert Sync Button Delay (Minutes) field, enter the number of minutes after which Brightspot displays a button in the content edit form to check if a conversion is complete.
  6. Click Save.

See also:

Configuring MediaLive​

Brightspot integrates with Amazon's MediaLive service to deliver live video streams.

To configure Elemental MediaLive:

  1. Configure the AWS Elemental region as described above.
  2. If you want to activate MediaLive, toggle on Enable Media Live Service.
  3. In the Media Live Role ARN field, enter the corresponding value from your AWS console.
  4. Click Save.

See also:

Configuring MediaTailor​

Brightspot integrates with Amazon's MediaTailor service to deliver personalized ads during a video's playback.

To configure Elemental MediaTailor:

  1. Configure the AWS Elemental region as described above.
  2. In the Edit Global widget, under Integrations, expand AWS Elemental MediaTailor.
  3. Toggle on Enable MediaTailor Service.
  4. Click Save.

See also:

Configuring a live stream​

You can use Brightspot to stream a live event using Amazon's MediaLive service. This section describes how to configure an individual live stream.

To configure a live stream:

  1. Obtain the feed information from the live-stream producer. This information typically includes an Amazon Resource Name (ARN), security group ID, and permitted rules.

  2. Configure the AWS Elemental region as described in Configuring the Amazon Elemental region.

  3. Configure MediaLive as described in Configuring MediaLive.

  4. In the header, click .

  5. Under Create, select Live Video, and then click New. The content edit page appears.

  6. In the Internal Name field, enter an identifying name.

  7. From Provider, select AWS Elemental. A form appears.

  8. From the Channel list, select Create New. A New Live Channel content edit page appears.

    New live stream channel form

  9. In the Name field, enter an identifying name.

  10. From the Input list, select the protocol you determined in step 1. A form appears.

  11. In the Input Security Group field, enter the information you determined in step 1.

  12. Under Live Output, enter settings for transmitting the live feed.

  13. Under VOD, enter settings for saving the live stream for later playback.

  14. If you want to share this setting with your other sites, in the Sites widget, do the following:

    1. From the Owner list, select None.

    2. From the Access list, select All Others.

      Sites widget

  15. Click Save.

  16. Click Back. You return to the New Live Video content edit page.

  17. Complete the rest of the form.

  18. Complete your site's workflow.

When the live stream starts, you can record it for playback at a later time.

See also:

Adding captions to videos​

You can deliver captions along with your videos. As visitors watch a video, they also see the captions you provide.

To add captions to a video:

  1. Acquire the caption file if available.

  2. Create a new video in Brightspot.

  3. Under Main > Captions, do one of the following:

    • If the video contains an embedded caption file, select Embedded Caption. Skip to step 5.

    • If you have an external caption file, select Sidecar Caption. A form appears.

      Adding a caption file to a video

  4. For information about filling out the form, see IMSC, TTML and WebVTT (Sidecar) Output Captions and SCC, SRT (Sidecar) Output Captions.

  5. Complete your site's workflow and publish the video.

Providing videos in multiple formats​

Depending on your target audience, you may need to distribute videos in a variety of formats. For example, you may want to offer visitors two versions of the same video: a low-fidelity version at 50 Mbps and a high-fidelity version at 100 Mbps. Similarly, you may want to offer the same video with different resolutions, one at 1280×720 and another at 1960×1080.

Depending on your version of Brightspot, you can upload videos and automatically convert them to a variety of formats. Contact your Brightspot administrator to determine which target formats are available.

To provide a video in multiple formats:

  1. Create a new video in Brightspot.
  2. Toward the right of the widget, click > Advanced.
  3. From the Transcoding Settings selection field, select one of the available settings, or click search to create one-off settings for this conversion. For information about configuring transcoding settings, see Configuring MediaConvert.
  4. From the Overlays list, select or create an overlay that appears along with the video.
  5. Complete your site's workflow and publish the video.

When the conversion is complete, Brightspot lists the different formats under > Outputs.

Post-production activities for videos​

After Amazon Elemental processes your video, you can perform two post-production activities: select a thumbnail, and configure an advertising stream.

Editing and selecting thumbnails for videos​

Depending on your Brightspot configuration, AWS Elemental provides thumbnails you can select as a promo for your video. If there are multiple thumbnails, Brightspot uses the first one for the promo.

Thumbnails generated from a video

To edit or select a thumbnail:

  1. Create a new video in Brightspot, or open an existing video.

  2. Toward the right of the widget, select > Thumbnails. A list of available thumbnails appears.

  3. If you want to add alt text to a thumbnail, do the following:

    1. Select List View.
    2. In the Alt Text field, enter the alt text.

  4. If you want to manually add a thumbnail, do the following:

    1. Under Thumbnails, click .
    2. To add a one-off thumbnail, select One-Off Image.
    3. To add a shared thumbnail, select Shared.
    4. Complete the form.

  5. If you want to delete a thumbnail, click .

  6. To change the thumbnail that Brightspot uses for the video, drag it to the first position in the list of thumbnails.

  7. Complete your site's workflow and publish the video.

See also:

Configuring ads for delivery during video playback​

If you are registered with an ad service such as Google's Doubleclick For Publishers (DFP), you can push ads to your visitors during video playbacks. You can rely on the ad service's default ad-selection logic, or you can provide custom selection criteria.

To deliver ads during video playback:

  1. Create a new video in Brightspot, or open an existing video.
  2. Under > Advanced, expand MediaTailor.
  3. From the MediaTailor Configuration list, select Select.
  4. In the selection field, select one of the available MediaTailor configurations.
  5. Complete your site's workflow and publish the video.

See also:

Saving live video streams for later playback​

If you are streaming a live event, you can save the recording as a video so visitors can watch it at a later time.

To save a live stream:

  1. Configure the live stream channel as described in Configuring a live stream.
  2. In the content edit form, click Start Channel. Brightspot starts saving the live stream.
  3. Click Stop Channel. Brightspot stops saving the live stream.
  4. Repeat steps 2–3 to save intermittent segments of the live stream.

Under > Outputs, Brightspot saves each video segment as a new video.