Video Playback Configuration and Troubleshooting

Last update: May 13, 2024

CREATED FOR:

  • Intermediate
  • Developer

When you upload a video to the DAM and add it to your channel, you might encounter issues in which the video may not play in the AEM Screens Player.

The following sections describe how to debug and troubleshoot video playing in your channel.

DAM Renditions

After you upload the video to the channel, AEM should start creating some renditions for it. You can view your videos under Assets.

To view the video:

  1. Navigate to your video, for example http://localhost:4502/assets.html/content/dam/we-retail/en/videos.
  2. Click the video and expand the top-left menu and click Renditions.

There should be different renditions (an MP4 or M4V).

If there is no rendition, make sure you have FFMPEG installed on the OS where AEM is running.

CAUTION
If there is no rendition, make sure you have FFMPEG installed on the OS where AEM is running.
Click here to install FFMPEG.

Video Assets

If you do not see a source attribute under video, it could be that the video did not get trans-coded. If the video is transcoded properly, it appears in the dashboard, as shown in the following:

Check that FFMPEG is installed and the video profiles.

chlimage_1-2

Checking Video Profile

  1. Navigate to the Video Profile, that is, http://localhost:4502/etc/dam/video.html and click Upload Test Video.

    chlimage_1-3

  2. Upload a test video and click Ok so you can begin the transcoding.

    If the transcoded video fails, expand the FFMPEG output to understand any errors in the console output of FFMPEG.

    chlimage_1-4

    Also, if the video transcodes successfully can download the transcoded file.

    chlimage_1-5

    NOTE
    Make sure you give sufficient time for the video to transcode (it should show the new tag instead of processing) before you add it to any channel.

Checking Profile with a Video Component

Check the list of profiles from the page design if the video component is not configured properly.

  1. Navigate to your channel and click the Design mode.

    chlimage_1-6

  2. Click the video and open the Edit dialog. Open the Profiles tab.

    NOTE
    Click different profiles (at least the “High Quality H.264” profile should be there).

Checking the Video in the Web Player

Use the Web Player http://localhost:4502/content/mobileapps/cq-screens-player/firmware.html/content/screens/we-retail/locations/demo/flagship/single/device0 to validate playback in browsers (Chrome and Safari). Chrome is used on Android™ devices while Safari is the OS X and iOS browser.

If the video does not run on Safari, it does not run in the OS X and iOS players either. This issue is likely an encoding issue and the video must be re-encoded.

To use a DAM workflow to create FullHD renditions, do the following:

  1. Navigate to the workflow model admin that is http://localhost:4502/libs/cq/workflow/admin/console/content/models.html/etc/workflow/models.
  2. Click the Screens Update Asset model.
  3. Click Start Workflow from the action bar.
  4. From the Run Workflow dialog box, click your video asset in the Payload.
  5. Click Run.
NOTE
Allow some time to create the renditions, but after a few seconds/minutes (depends on video size), reload the web player on Safari.