DocumentationAEM 6.4Assets Guide

Dynamic Media video profiles video-profiles

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
  • User
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Dynamic Media already comes with a predefined Adaptive Video Encoding profile. The settings in this out-of-the-box profile are optimized to give your customers the best viewing experience possible. When you encode your master videos using the Adaptive Video Encoding profile, during playback the video player automatically adjusts the quality of the video stream based on the Internet connection speed of your customers. This is known as adaptive streaming.

The following are other factors that determine the quality of your videos:

  • Resolution of the uploaded master video

    If the MP4 video was recorded at a lower resolution, such as 240p or 360p, it cannot be streamed in high definition.

  • Video player size

    By default, the Width in the Adaptive Video Encoding profile is set to Auto. Again, during playback, the best quaility is used based on the size of the player.

See also Best Practices for Video Encoding.

NOTE
To generate a video’s metadata and associated video image thumbnails, the video itself needs to go through the encoding process in Dynamic Media. In AEM, the Dynamic Media Encode Video workflow encodes video if you have enabled dynamic media and set up video cloud services. This workflow captures workflow process history and failure information.
See Monitoring video encoding and YouTube publishing progress. If you have enabled Dynamic Media and set up video cloud services, the Dynamic Media Encode Video workflow automatically takes effect when you upload a video. (If you are not using dynamic media, the DAM Update Asset workflow takes effect.)
Metadata is useful when you are searching for assets. The thumbnails are static video images that are generated during encoding. They are required by the AEM system and used in the user interface to help you visually identify videos in the Cards View, Search Results view, and the Asset List view. You can see the generated thumbnails when you tap the Renditions icon (a painter’s palette) of an encoded video.

When you are done creating the video profile, you apply it to a folder or mutliple folders. See Applying a video profile to folders.

To define advanced processing parameters for other asset types, see Configuring Asset Processing.

Adaptive Video Encoding Presets adaptive-video-encoding-presets

The following table identifies best practice encoding profiles for adaptive video streaming to mobile and tablet devices, and desktop computers. You can use these presets for any aspect ratio video.

Video Format Codec
Video Size- Width (px)
Video Size- Height (px)
Keep Aspect Ratio?
Video Bitrate (Kbps)
Video Frame Rate (Fps)
Audio Codec
Audio Bitrate (Kbps)
MP4 H.264 (mp4)
auto
360
Yes
730
30
Dolby HE-AAC
128
MP4 H.264 (mp4)
auto
540
Yes
2000
30
Dolby HE-AAC
128
MP4 H.264 (mp4)
auto
720
Yes
3000
30
Dolby HE-AAC
128

Creating a Dynamic Media video encoding profile for adaptive streaming creating-a-video-encoding-profile-for-adaptive-streaming

Dynamic Media already comes with a predefined Adaptive Video Encoding profile–a group of video upload settings for MP4 H.264–that is optimized for the best viewing experience. You can use this profile when you upload your videos.

However, if this predefined profile does not meet your needs, you can choose to create your own adaptive video encoding profile. When you use the setting Encode for adaptive streaming–a best practice– all encoding presets that you add to the profile are validated to ensure that all videos have the same aspect ratio. In addition, the encoded videos are treated as a multi-bitrate set for streaming.

When you create the video encoding profile, you will notice that most encoding options are pre-populated with recommended default settings to help you. However, if you select a value other than the recommended default, be aware that it may result in poor video quality during playback and other performance issues.

So, for all MP4 H.264 video encoding presets in the profile, the following values are validated to ensure that they are the same across individual encoding presets in the profile, thereby making adaptive streaming possible:

  • Video Format Codec - MP4 H.264 (.mp4)
  • Audio Codec
  • Audio Bitrate
  • Keep Aspect Ratio
  • Two Pass Encoding
  • Constant Bitrate
  • H264 Profile
  • Audio Sampling Rate

If the values are not the same, you can continue creating the profile as is. However, be aware that adaptive streaming will not be possible. Instead, users will experience single-bitrate streaming. It is recommended that you edit the encoding settings to use the same values across individual encoding presets in the profile. (Note that the video profile/preset editor should enforce parity of the adaptive video encoding settings if Encode for adaptive streaming is enabled.)

See also Creating a video encoding profile for progressive streaming.

See also Best Practices for Video Encoding.

To define advanced processing parameters for other asset types, see Configuring Asset Processing.

When you are done creating the video profile, you apply it to a folder or multiple folders.

To create a Dynamic Media video encoding profile for adaptive streaming:

  1. Tap or click the AEM logo and navigate to Tools > Assets > Video Profiles.

  2. Tap Create to add a new video profile.

  3. Enter a name and description for the profile.

  4. Ensure that Encode for adaptive streaming is checked (default).

  5. Tap Add Video Encoding Preset.

  6. On the Basic tab, set the video and audio options.

    Tap the information icon next to each option for additional descriptions or recommended settings based on the selected video format codec.

  7. Under the Video Size heading, ensure that Keep aspect ratio is checked.

  8. Set the video frame size resolution in pixels. Use the Auto value to automatically scale to match the source aspect ratio (width to height ratio). For example, Auto x 480 or 640 x Auto.

    Do one of the following:

    • In the Width field, enter auto. In the Height field, enter a value in pixels.
    • To help you visualize the size of the video, tap the Information icon (i) to the right of Height to open the Size Calculator page. Use Size Calculator to set the video dimensions (represented by the blue box) you want. Tap X in the upper-right corner when you are done.

  9. (Optional) Tap the Advanced tab and ensure the Use Default Values check box is selected (recommended). Alternatively, modify advanced video and audio settings.

  10. In the upper-right corner of the page, tap Save to save the preset.

  11. Do one of the following:

    • Repeat steps 5-10 to create additional encoding presets. (Adaptive video streaming requires more than one video preset.)
    • In the upper-right corner of the page, tap Save again to save the profile.

Monitoring the Progress of an encoding job monitoring-the-progress-of-an-encoding-job

A processing indicator (or progress bar) is displayed so you can visually monitor the progress of a video encoding job.

You can also view the error.log file to monitor the progress of an encoding job, to see if encoding is finished, or to see any job errors. The error.log is found in the logs folder where your instance of AEM is installed.

Creating a Dynamic Media video encoding profile for progressive streaming creating-a-video-encoding-profile-for-progressive-streaming

If you choose not to use the option Encode for adaptive streaming, be aware that all encoding presets that you add to the profile are treated as individual video renditions for single-bitrate streaming or progressive video delivery. Also, there is no validation to ensure that all the video renditions have the same aspect ratio.

Depending on which mode you are running, the supported video format codecs are the following:

  • Dynamic Media-Scene7 mode: H.264 (.mp4)
  • Dynamic Media-Hybrid mode: H.264 (.mp4), WebM

See also Creating a video encoding profile for adaptive streaming.

See also Best Practices for Video Encoding.

To define advanced processing parameters for other asset types, see Configuring Asset Processing.

When you are done creating the video profile, you apply it to a folder or multiple folders.

To create a Dynamic Media video encoding profile for progressive streaming:

  1. Tap the AEM logo and navigate to Tools > Assets > Video Profiles.

  2. Tap Create to add a new video profile.

  3. Enter a name and description for the profile.

  4. Clear the Encode for adaptive streaming check box.

  5. Tap Add Video Encoding Preset.

  6. On the Basic tab, set the video and audio options.

    Tap the Information icon next to each option for additional descriptions or recommended settings based on the selected video format codec.

  7. (Optional) Under the Video Size heading, uncheck Keep aspect ratio.

  8. In the Width field, enter auto; to the right of the Height field, tap the Information icon. Use the Size Calculator page to further set the video dimension (blue box) how you want. Tap X when you are done.

  9. (Optional) Do one of the following:

    • Tap the Advanced tab, and make sure the Use Default Values check box is selected (recommended).

    • Clear the Use Default Values check box and specify the video settings and audio settings you want.

      Tap the Information icon next to each option for additional descriptions or recommended settings based on the selected video format codec.

  10. In the upper-right corner of the page, tap Save to save the preset.

  11. Do one of the following:

    • Repeat steps 5-10 to create additional encoding presets.
    • In the upper-right corner of the page, tap Save to save the profile.

Using custom-added video encoding parameters using-custom-added-video-encoding-parameters

You can edit an existing video encoding profile to take advantage of advanced video encoding parameters that are not found in the user interface when you create or edit a Video Profile in AEM. You custom add one or more advanced parameters—such as minBitrate and maxBitrate—to your existing profile.

To use custom-added video encoding parameters:

  1. Tap the AEM logo, then navigate to Tools > General > CRXDE Lite.

  2. From the CRXDE Lite page, in the Explorer panel on the left, navigate to the following:

    /conf/global/settings/dam/dm/presets/video/*name_of_video_encoding_profile_to_edit*

  3. In the panel on the lower-right side of the page, from the Properties tab, specify the Name, Type, and Value of the parameter you want to use.

    The following advanced parameters are available to use:

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 html-authored no-header
    Name Description Type Value
    h264Level H.264 level to use for encoding. Normally this is automatically determined based on the encoding settings you are using. String

    10 * h264 level

    For example, 3.0 = 30, 1.3 = 13)

    No default value.
    keyframe The target number of frames between keyframes. Calculate this value to generate a keyframe every 2-10 seconds. For example, at 30 frames per second, the keyframe interval should be 60-300.

    Lower keyframe intervals improve stream seeking and stream switching behavior for adaptive video encodings and may also improve the quality for videos that have lot of motion. However, because keyframes increase a file's size, a lower keyframe interval usually results in lower overall video quality at a given bitrate.    		 String

    Positive number.

    Default is 300.

    Recommended value for HLS (HTTP Live Streaming) is 60-90.
    minBitrate

    Minimum bitrate to allow for variable bitrate encodings, in Kbps (kilobits per second).

    This parameter only applies when Use Constant Bitrate is deselected in the Advanced tab when you create or edit a video encoding profile.

    See also Bitrate.

    		 String

    Positive number, in Kbps.

    No default value.
    maxBitrate

    Maximum bitrate to allow for variable bitrate encodings, in Kbps.

    This parameter only applies when Use Constant Bitrate is deselected in the Advanced tab when you create or edit a video encoding profile.

    See also Bitrate.

    		 String

    Positive number, in Kbps.

    No default value. However, the recommended value is up to two times of the encoding bitrate.
    audioBitrateCustom Set value to true to force a constant bitrate for the audio stream, if supported by audio codec. String

    true/false

    Default is false.

    Recommended value for HLS (HTTP Live Streaming) is false.

    chlimage_1-516

  4. Near the lower-right corner of the page, tap Add.

  5. Do one of the following:

    • Repeat steps 3 and 4 to add another parameter to your video encoding profile.
    • Near the upper-left corner of the page, tap Save All.

  6. In the upper-left corner of the CRXDE Lite page, tap the Back Home icon to return to AEM.

Editing a Dynamic Media video encoding profile editing-a-video-encoding-profile

You can edit any video encoding profile that you have created to add, edit, or delete video presets within that profile.

By default, you cannot edit the predefined, out-of-the-box Adaptive Video Encoding profile that came with Dynamic Media. Instead, you can easily copy the profile and save it with a new name. You can then edit the desired presets in the copied profile.

See also Best Practices for Video Encoding.

To define advanced processing parameters for other asset types, see Configuring Asset Processing.

To edit a Dynamic Media video encoding profile:

  1. Tap the AEM logo and navigate to Tools > Assets > Video Profiles.

  2. On the Video Profiles page, check one video profile name.

  3. On the toolbar, tap Edit.

  4. On the Video Encoding Profile page, edit the name and description, as desired.

  5. As a best practice, ensure that the Encode for adaptive streaming check box is selected.

    Tap the information icon for a description of adaptive streaming. (If you are editing a progressive video profile, do not select this check box.)

  6. Under the Video Encoding Presets heading, add, edit, or delete video encoding presets that make up the profile.

    Tap the Information icon next to each option on the Basic and Advanced tabs for additional descriptions or recommended settings based on the selected video format codec.

  7. In the upper-right corner of the page, tap Save.

Copying a Dynamic Media video encoding profile copying-a-video-encoding-profile

  1. Tap the AEM logo and navigate to Tools > Assets > Video Profiles.

  2. On the Video Profiles page, check one video profile name.

  3. On the toolbar, tap Copy.

  4. On the Video Encoding Profile page, enter a new name for the profile.

  5. As a best practice, ensure that the Encode for adaptive streaming check box is selected. Tap the information icon for a description of adaptive streaming. (If you are copying a progressive video profile, do not select the check box.)

    In Dynamic Media - Hybrid mode, if a WebM video preset is part of the video profile, then Encode for adaptive streaming is not possible because all presets must be MP4.

  6. Under the Video Encoding Presets heading, add, edit, or delete video encoding presets that make up the profile.

    Tap the Information icon next to each option on the Basic and Advanced tabs for recommended settings and descriptions.

  7. In the upper-right corner of the page, tap Save.

Deleting a Dynamic Media video encoding profile deleting-a-video-encoding-profile

  1. Tap the AEM logo and navigate to Tools > Assets > Video Profiles.
  2. On the Video Profiles page, check one or more video profile names.
  3. On the toolbar, tap Delete.
  4. Tap OK.

Applying a Dynamic Media video profile to folders applying-a-video-profile-to-folders

When you assign a video profile to a folder, any subfolders automatically inherit the profile from its parent folder. This means that you can assign only one video profile to a folder. As such, consider carefully the folder structure of where you upload, store, use, and archive assets.

If you assigned a different video profile to a folder, the new profile overrides the previous profile. The previously existing folder assets remain unchanged. The new profile is applied on the assets that are added to the folder later.

Folders that have a profile assigned to it are indicated in the user interface by the name of the profile appearing in the card name.

chlimage_1-517

You can apply video profiles to specific folders or globally to all assets.

Applying video profiles to specific folders applying-video-profiles-to-specific-folders

You can apply a video profile to a folder from within the Tools menu or if you are in the folder, from the Properties. This section describes how to apply video profiles to folders both ways.

Folders that have a profile already assigned to it are indicated by the display of the profile’s name directly below the folder name.

Applying Dynamic Media video profiles to folders from Profiles user interface applying-video-profiles-to-folders-from-profiles-user-interface

  1. Tap the AEM logo and navigate to Tools > Assets > Video Profiles.
  2. Select the video profile that you want to apply to a folder or multiple folders.
  3. Tap Apply Profile to Folder(s) and select the folder or multiple folders you want use to receive the newly uploaded assets and tap Apply. Folders that have a profile already assigned to it are indicated by the display of the profile’s name directly below the folder name.

Applying Dynamic Media video profiles to folders from Properties applying-video-profiles-to-folders-from-properties

  1. Tap the AEM logo and navigate to Assets and then to the folder that you want to apply a video profile to.

  2. On the folder, tap the check mark to select it and then tap Properties.

  3. Select the Video Profiles tab and select the profile from the drop-down menu and tap Save & Close. Folders that have a profile already assigned to it are indicated by the display of the profile’s name directly below the folder name.

    chlimage_1-518

Applying a Dynamic Media video profile globally applying-a-video-profile-globally

In addition to applying a profile to a folder, you can also apply one globally so that any content uploaded into AEM assets in any folder has the selected profile applied.

To apply a Dynamic Media video profile globally:

  1. Navigate to CRXDE Lite to the following node: /content/dam/jcr:content.
  2. Add the property videoProfile: /etc/dam/video/dynamicmedia/<name_of_video_encoding_profile>
  3. Tap Save All.

chlimage_1-519

Removing a Dynamic Media video profile from folders removing-a-video-profile-from-folders

When you remove a video profile from a folder, any subfolders automatically inherit the removal of the profile from its parent folder. However, any processing of files that has occurred within the folders remains intact.

You can remove a video profile from a folder from within the Tools menu or if you are in the folder, from the Folder Settings. This section describes how to remove video profiles from folders both ways.

Removing Dynamic Media video profiles from folders by way of Profiles user interface removing-video-profiles-from-folders-via-profiles-user-interface

  1. Tap the AEM logo and navigate to Tools > Assets > Video Profiles.

  2. Select the video profile that you want to remove from a folder or multiple folders.

  3. Tap Remove Profile from Folder(s) and select the folder or multiple folders you want use to remove the profile from and tap Remove.

    You can confirm that the video profile is no longer applied to a folder because the name no longer appears below the folder name.

Removing Dynamic Media video profiles from folders by way of Properties removing-video-profiles-from-folders-via-properties

  1. Tap the AEM logo and navigate to Assets and then to the folder that you want to remove a video profile from.
  2. On the folder, tap the check mark to select it, then tap Properties.
  3. Select the Video Profiles tab and select None from the drop-down menu and tap Save & Close. Folders that have a profile already assigned to it are indicated by the display of the profile’s name directly below the folder name.
recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad