Video in Dynamic Media video
This section describes working with video in Dynamic Media.
Quick Start: Videos quick-start-videos
The following step-by-step workflow description is designed to help you get up and running quickly with adaptive video sets in Dynamic Media. After each step, there are cross-references to topic headings where you can find more information.
-
See Configure Dynamic Media Cloud Services in Configuring Dynamic Media - Scene7 mode and Troubleshoot Dynamic Media - Scene7 mode.
-
See Configure Dynamic Media Cloud Services in Configuring Dynamic Media - Hybrid mode.
- If a published video is updated, it must be published again to reflect changes on delivery.
-
Upload your Dynamic Media videos by doing the following:
-
Create your own video encoding profile. Or, you can simply use the predefined Adaptive Video Encoding profile that comes with Dynamic Media.
- Create a video encoding profile.
- Learn more about Best practices for video encoding.
-
Associate the video processing profile to one or more folders where you are going to upload your primary source videos.
- Apply a video profile to folders.
- Learn more about Best practices for organizing your digital assets for using processing profiles.
- Learn more about Organize digital assets.
-
Upload your primary source videos to the folders. When you add videos to the folder, they are encoded according to the video processing profile that you assigned to the folder.
- Dynamic Media supports primarily short-form videos with a maximum length of 30 minutes and a minimum resolution that is greater than 25 x 25.
- You can upload video files that are up to 15 GB each.
- Upload your videos.
- Learn more about Supported input file formats.
-
Monitor how video encoding is progressing either from the asset or workflow view.
-
-
Manage your Dynamic Media videos by doing any of the following:
-
Organize, browse, and search video assets
-
Preview and publish video assets
-
View the source video and encoded renditions of the video along with its associated thumbnails:
Preview videos or Preview assets
View video renditions
Manage video renditions
-
-
Work with video metadata
-
View the properties of an encoded video rendition such as frame rate, audio and video bitrate, and codec:
View video rendition properties -
Edit the properties of video such as the title, description, and tags, custom metadata fields:
Edit video properties
-
-
Review, approve, and annotate videos, and maintain full version control
-
-
Publish your Dynamic Media videos by doing one of the following:
-
If you use 蜜豆视频 Experience Manager as your web content management system, you can add videos directly to your web pages.
-
If you are using a third-party web content management system, you can link or embed videos to your web pages.
-
Integrate video using URL:
Link URLs to your web application. -
Integrate video using embed code on a web page:
Embed the video viewer on a web page.
-
-
Work with video in Dynamic Media working-with-video-in-dynamic-media
Video in Dynamic Media is an end-to-end solution that makes it easy to publish high-quality Adaptive Video for streaming across multiple screens, including desktop, iOS, Android鈩, 叠濒补肠办叠别谤谤测庐, and Windows mobile devices. An Adaptive Video Set groups versions of the same video that are encoded at different bit rates and formats such as 400 kbps, 800 kbps, and 1000 kbps. The desktop computer or mobile device detects the available bandwidth.
For example, on an iOS mobile device, it detects a bandwidth such as 3G, 4G, or Wi-Fi. Then, it automatically selects the right encoded video from among the various video bit rates within the Adaptive Video Set. The video is streamed to desktops, mobile devices, or tablets.
In addition, video quality is dynamically switched automatically if network conditions change on the desktop or on the mobile device. Also, if a customer enters full-screen mode on a desktop, the Adaptive Video Set responds by using a better resolution, improving the customer鈥檚 viewing experience. Using Adaptive Video Sets provides you with the best possible playback for customers playing Dynamic Media video on multiple screens and devices.
The logic that a video player uses to determine which encoded video to play or to select during playback is based on the following algorithm:
-
The video player loads the initial video fragment based on the bit rate that is closest to the value that is set for 鈥渋nitial bitrate鈥 in the player itself.
-
Video player switches based on changes to the bandwidth speed using the following criteria:
- The player picks the highest bandwidth stream below or equal to the estimated bandwidth.
- Player considers only 80% of the available bandwidth. However, if it is switching up, it is more conservative at only 70% to avoid overestimating and immediately switching back.
For detailed technical information about the algorithm, see
For managing single video and Adaptive Video Sets, the following is supported:
-
Uploading video from numerous-supported video formats and audio formats and encoding video to MP4 H.264 format for playback across multiple screens. You can use predefined adaptive video presets, single video encoding presets, or customize your own encoding to control the quality and size of the video.
- When an adaptive video set is generated, it includes MP4 videos.
- Note: Master/source videos are not added to an Adaptive Video Set.
-
Video captioning in all HTML5 video viewers.
-
Organize, browse, and search video with full metadata support for efficient management of video assets.
-
Deliver Adaptive Video Sets to the web and to desktops and mobile devices, including the iPhone, iPad, Android鈩, 叠濒补肠办叠别谤谤测庐, and Windows phone.
Adaptive video streaming is supported on various iOS platforms. See Dynamic Media Viewers Reference Guide.
Dynamic Media supports mobile video playback for MP4 H.264 video.
You can find Windows devices that support this video format at the following:
-
Play back the video using Dynamic Media Video Viewer Presets, including the following:
- Single video viewers.
- Mixed Media viewers that combine both video and image content.
-
Configure video players to meet your branding needs.
-
Integrate video to your website, mobile site, or mobile application with a simple URL or embed code.
See also Viewers for Experience Manager Assets and Dynamic Media Classic and Viewers for Experience Manager assets only.
Best practice: Using the HTML5 video viewer best-practice-using-the-html-video-viewer
The Dynamic Media HTML5 Video viewer presets are robust video players. You can use them to avoid many common issues that are associated with HTML5 video playback. And, issues associated with mobile devices such as lack of adaptive bitrate streaming delivery and limited desktop browser reach.
On the design side of the player, you can design the video player鈥檚 functionality using standard web development tools. For example, you can design the buttons, controls, and custom poster image background using HTML5 and CSS to help you reach your customers with a customized appearance.
On the playback side of the viewer, it automatically detects the browser鈥檚 video capability. It then serves the video using HLS (HTTP Live Streaming) or DASH (Dynamic Adaptive Streaming over HTTP) , also known as adaptive bitrate streaming. Or, if those delivery methods are not present then HTML5 progressive is used instead.
By combining into a single player the following:
- The ability to design the playback components using HTML5 and CSS
- Have embedded playback
- Use adaptive and progressive streaming depending on the browser鈥檚 capability
You extend the reach of your rich media content to both desktop and mobile users and ensure a streamlined video experience.
See also About HTML5 Viewers.
Playback of video on desktop computers and mobile devices using the HTML5 video viewer playback-of-video-on-desktop-computers-and-mobile-devices-using-the-html-video-viewer
For desktop and mobile adaptive video streaming, the videos used for bit rate switching are based on all MP4 videos in the Adaptive Video Set.
Video playback occurs using either DASH or HLS, or progressive video download. In prior versions of Experience Manager, such as 6.0, 6.1, and 6.2, videos were streamed over HTTP.
In Experience Manager 6.3 and on, videos are now streamed over HTTPS (that is, DASH or HLS) because the DM gateway service URL always uses HTTPS as well. There is no customer impact in this default behavior. That is, video streaming always occurs over HTTPS unless it is not supported by the browser. (See the following table). Therefore,
- If you have an HTTPS website with HTTPS video streaming, streaming is fine.
- If you have an HTTP website with HTTPS video streaming, streaming is fine and there are no mixed content issues from the web browser.
DASH is the international standard and HLS is an Apple standard. Both are used for adaptive video streaming. And, both technologies automatically adjust playback based on network bandwidth capacity. It also lets the customer 鈥渟eek鈥 to any point in the video without the need to wait for the rest of the video to download.
Progressive video is delivered by downloading and storing the video locally on a user鈥檚 desktop system or mobile device.
The following table describes the device, browser, and playback method of videos on desktop computers and mobile devices using the Dynamic Media Video Viewer.
Architecture of Dynamic Media video solution architecture-of-dynamic-media-video-solution
The following graphic shows the overall authoring workflow of videos that are uploaded and encoded by way of DMGateway (in Dynamic Media Hybrid mode) and made available for public consumption.
Hybrid publishing architecture for videos hybrid-publishing-architecture-for-videos
Best practices for encoding videos best-practices-for-encoding-videos
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. 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.)
Source video files source-video-files
When you encode a video file, use a source video file of the highest possible quality. Avoid using previously encoded video files because these files are already compressed, and further encoding creates a subpar quality video.
- Dynamic Media supports primarily short-form videos with a maximum length of 30 minutes and a minimum resolution that is greater than 25 x 25.
- You can upload primary source video files that are up to 15 GB each.
The following table describes the recommended size, aspect ratio, and minimum bit rate that your source video files must have before you encode them:
Obtain a file鈥檚 metadata obtaining-a-file-s-metadata
You can obtain a file鈥檚 metadata by viewing its metadata using a video editing tool, or using an application designed for obtaining metadata. Following are instructions for using MediaInfo, a third-party application, to obtain a video file鈥檚 metadata:
- Go to .
- Select and download the installer for the GUI version, and follow the installation instructions.
- After installation, either right-click the video file (Windows only) and select MediaInfo, or open MediaInfo and drag your video file into the application. You see all metadata associated with your video file, including its width, height, and fps.
Aspect ratio aspect-ratio
When you choose or create a video encoding preset for your primary source video file, make sure that the preset has the same aspect ratio as the primary source video file. The aspect ratio is the ratio of the width to the height of the video.
To determine the aspect ratio of a video file, obtain the file鈥檚 metadata and note the file鈥檚 width, and height (see Obtaining a file鈥檚 metadata above). Then use this formula to determine the aspect ratio:
width/height = aspect ratio
The following table describes how formula results translate to common aspect ratio choices:
For example, a video that is 1440 width x 1080 height has an aspect ratio of 1440/1080, or 1.33. In this case, you choose a video encoding preset with a 4:3 aspect ratio to encode the video file.
Bitrate bitrate
Bitrate is the amount of data that is encoded to make up a single second of video playback. The bitrate is measured in kilobits per second (Kbps).
When selecting a bitrate encoding, there are two types you can choose:
-
Constant Bitrate Encoding (CBR) - During CBR encoding, the bitrate, or the number of bits per second is kept the same throughout the encoding process. CBR encoding persists the set data rate to your setting over the entire video. Also, CBR encoding does not optimize media files for quality but does save on storage space.
Use CBR if your video contains a similar motion level throughout the entire video. CBR is most commonly used for streaming video content. See also Use custom-added video encoding parameters. -
Variable Bitrate Encoding (VBR) - VBR encoding adjusts the data rate down and to the upper limit that you set, based on the data required by the compressor. This functionality means that during a VBR encoding process the bitrate of the media file dynamically increases or decreases depending on the media files bitrate needs.
VBR takes longer to encode but produces the most favorable results; the quality of the media file is superior. VBR is most commonly used for http progressive delivery of video content.
When do you use VBR versus CRB?
When selecting VBR versus CBR, it is almost always recommended that you use VBR for your media files. VBR provides higher-quality files at competitive bitrates. When you use VBR, be sure you use with two-pass encoding, and set the maximum bitrate to be 1.5x the target video bitrate.
When you choose a video encoding preset, remember the target end user鈥檚 connection speed. Choose a preset with a data rate that is 80 percent of that speed. For example, if the target end user鈥檚 connection speed is 1000 Kbps, the best preset is one with a video data rate of 800 Kbps.
This table describes the data rate of typical connection speeds.
Resolution resolution
Resolution describes a video file鈥檚 height and width in pixels. Most source video is stored at a high resolution (for example, 1920 x 1080). For streaming purposes, source video is compressed to a smaller resolution (640 x 480 or smaller).
Resolution and data rate are two integrally linked factors that determine video quality. To maintain the same video quality, the higher the number of pixels in a video file (the higher the resolution), the higher the data rate must be. For example, consider the number of pixels per frame in a 320 x 240 resolution and a 640 x 480 resolution video file:
The 640 x 480 file has four times more pixels per frame. To achieve the same data rate for these two example resolutions, you apply four times the compression to the 640 x 480 file, which can reduce the quality of the video. Therefore, a video data rate of 250 Kbps produces high-quality viewing at a 320 x 240 resolution, but not at a 640 x 480 resolution.
In general, the higher data rate you use, the better your video looks, and the higher resolution you use, the higher data rate you must maintain viewing quality (compared to lower resolutions).
Because resolution and data rate are linked, you have two options when encoding video:
- Choose a data rate and then encode at the highest resolution that looks good at the data rate you chose.
- Choose a resolution and then encode at the data rate necessary to achieve high-quality video at the resolution you chose.
When you choose (or create) a video encoding preset for your primary source video file, use this table to target the correct resolution:
Fps (Frames per second) fps-frames-per-second
In the United States and Japan, most video is shot at 29.97 frames per second (fps); in Europe, most video is shot at 25 fps. Film is shot at 24 fps.
Choose a video encoding preset that matches the fps rate of your primary source video file. For example, if your primary source video is 25 fps, choose an encoding preset with 25 fps. By default, all custom encoding uses the primary source video file鈥檚 fps. For this reason, you do not need to explicitly specify the fps setting when you create a video encoding preset.
Video encoding dimensions video-encoding-dimensions
For optimal results, select encoding dimensions such that the source video is a whole multiple of all your encoded videos.
To calculate this ratio, you divide source width by encoded width to get the width ratio. Then, you divide source height by encoded height to get the height ratio.
If the resulting ratio is a whole integer, it means that the video is optimally scaled. If the resulting ratio is not a whole integer, it impacts video quality by leaving leftover pixel artifacts on the display. This effect is most noticeable when the video has text.
As an example, suppose that your source video is 1920 x 1080. In the following table, the three encoded videos provide the optimal encoding settings to use.
Encoded video file format encoded-video-file-format
Dynamic Media recommends using MP4 H.264 video encoding presets. Because MP4 files use the H.264 video codec, it provides high-quality video but in a compressed file size.
Enable DASH, multiple caption and audio track support on your Dynamic Media account enable-dash
About enabling DASH on your account
DASH (Digital Adaptive Streaming over HTTP) is the international standard for video streaming and is widely adopted across different video viewers. When DASH is enabled on your account, you get the option to choose from either DASH or HLS for adaptive video streaming. Or, you can opt for both with automatic switching between players when auto is selected as the playback type in the Viewer preset.
Some key benefits from enabling DASH on your account include the following:
- Package DASH stream video for adaptive bitrate streaming. This method leads to higher efficiency of delivery. Adaptive streaming ensures the best viewing experience for your customers.
- Browser optimized streaming with Dynamic Media players switches between HLS and DASH streaming to ensure the best quality of service. The video player auto-switches to HLS when a Safari browser is used.
- You can configure your preferred streaming method (HLS or DASH) by editing the video viewer preset.
- Optimized video encoding ensures that no additional storage is used while enabling DASH capability. A single set of video encodes are created for both HLS and DASH to optimize video storage costs.
- Helps make video delivery more accessible for your customers.
- Get the streaming URL by way of APIs, too.
Enabling DASH on your account requires two steps:
- Configuring Dynamic Media to use DASH which you can easily do yourself.
- Configuring Experience Manager 6.5 to use DASH which is done by way of an 蜜豆视频 Customer Support case that you create and submit.
About enabling multiple caption and audio track support on your account
At the same time you create an 蜜豆视频 Support case to have DASH enable on your account, you also benefit from having multiple caption and audio track support automatically enabled. After enablement, all subsequent videos that you upload are processed with a new backend architecture that includes support for adding multiple caption and audio tracks to your videos.
To enable DASH, multiple caption and multiple audio track support on your Dynamic Media account:
-
Begin by configuring Dynamic Media for DASH - From Experience Manager, navigate to Tools > Operations > Web Console.
-
From the 蜜豆视频 Experience Manager Web Console Configuration page, scroll to the name AEM Assets Dynamic Media Video Advanced Streaming Feature Flag.
-
To the left of the name, select the checkbox to enable (turn on) DASH.
-
Select Save.
-
Now .
-
To create a support case, follow the instructions while ensuring you provide the following information:
- Primary contact name, email, phone.
- Name of your Dynamic Media account.
- Specify that you want DASH, multiple caption and multiple audio track support enabled on your Dynamic Media account, on Experience Manager 6.5.
-
蜜豆视频 Customer Support adds you to the customer Wait List based on the order in which requests are submitted.
-
When 蜜豆视频 is ready to handle your request, Customer Support contacts you to coordinate and set a target date for enablement.
-
You are notified after completion by Customer Support.
-
Now you can do either one of the following:
- Create your video viewer preset as usual.
- Add multiple caption and audio tracks to your video.
View video reports viewing-video-reports
Video Reports display several aggregate metrics across a specified time to help you monitor that published individual and aggregate videos are performing as expected. The following top metrics data are aggregated for all published videos across your entire website:
- Video Starts
- Completion Rate
- Average time on video
- Total time on video
- Videos per visit
A table of all published videos is also listed so you can track the top viewed videos on your website based on total video starts.
When you select a video name in the list, it shows you the video鈥檚 audience retention (drop-off) report in the form of a line chart. The chart displays the number of views for any given moment of time during video playback. When you play the video, the vertical bar tracks in synchronization with the time indicator in the player. Drops in the line chart data indicate where your audience drops off from disinterest.
If the video was encoded outside of 蜜豆视频 Experience Manager Dynamic Media, the audience retention (drop-off) chart and the Play Percentage data in the table are not available.
See also Configure Dynamic Media Cloud Services.
By default, the first time you enter Video Reports, the report displays video data starting at the first of the current month and ends with the current month鈥檚 date. However, you can override the default date range by specifying your own date range. The next time you enter Video Reports, the date range you specified is used.
For video reports to work correctly, a Report Suite ID is automatically created when Dynamic Media Cloud Services is configured. At the same time, the Report Suite ID is pushed to the Publish server so that it is available for the Copy URL feature when you preview assets. However, this functionality requires that the Publish server is already set up. If the Publish server is not set up, you can still publish to see the video report. However, you must return to the Dynamic Media Cloud Configuration and select OK.
To view video reports:
-
In the upper-left corner of Experience Manager, select the Experience Manager logo, then in the left rail, select Tools (hammer icon) > Assets > Video Reports.
-
On the Video Reports page, do one of the following:
-
Near the upper-right corner, select the Refresh Video Report icon.
Use Refresh only if the end date of the report is the current day. Doing so ensures that you see the video tracking that has occurred since the last time you ran the report. -
Near the upper-right corner, select the Date Picker icon.
Specify the beginning and end date range for which you want video data, and then select Run Report.
The Top Metrics group box identifies various aggregate measurements for all published videos across your site.
-
-
In the table that lists the top published videos, select a video name to play the video and also see the video鈥檚 audience retention (drop-off) report.
View video reports based on a video viewer that you created using the Dynamic Media HTML5 Viewer SDK viewing-video-reports-based-on-a-video-viewer-that-you-created-using-the-scene-hmtl-viewer-sdk
If you use an out-of-box video viewer provided by Dynamic Media, or if you created a custom viewer preset based off an out-of-box video viewer, then no additional steps are required to view video reports. However, if you have created your own video viewer based off the HTML5 Viewer SDK API, then use the following steps to ensure that your video viewer is sending tracking events to Dynamic Media Video Reports.
Use the 蜜豆视频 Dynamic Media Viewers Reference Guide and the to create your own video viewers.
To view video reports based on a video viewer that you created using the Dynamic Media HTML5 Viewer SDK:
-
Navigate to any published video asset.
-
Near the upper-left corner of the asset鈥檚 page, from the drop-down list, select Viewers.
-
Select any video viewer preset and copy the embed code.
-
In the embed code, find the line with the following:
videoViewer.setParam("config2", "<value>");
The
config2
parameter enables tracking in HTML5 Viewers. It is also a company-specific preset that contains the configuration information for Video Reporting, and for customer-specific 蜜豆视频 Analytics configurations.The correct value for the config2 parameter is found in both the Embed Code and in the copy URL function. In the URL from the copy URL command, the parameter to look for is
&config2=<value>
. The value is almost alwayscompanypreset
, but in some instances it can also becompanypreset-1
,companypreset-2
, and so forth. -
In your custom video viewer code, add AppMeasurementBridge .jsp to the viewer page by doing the following:
-
First, determine if you need the
&preset
parameter.If the
config2
parameter iscompanypreset
, you do not need&preset=parameter
.If
config2
is anything else, set the preset parameter the same as theconfig2
parameter. For example, ifconfig2=companypreset-2
, add¶m2=companypreset-2
to the AppMeasurmentBridge.jsp URL. -
Then, add the AppMeasurementBridge.jsp script:
<script language="javascript" type="text/javascript" src="https://s7d1.scene7.com/s7viewers/AppMeasurementBridge.jsp?company=robindallas&preset=companypreset-2"></script>
-
-
Create the TrackingManager component by doing the following:
-
After you call
s7sdk.Util.init();
, create a TrackingManager instance to track events by adding the following:var trackingManager = new s7sdk.TrackingManager();
-
Connect components to TrackingManager by doing the following:
In the
s7sdk.Event.SDK_READY
event handler, attach the component you want to track to the TrackingManager.For example, if the component is
videoPlayer
, addtrackingManager.attach(videoPlayer);
to attach the component to the trackingManager. To track multiple viewers on a page, use multiple tracking manager components.
-
Create the AppMeasurementBridge object by adding the following:
code language-none var appMeasurementBridge = new AppMeasurementBridge(); appMeasurementBridge.setVideoPlayer(videoPlayer);
-
Add the tracking function by adding the following:
code language-none trackingManager.setCallback(appMeasurementBridge.track, appMeasurementBridge);
The appMeasurementBridge object has a built-in track function. However, you can provide your own to support multiple tracking systems or other functionality.
-
About multiple caption and audio track support for videos in Dynamic Media about-msma
With multiple caption and audio track capability in Dynamic Media, you can easily add multiple subtitles and audio tracks to a primary video. This capability means that your videos are accessible across a global audience. You can customize a single, published primary video to a global audience in multiple languages and adhere with accessibility guidelines for different geographical regions. Authors can also manage the subtitles and audio tracks from a single tab in the user interface.
Some of the use cases to consider for adding multiple caption and audio tracks to your primary video include the following:
All video formats supported in Dynamic Media and all Dynamic Media video viewers鈥攅xcept the Dynamic Media Video_360 viewer鈥攁re supported for use with multiple caption and audio tracks.
Multiple caption and audio track capability is available for your Dynamic Media account by way of a feature toggle that must be enabled (turned on) by 蜜豆视频 Customer Support.
Add multiple caption and audio tracks to your video add-msma
Before you add multiple caption and audio tracks to your video, be sure you already have the following in-place:
- Dynamic Media is set up in an AEM environment.
- A Dynamic Media Video profile is applied to the folder where your videos are ingested.
- Multiple caption and audio track is enabled on your Dynamic Media account.
Added captions and captions are supported with WebVTT and 蜜豆视频 VTT formats. And, added audio track files are supported with MP3 format.
To add multiple caption and audio tracks to your video:
-
Upload your primary video to a folder that already has a video profile assigned to it.
-
Navigate to the uploaded video asset that you want to add multiple caption and audio tracks.
-
In asset selection mode, either from the List View or the Card View, select the video asset.
-
On the toolbar, select the Properties icon (a circle with an 鈥渋鈥 in it).
Selected video asset in Card view. -
On the video鈥檚 Properties page, select the Captions & Audio Tracks tab.
note tip TIP If you do not see the Captions & Audio Tracks tab, it means either one of two things: - The folder in which the selected video resides does not have a video profile assigned to it. In which case, see Apply a video profile to the folder.
- Or, the video must be reprocessed by Dynamic Media. In which case, see Reprocess assets in a folder.
When you have completed either one of the above tasks, return to these steps. Captions and Audio Tracks tab on the video鈥檚 Properties page.
-
(Optional) To add one or more caption files to a video, do the following:
-
Select Upload Captions.
-
Navigate to, and select, one or more .vtt (Video Text Tracks) files and open them.
-
For captions to be visible on the media player, you must add required details (metadata) about each caption file that you uploaded. Select the pencil icon to the right of a caption file name. In the Edit Caption dialog box, enter the following required details about the file, then select Save. Repeat this process for each caption file that you uploaded:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Caption metadata Description Filename The default filename is derived from the original filename. The filename can be changed only while uploading and cannot be changed later. Filename character requirements are the same as for AEM Assets.
The same filename cannot be used for additional caption files and audio track files.Language Select the language of the caption. Type Select the type of caption that you are using.
Subtitle 鈥 The caption text displayed with the video that translates or transcribes the dialogue.
Caption 鈥 The caption text also includes background noises, speaker differentiation, and other relevant information, along with the translation or transcription of the dialogue, making the content more accessible for individuals who are deaf or hard of hearing.Label The text that is displayed for the caption鈥檚 name in the Select audio or subtitle pop-up list in the media player. The label is what a customer sees that corresponds to a subtitle or caption track. For example, English (CC)
.You can change or edit caption metadata later, if necessary. When the video is published, these details are reflected on public URLs in published videos.
-
-
(Optional) To add one or more audio tracks to a video, do the following:
-
Select Upload Audio Tracks.
-
Navigate to, and select, one or more .mp3 files and open them.
-
For audio tracks to be visible in the Select audio or caption pop-up list on the media player, you must add required details about each audio track file that you added. Select the pencil icon to the right of an audio track file name. In the Edit Audio Track dialog box, enter the following required details, then select Save. Repeat this process for each audio track file that you uploaded.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Audio Track metadata Description Filename The default filename is derived from the original filename. The filename can be changed only while uploading and cannot be changed later. Filename character requirements are the same as for AEM Assets.
The same filename cannot be used for additional audio track files or caption files.Language Select the language of the audio track. Type Select the type of audio track that you are using.
Original 鈥 The audio track originally attached to the video and represented as[Original]
in the label withEnglish
language selected by default. While Label and Language can be changed in the Edit Audio Track dialog box, it defaults to the original values if the primary video is reprocessed.
Standard 鈥 An add-on audio track for a language other than the original.
Audio description 鈥 An audio track that also includes a descriptive narration of non-verbal actions and gestures in the video, making content more accessible for individuals who are visually impaired.Label The text that is displayed as the audio track鈥檚 name in the Select audio or subtitle pop-up list in the media player. The label is what a customer sees that corresponds to an audio track. For example, English [Original]
. The label of audio attached to a video is set to[Original]
by default.You can change or edit this audio track metadata later, if necessary. When the video is published, these details are reflected on public URLs in published videos.
-
-
In the upper-right corner of the page, from the Save & Close drop-down list, select Save. The files are uploaded and metadata processing begins, as seen in the Status column of the interface.
note note NOTE Based on the caching settings of your instance, the metadata processing can take several minutes before it is reflected in preview and in published URLs. -
(Optional) If you selected Save & Close in the previous step, instead of selecting Save, you can still view the processing status of the uploaded files. See View the lifecycle status of uploaded caption and audio track files.
-
(Optional) Preview the video before publishing to ensure the captions and audio work as expected. See Preview a video that has multiple caption and audio tracks
-
Publish the video. See Publish assets.
About adding caption and audio track files to a video that is already published
When you upload additional caption files or audio track files to a video that is already published, it means that those files will have a Processed
status after they are prepared, following upload. At that point, you can preview the video in Dynamic Media to see or hear the newly uploaded files.
Following preview, however, you must publish the video again for the newly added caption or audio track files to be published, too. After publishing, the captions or audio becomes available with the public Dynamic Media URL.
In the scenario where you have configured Dynamic Media for immediate publish, the uploading of additional caption or audio files immediately triggers a publish of the video following the upload of caption or audio files.
Add multiple captions to a video that has an existing URL with caption modifier
Dynamic Media supports the addition of a single caption with video by way of a URL modifier. See Add captions to video.
Multiple caption changes take precedence over a caption added by way of a URL modifier for published videos.
To add multiple captions to a video that has an existing URL with caption modifier:
- Upload the caption file that is already added as a modifier to the video, so you can manage the file explicitly.
- Upload any additional caption files, as necessary.
- Publish the video as usual.
The existing URL with the caption modifier can now load multiple captions.
View the lifecycle status of uploaded caption and audio track files lifecycle-status-video
You can observe the lifecycle status of any caption or audio track file uploaded to your primary video from the Captions & Audio Tracks tab of Properties.
To view the lifecycle status of a video:
- Navigate to the video asset whose lifecycle status you want to view.
- In asset selection mode, either from the List View or the Card View, select the video asset.
- On the toolbar, select the Properties icon (a circle with an 鈥渋鈥 in it).
- On the Properties page, select the Captions & Audio Tracks tab. In the Status column, note the state of each caption or audio file.
Lifecycle status of each uploaded caption and audio track file.
Set the default audio for a video that has multiple audio tracks
By default, a video鈥檚 original audio is set as the default audio to be played.
However, any uploaded audio track files can be set as the default audio to play after a video is loaded into the viewer. In the Properties user interface, under the Captions & Audio Tracks tab, the Default
label is applied to the right of the audio track file for video playback.
- Chrome鈥擳he default audio that is set in the video, is played.
- Safari鈥擨f the default language is set in Safari, audio is played with the set default language, if available with the video鈥檚 manifest. Otherwise, the default audio that is set as part of a video鈥檚 properties is played.
To set the default audio for a video that has multiple audio tracks:
-
Navigate to the video asset whose default audio track you want to set.
-
In asset selection mode, either from the List View or the Card View, select the video asset.
-
On the toolbar, select the Properties icon (a circle with an 鈥渋鈥 in it).
-
On the Properties page, select the Captions & Audio Tracks tab.
-
Under the Audio Tracks heading, select the audio track file that you want to set as the video鈥檚 default.
-
Select Set as default.
In the Set as default dialog box, select Replace.Setting the default audio track for a video.
-
In the upper-right corner, select Save & Close.
-
Publish the video. See Publish assets.
Preview a video that has multiple caption and audio tracks preview-video-audio-subtitle
After caption files and audio track files are uploaded to a video and processed, you can use the Dynamic Media video viewer (or other viewer types, if desired) to preview all the different tracks. Previewing helps you to see what your video looks and sounds like to customers and ensures that it is behaving as expected.
When you are satisfied with the video, you can publish it using any one of the following methods.
See Embed the Video or Image Viewer on a Web Page.
See Link URLs to your web application. The URL-based method of linking is not possible if your interactive content has links with relative URLs, particularly links to Experience Manager Sites pages.
See Add Dynamic Media Assets to pages.
To preview a video that has multiple captions and audio tracks:
-
In Assets, navigate to an existing video that you have added multiple captions and audio tracks.
-
Click the video asset so you can open it in preview mode.
-
On the preview page, near the upper-left corner of the page, select the drop-down list, then select Viewers.
-
From the Viewers list, select a viewer that you want to use for the video preview. As an example, the following screenshot shows the Video viewer being selected.
-
Near the lower-right corner, to the left of the volume icon, select the speech bubble icon, then select the audio or caption you want to hear, or see or both. If desired, under Captions, you can select Off to not display any captions.
Simulation of a user selecting the audio and caption for video playback.
-
To begin playback, select the video鈥檚 Play button.
Note the URL and Embed buttons in the lower-left corner. Use these buttons to link the video鈥檚 URL to your web application or to embed the video on a Web Page, respectively. -
Near the upper right corner of the preview page, select Close.
Delete caption or audio track files from a video
You can delete caption or audio track files from a video. Deletion of published caption or audio track files is automatically reflected in the video鈥檚 published URL.
The original audio track extracted from a primary video cannot be deleted.
To delete caption or audio track files from a video:
-
Navigate to the video asset whose default audio track you want to set.
-
In asset selection mode, either from the List View or the Card View, select the video asset.
-
On the toolbar, select the Properties icon (a circle with an 鈥渋鈥 in it).
-
On the Properties page, select the Captions & Audio Tracks tab.
-
Do either one of the following:
- Captions鈥擴nder the Captions heading, select one or more caption files that you want to delete from the video, then select Delete.
- Audio Tracks鈥擴nder the Audio Tracks heading, select one or more audio track files that you want to delete from the video, then select Delete.
-
In the Delete dialog box, select OK.
-
Publish the video.
Download caption or audio track files that were uploaded to a video
You can download one or more caption or audio track files that you uploaded for use with a video. You have the option of either downloading all selected files as a .zip, or creating a separate download folder for each file.
The original audio track extracted from a primary file cannot be downloaded.
To download caption or audio track files from a video:
-
Navigate to the video asset whose default audio track you want to set.
-
In asset selection mode, either from the List View or the Card View, select the video asset.
-
On the toolbar, select the Properties icon (a circle with an 鈥渋鈥 in it).
-
On the Properties page, select the Captions & Audio Tracks tab.
-
Do either one of the following:
- Captions鈥擴nder the Captions heading, select one or more caption files that you want to download from the video, then select Download.
- Audio Tracks鈥擴nder the Audio Tracks heading, select one or more audio track files that you want to download from the video, then select Download.
-
In the Download dialog box, set the following options:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Option Description Save As Use the default file name specified in the Save As text field, or specify your own name. Create a separate folder for each asset Create a folder for each caption file or audio track file that you selected for download. Email Use your default email program to send the .zip file to a specified email address. Assets Specifies the number of files that you are downloading and the combined total size of all selected files. Deselecting this option dims (turns off) the Download button, preventing you from downloading any file. -
Select Download.
-
Publish the video. See Publish assets.
Add closed captions to a video adding-captions-to-video
You can extend the reach of your videos to global markets by adding closed captioning to single videos or to Adaptive Video Sets. By adding closed captioning, you avoid the need to dub the audio, or the need to use native speakers to rerecord the audio for each different language. The video is played in the language that it was recorded. Foreign language captions appear so that people of different languages can still understand the audio portion.
Closed captioning also allows for greater accessibility by people who are deaf or hard of hearing.
See also Accessibility in Dynamic Media.
Dynamic Media converts caption files to JSON (JavaScript Object Notation) format. This conversion means you can embed the JSON text into a web page as a hidden but complete transcript of the video. Search engines can then crawl and index the content to make the videos more easily discoverable and give customers additional details about the video content.
See Serve static (non-image) contents in the Dynamic Media Image Serving and Rendering API Help for more information about using the JSON function in a URL.
To add closed captions to a video:
-
Use a third-party application or service to create your video caption file.
Ensure the file that you create follows the WebVTT (Web Video Text Tracks) standard. The captioning filename extension is .vtt. You can learn more information about the WebVTT captioning standard.
See .
There are many websites that offer both free and premium tools and services that you can use to author WebVTT caption/caption files outside Dynamic Media.
Follow the onscreen instructions from a site to author and save your WebVTT file. When you have finished, copy the caption file contents and paste it into a plain text editor and save it with a
.vtt
filename extension.note note NOTE For global support of video captions in multiple languages, the WebVTT standard requires that you create separate .vtt files and calls for each language you want to support. Generally, you want to name the caption VTT file the same name as the video file, and append it with the language locale, such as -EN, -FR, or -DE. By doing so, it can help you with automating the generation of the video URLs using your existing web content management system.
-
In Experience Manager, upload your WebVTT caption file into DAM.
-
Navigate to the published video asset that you want to associate with the caption file that you uploaded.
Remember that URLs are only available to copy after you have first published the assets.
See Publish assets.
-
Do one of the following:
-
For a pop-up video viewer experience, select URL. In the URL dialog box, select and copy the URL to the Clipboard and then past the URL into a simple text editor. Append the copied URL of the video with the following syntax:
&caption=<server_path>/is/content/<path_to_caption.vtt_file,1>
Note the
,1
at the end of the caption path. Immediately following the.vtt
filename extension in the path, you can optionally enable (turn on) or disable (turn off) the closed caption button on the video player bar by setting to,1
or,0
, respectively. -
For an embedded video viewer experience, select Embed Code. In the Embed Code dialog box, select, and copy the embed code to the Clipboard and then paste the code into a simple text editor. Append the copied embed code with the following syntax:
videoViewer.setParam("caption","<path_to_caption.vtt_file,1>");
Note the
,1
at the end of the caption path. Immediately following the.vtt
filename extension in the path, you can optionally enable (turn on) or disable (turn off) the closed caption button on the video player bar by setting to,1
or,0
, respectively.
-
Add chapter markers to video adding-chapter-markers-to-video
You can make your long-form videos easier to watch and navigate by adding chapter markers to single videos or to Adaptive Video Sets. When a user plays the video, they can click the chapter markers on the video timeline (also known as the video scrubber) to easily navigate to their point of interest. Or, they can immediately jump to new content, demonstrations, and tutorials.
If desired, you can create and brand your own custom video viewer with chapters instead of using a video viewer preset. For instructions on creating your own HTML5 viewer with chapter navigation, in the 蜜豆视频 HTML5 Viewer SDK API, reference the heading 鈥淐ustomizing Behavior Using Modifiers鈥 under the classes s7sdk.video.VideoPlayer
and s7sdk.video.VideoScrubber
. See the documentation.
You create a chapter list for your video in much the same way that you create captions. That is, you create a WebVTT file. Note, however, that this file must be separate from any WebVTT caption file that you are also using; you cannot combine captions and chapters into one WebVTT file.
You can use the following sample as an example of the format you use to create a WebVTT file with chapter navigation:
WebVTT file with video chapter navigation webvtt-file-with-video-chapter-navigation
WEBVTT
Chapter 1
00:00.000 --> 01:04.364
The bicycle store behind it all.
Chapter 2
01:04.364 --> 02:00.944
Creative Cloud.
Chapter 3
02:00.944 --> 03:02.937
Ease of management for a working solution.
Chapter 4
03:02.937 --> 03:35.000
Cost-efficient access to rapidly evolving technology.
In the example above, Chapter 1
is the cue identifier and is optional. The cue time of 00:00:000 --> 01:04:364
specifies the start time and end time of the chapter, in 00:00:000
format. That last three digits are milliseconds and can be left as 000
, if preferred. The chapter title of The bicycle store behind it all
is the actual description of the chapter鈥檚 contents. The cue identifier, the starting cue time, and the chapter title all appear in a video player pop-up when a user hovers their mouse pointer over a visual cue point in the video鈥檚 timeline.
Because you are using an HTML5 video viewer, ensure that the chapter file you create follows the WebVTT (Web Video Text Tracks) standard. The chapter filename extension is .vtt
. You can learn more information about the WebVTT captioning standard.
See
To add video chapter navigation:
-
Save the
.vtt
file in UTF8 encoding so you avoid problems with character rendition in the chapter title text.Generally, you want to name the chapter VTT file the same name as the video file, and append it with chapters. By doing so, it can help you with automating the generation of the video URLs using your existing web content management system.
-
In Experience Manager, upload your WebVTT chapter file.
See Uploading Assets.
-
Do one of the following:
table 0-row-2 1-row-2 html-authored no-header For a pop-up video viewer experience - Navigate to the published video asset that you want to associate with the chapter file that you uploaded. Remember that URLs are only available to copy after you have first published the assets. See Publishing Assets.
- From the drop-down menu, then click Viewers.
- In the left rail, click the video viewer preset name. A preview of the video is opened in a separate page.
- In the left rail, at the bottom, click URL.
- In the URL dialog box, select and copy the URL to the Clipboard, then past the URL into a simple text editor.
- Append the copied URL of the video with the following syntax so you can associate it with the copied URL to your chapter file:
&navigation=<full_copied_URL_path_to_chapter_file.vtt>
For an embedded video viewer experience - Navigate to the published video asset that you want to associate with the chapter file that you uploaded. Remember that URLs are only available to copy after you have first published the assets. See Publishing Assets.
- From the drop-down menu, then click Viewers.
- In the left rail, click the video viewer preset name. A preview of the video is opened in a separate page.
- In the left rail, at the bottom, click Embed.
- In the Embed Code dialog box, select, and copy the entire code to the Clipboard, then paste it into a simple text editor.
- Append the embed code of the video with the following syntax so you can associate it with the copied URL to your chapter file:
videoViewer.setParam("navigation","<full_copied_URL_path_to_chapter_file.vtt>"
About video thumbnails in Dynamic Media - Scene7 mode about-video-thumbnails-in-dynamic-media-scene-mode
A video thumbnail is a reduced-size version of a video frame or an image asset representing the video to the customer. The thumbnail serves to encourage a customer to select the video.
All videos in Experience Manager must have an associated thumbnail; you cannot delete a thumbnail without replacing it. By default, when you upload a video to Experience Manager, the first frame is used as the thumbnail. However, you can customize the thumbnail for branding purposes or visual search, for example. When you customize a video thumbnail, you can play the video and pause on the frame you want to use. Or, you can select an image asset that you have already uploaded and published in your digital asset manager.
A custom video thumbnail image that you select from a video is not extracted and saved in the DAM as a separate and distinct asset. However, a custom video thumbnail that you select from an existing image asset is saved to the JCR. The path of the selected asset gets stored under the video asset鈥檚 node as in the following example path:
/content/dam/*<folder_name*>/<*video_name*>/jcr:content/manualThumbnail
The ability to customize a video thumbnail is only available after you have applied a video profile to the folder where the video is located.
See also About video thumbnails in Dynamic Media - Hybrid mode.
Add a custom video thumbnail adding-a-custom-video-thumbnail
These steps apply only to Dynamic Media running in 鈥淒ynamicmedia_Scene7鈥 mode.
To add a custom video thumbnail:
-
Be sure you have already done the following:
-
Created a folder for your video assets.
-
-
Navigate to an uploaded video asset whose thumbnail image you want to change.
-
In asset selection mode either from List View or Card View, select the video asset.
-
On the toolbar, select the Properties icon (a circle with an 鈥渋鈥 in it).
-
On the video鈥檚 Properties page, select Change Thumbnail.
-
On the Change Thumbnail page, do one of the following:
-
To use a frame from the video as the new thumbnail:
- On the toolbar, select Select Frame from video.
- Select the Play button, then select the Pause button on the frame you want to capture as the video鈥檚 new thumbnail.
-
To use an image asset as the new thumbnail:
- On the toolbar, select Select Thumbnail from Assets.
- Select Select Thumbnail.
- Navigate to a previously uploaded and published image asset that you want to use. The asset is automatically resized to serve as a thumbnail image for the video.
- Select the image asset, then select Select.
-
-
On the Change Thumbnail page, select Save Change.
-
On the video鈥檚 Properties page, in the upper-right corner, select Save & Close.
About video thumbnails in Dynamic Media - Hybrid mode about-video-thumbnails-in-dynamic-media-hybrid-mode
You can choose from one of ten thumbnail images automatically generated by Dynamic Media to add to your video. The video player displays your selected thumbnail when a video asset is used with the Dynamic Media component in the authoring environment of Experience Manager Sites, Experience Manager Mobile, or Experience Manager Screens. The thumbnail serves as a static picture that best represents the contents of your entire video and further encourages users to click the Play button.
Based on the total time of the video, Dynamic Media captures ten (default) thumbnail images. The images are captured at 1%, 11%, 21%, 31%, 41%, 51%, 61%, 71%, 81%, and 91% into the video. The ten thumbnails persist meaning that if you decide to choose a different thumbnail later on, you do not need to regenerate the series. You preview the ten thumbnail images and then select the one you want to use with your video. If you want to change to the default, you can use CRXDE Lite to configure the time interval that thumbnail images are generated. For example, if you only wanted to generate a series of four evenly spaced thumbnail images from your video, you can configure the interval time at 24%, 49%, 74%, and 99%.
Ideally, you can add a video thumbnail anytime after you upload your video but before you publish the video on your website.
If you prefer, you can choose to upload a custom thumbnail to represent your video instead of using a thumbnail generated by Dynamic Media. For example, you could create a custom thumbnail image that has the title of your video, an eye-catching opening image, or a specific image captured from your video. The custom video thumbnail image that you upload must have a maximum resolution of 1280 x 720 pixels (minimum width of 640 pixels) and be no larger than 2 MB.
See also About video thumbnails in Dynamic Media - Scene7 mode.
Add a video thumbnail adding-a-video-thumbnail
These steps apply only to Dynamic Media running in Hybrid mode.
To add a video thumbnail:
-
Navigate to an uploaded video asset that you want to add a video thumbnail.
-
In asset selection mode either from the List View or the Card View, select the video asset.
-
On the toolbar, select the View Properties icon (a circle with an 鈥渋鈥 in it).
-
On the video鈥檚 Properties page, select Change Thumbnail.
-
On the Change Thumbnail page, on the toolbar, select Select Frame.
Dynamic Media generates a series of thumbnail images from your video, based on the default time interval or time interval you customized.
-
Preview the generated thumbnail images, then select the one you want to add to your video.
-
Select Save Change.
The video鈥檚 thumbnail image is updated to use the thumbnail you selected. If you later decide to change the thumbnail image, you can return to the Change Thumbnail page and select a new one.
If you configured new default time intervals, or you uploaded a new video to replace the existing video, have Dynamic Media regenerate the thumbnails.
See Configure the default time interval that video thumbnails are generated.
Configure the default time interval that video thumbnails are generated configuring-the-default-time-interval-that-video-thumbnails-are-generated
When you configure and save the new default time interval, your change automatically applies only to videos that you upload in the future. It does not automatically apply the new default to videos that you previously uploaded. For existing videos, you must regenerate the thumbnails.
To configure the default time interval that video thumbnails are generated:
-
In Experience Manager, select Tools > General > CRXDE Lite.
-
In the CRXDE Lite page, in the directory panel on the left, navigate t
o etc/dam/imageserver/configuration/jcr:content/settings.
if the directory panel is not visible, select the >> icon to the left of the Home tab.
-
On the lower-right panel, in the Properties tab, double-select
thumbnailtime
. -
In the Edit thumbnailtime dialog box, use the text fields to enter interval values as percentages.
- Select the plus sign (+) icon if you want to add one or more interval value fields. If necessary, scroll to the bottom of the dialog box to see the icon.
- Select the minus sign (-) icon to the right of an interval value field if you want to delete it from the list.
- Select the up arrow icon and the down arrow icon if you want to reorder the interval values.
-
Select OK and return to the Properties tab.
-
Near the upper-left corner of the CRXDE Lite page, select Save All, then select the Back Home icon in the upper-left corner to return to Experience Manager.
Add a custom video thumbnail adding-a-custom-video-thumbnail-1
These steps apply only to Dynamic Media running in Hybrid mode.
To add a custom video thumbnail:
-
Navigate to an uploaded video asset that you want to add a custom video thumbnail.
-
In asset selection mode either from the List View or the Card View, select the video asset.
-
On the toolbar, select the View Properties icon (a circle with an 鈥渋鈥 in it).
-
On the video鈥檚 Properties page, select Change Thumbnail.
-
On the Change Thumbnail page, on the toolbar, select Upload New Thumbnail.
-
Navigate to a thumbnail image that you want to use, select it, then select Open to begin uploading the image into Experience Manager. Following the upload, be sure you publish the image.
-
After you have successfully uploaded and published the image, in the Change Thumbnail page, select Save Changes.
The custom thumbnail is added to your video.
Change the Dynamic Media URL for Dynamic Media assets manifest-urls
Videos processed into Dynamic Media can be used by way of out-of-the-box viewers and also by directly accessing the manifest URLs and playing them through your own custom viewers. The following is the API for fetching manifest URLs for a video.
About the getVideoManifestURI API
The getVideoManifestURI
API is exposed through cq-scene7-api:com.day.cq.dam.scene7.api
and can be used to generate the following manifest URLs:
/**
* Returns the manifest url for videos
* @param resource video resource
* @param manifestType type of video streaming manifest being requested
* @param onlyIfPublished return a manifest only if the video is published
* @return the manifest url for videos
*
* @throws Exception
*/
@Nullable
String getVideoManifestURI(Resource resource, ManifestType manifestType, boolean onlyIfPublished) throws Exception;
getVideoManifestURI API parameters
This API takes in the following three parameters:
resource
manifestType
ManifestType.DASH
or ManifestType.HLS
onlyIfPublished
To fetch the manifest URLs for videos using the method above, add a video encoding profile to an 鈥渦pload videos鈥 folder. Dynamic Media processes these videos based on the encodings found in the video encoding file that was assigned to the folder. Now you can invoke the above API for fetching manifest URLs for the uploaded videos.
Error scenarios
The API returns null if there are errors. Exceptions are logged in Experience Manager error logs. All such logged errors start with Could not generate Video Manifest URI
. The following scenarios can make such errors occur:
-
An
IllegalArgumentException
gets logged for any of the following:- The
resource
parameter passed is null. - The
resource
parameter passed is not a video. - The
manifestType
parameter passed is null. - The
onlyIfPublished
parameter is passed as true, but the video is not published. - The video was not ingested using an adaptive video set from Dynamic Media.
- The
-
IOException
gets logged when there is an issue connecting to Dynamic Media. -
UnsupportedOperationException
gets logged when amanifestType
parameter passed isManifestType.DASH
, while the video has not been processed using DASH format.
The following is an example of the above API using servlets written in HTTPWhiteBoard specification. Select each tab for the code syntax.
accordion | ||
---|---|---|
Add dependency in pom.xml | ||
|
accordion | ||
---|---|---|
Sample servlet | ||
|
accordion | ||
---|---|---|
Response Class for servlet | ||
|
accordion | ||
---|---|---|
Constants file referenced in servlet | ||
|
accordion | ||
---|---|---|
ServletContext | ||
Mount the above servlet using a
|
Use the sample servlet
You invoke the servlet by performing a GET
operation at /dmSample/dynamicmedia/video/manifestUrl
. The following query parameters are passed:
assetPath
manifestUrl
is generated.manifestType
onlyIfPublished
manifestUrl
is returned only if the video is published.In this example, let us assume the following setup:
- The company is
samplecompany
. - The authoring instance is
http://sample-aem-author.com
. - The folder
/content/dam/video-example
has a video encoding profile applied to it. - The video
scenery.mp4
is uploaded to the folder/content/dam/video-example
.
You can invoke the servlet in the following ways:
http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=HLS&assetPath=/content/dam/video-example/scenery.mp4
In case DASH delivery is enabled:
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.m3u8?packagedStreaming=true"}
In case DASH delivery is disabled:
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.m3u8"}
http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=DASH&assetPath=/content/dam/video-example/scenery.mp4
In case DASH delivery is enabled:
{"manifestUrl":"https://s7d1.scene7.com/is/content/samplecompany/scenery-AVS.mpd"}
In case DASH delivery is disabled:
{}
http://sample-aem-author.com/dmSample/dynamicmedia/video/manifestUrl?manifestType=DASH&assetPath=/content/dam/video-example/scennnnnnery.mp4
{"errorString":"could not retrieve the resource from JCR"}