Managing Ingest Profiles

Product(s)
Video Cloud
Role(s)
Studio User
API Developer
Task(s)
Add Videos/Assets
Topic(s)
Administration
Ingest Profiles

This topic provides an overview of how to create and edit custom ingest profiles.

 

Ingest profiles contain the transcode settings that will be used when videos are uploaded using the Upload module or the Dynamic Ingest API.

To access the Ingest Profiles administration page, click the ADMIN link and then Ingest Profiles. Note that to access the Ingest Profiles administration page, you must be a Video Cloud Studio user with the Administrator role.

A list of ingest profiles will appear.

Note: Clicking the Show API name link in the header will display the internal name of the ingest profile. The internal name is used when using the ingest profile name in an API call.

The page will display the following information:

  • Profile Name and Description
  • Profile Version - Indicates the type of transcoding that is used. Note that the types that appear are based upon how your Video Cloud account is configured:
  • Type - Type of ingest profile
    • Standard VOD - Indicates that this is a default profile provided by Video Cloud. This type of profile can't be edited or deleted.
    • Custom VOD - Indicates that this is a custom ingest profile.
    • Standard Live - Indicates that this is a default Live profile provided by Video Cloud. This type of profile can't be edited or deleted.
    • Custom Live - Indicates that this is a custom Live ingest profile.
  • Renditions - The number of video renditions that may be created.
  • Display - Determines whether the profile is displayed and can be selected in the Upload module.

For specific details on the Brightcove supplied ingest profiles (profiles with a Type of Standard VOD or Standard Live), see one of the following documents:

Note: When lower quality source content is uploaded and one of the standard profiles is selected, Video Cloud will only produce renditions that are equal to or lower in quality than the source. When creating your own custom profiles, you may want to use conditional output parameters to prevent renditions from being generated if the source doesn't match the quality criteria you specify. This will prevent the dynamic ingest system from creating higher quality renditions when lower quality source files are uploaded.

Using the Ingest Profiles administration page, you can:

Archiving and distributing masters

Ingest profiles can be configured to archive and distribute master (source) files. Archiving the master keeps a copy of the master file and provides the ability for the video to be re-transcoded in the future without the need to upload it again. Distributing the master enables the master to be pushed to the CDN and used as a playable rendition. The Standard VOD ingest profiles are configured to archive and not distribute the master. You may wish to change this behavior when creating a custom ingest profile. For additional information on archiving and distributing masters, see the Archiving Masters document. For a list of all the fields that can be configured when creating ingest profiles, see the Ingest Profiles API Fields Reference developer document.

Creating a new ingest profile

Note: The ability to create and edit Ingest Profiles is available only to publishers with Enterprise and Professional accounts.

To create a new ingest profile, click New Profile.

The process to create a new ingest profile will vary based upon the type of profile being created. See one of the following documents for details on how to create a custom ingest profile:

Editing ingest profiles

The Ingest Profiles administration page can be used to edit ingest profiles. Note that the default set of ingest profiles (marked Standard VOD) can't be edited.

To edit an ingest profile:

  1. Click the ADMIN link in the Studio header.
  2. Click the Ingest Profiles link.
  3. Click on the ingest profile to edit.
  4. Use the Profile Editor to edit the profile definition.
  5. Click Save.

Deleting ingest profiles

The Ingest Profiles administration page can be used to delete ingest profiles that are no longer needed. Note that the default set of ingest profiles (marked Standard VOD) can't be deleted but they can be hidden if they are not needed.

To delete an ingest profile:

  1. Click the ADMIN link in the Studio header.
  2. Click the Ingest Profiles link. The Ingest Profiles administration page will open displaying the ingest profiles that have been created for your account.
  3. Click the delete icon () next to the ingest profile or click the profile name and then click Delete Profile.
  4. Confirm the deletion by clicking Delete Profile.

Selecting a default ingest profile

A default ingest profile can be configured for when videos are uploaded and when clipping using the Social module. The upload default profile is indicated with next to the profile name. The social clipping default profile is indicated with next to the profile name.

To select a default ingest profile for uploading/clipping:

  1. Click the ADMIN link in the Studio header.
  2. Click the Ingest Profiles link. The Ingest Profiles administration page will open displaying the ingest profiles that have been created for the account.
  3. Click the ingest profile name for the profile you want to set as the default.
  4. Click the Uploading or Social clipping link at the top of the page to set current profile as the default.

Note: When selecting a default ingest profile you should ensure that the profile is visible and not hidden.

Note: Only Dynamic Delivery profiles can be set to be a social clipping default profile. Legacy and CAE profiles are not supported.

Hiding and showing ingest profiles

Ingest profiles can be hidden by clicking the slider associated with the profile to the Hide position. This is useful to hide default profiles that may not be needed.

Ingest profiles that are hidden will not appear in the Ingest Profile list in the Upload module. Note in this example that the high-resolution profile is not displayed.