Frame capture destination - MediaLive
Design the path for the output destinationComplete the fields on the console

Frame capture destination

The following fields configure the location and names of the frame capture files (the destination).

  • Output group – Frame capture group destination section

  • Output group – Frame capture settings – CDN settings

    Output settings – Name modifier

You must design the destination path or paths for the output. You must then enter the different portions of the path into the appropriate fields on the console.

Design the path for the output destination

As part of the planning for this output group, you discussed your requirements with the Amazon S3 user. You should already have the following information:

  • The bucket names for the output

  • Or the full path for the output

To design the path

If you haven't yet designed the destination path or paths, design them now. If you've already designed the paths, go to Complete the fields on the console.

  • Design the destination path or paths, following this syntax:

    protocol bucket folders baseFilename nameModifier counter extension

    For example, for a standard channel:

    s3ssl://DOC-EXAMPLE-BUCKET1/sports-thumbnails/delivery/curling-20180820.00000.jpg

    s3ssl://DOC-EXAMPLE-BUCKET1/sports-thumbnails/backup/curling-20180820.00000.jpg

The following table maps each portion in the example to the portion in the syntax.

Portion of the URL Example Comment
protocol s3ssl:// The protocol is always s3ssl:// because the destination for a frame capture output is always an S3 bucket.
bucket portion of the path DOC-EXAMPLE-BUCKET1 When you planned the workflow for the channel, you should have made sure that the S3 bucket or buckets exist.

With MediaLive, the S3 bucket name must not use dot notation. For example, mycompany-videos is acceptable but mycompany.videos isn't.

folders portion of the path sports-thumbnails/delivery/ The folders can be present or not, and can be as long as you want.

The folders must always end with a slash.
baseFilename curling Don't terminate the file name with a slash.
nameModifier -20180820 The modifier is optional for an frame capture output.
delimiter before the counter . MediaLive automatically inserts this delimiter.
counter 00000 MediaLive automatically generates this counter. Initially, this is a five-digit number starting at 00000, and increasing by 1. So 00000, 00001, 00002 and so on. After 99999, the next number is 100000 (six digits), then 100001, 100002, and so on. Then from 999999 to 1000000 (seven digits), and so on.
dot before the extension . MediaLive automatically inserts this dot.
extension jpg Always jpg.

Complete the fields on the console

To specify the location for the output

  1. Enter the different portions of the destination in the appropriate fields.

    Portion of the destination URL Field Example
    protocol, bucket, folders, baseFilename The two URL fields in the Frame capture group destinations section.

    The data before the first slash is the bucket name. The data after the last slash is the baseFilename. The data in between is the folders.

    Specify two destinations when the channel is set up as a standard channel, or one destination when it is set up as a single-pipeline channel.

    		s3ssl://DOC-EXAMPLE-BUCKET1/sports-thumbnails/delivery/curling
    nameModifier The Name modifier field in the Frame capture outputs section.

    If you choose to include a modifier, you can enter a string such as -high, to indicate a high-resolution output.

    Or you can enter a variable ID (such as $dt$) to ensure that the modifier is different for each file segment. For a list of variable data identifiers, see Identifiers for variable data.

    		 $dft$

  2. Leave the Credentials section blank in both the Frame capture group destinations sections. MediaLive has permission to write to the S3 bucket via the trusted entity. Someone in your organization should have already set up these permissions. For more information, see Reference: summary of requirements for the MediaLive trusted entity.

  3. Complete the CDN settings field only if MediaLive must set a canned ACL whenever it sends this output to the Amazon S3 bucket.

    Use of a canned ACL typically only applies if your organization is not the owner of the Amazon S3 bucket. You should have discussed the use of a canned ACL with the bucket owner when you discussed the destination for the output.