Adaptive Renditions: Architectural Overview and Configurations adaptive-renditions

Introduction introduction

Adaptive Renditions allow the devices to automatically click the best rendition for a device based on customer-defined rules. The devices automatically download and play the most appropriate rendition of an asset based on these rules allowing customers to only focus on designing the main experience.

Objective objective

As an AEM Screens Developer, you can now configure device-specific asset renditions to be downloaded and played automatically without having to create all content variations manually. Configure the Adaptive Renditions before a content Author can use this feature in an AEM Screens channel.

Architectural Overview architectural-overview

Adaptive Renditions are based on the idea of having multiple renditions of an asset named following a specific naming convention. The decision to play a specific rendition is made by evaluating media query expressions that can only be resolved on devices with expected capabilities.

The ability of having an associated rendition naming pattern defines a rendition-mapping rule, such as portrait or landscape, as shown in the figure below. After computing all available expressions, the Screens player collects the naming patterns corresponding to the matching rules. The patterns are used to find the correct renditions during the sequence playback by looking for the patterns in the rendition names.


Adding Rendition Mapping Property to the Screens Project rendition-mapping-new

To enable the Adaptive Renditions feature, the following mapping rules should be present and the Context-Aware (CA) Configuration should be resolvable for channels and displays.

To learn more about Content-Aware Configurations, see here.

Follow the steps below to configure the setup:

  1. Navigate to CRXDE Lite. Check, if the rendition-mapping configuration exists in /conf/screens/sling:configs/rendition-mapping, as shown in the figure below.


    note important
    If you installed the latest Feature Pack 202109, you see the rendition-mapping node structure pre-populated in /conf/screens/sling:configs/rendition-mapping in CRXDE Lite. See Release Notes for Feature Pack 202109 to get details on the latest feature pack.
    For existing projects, ensure that Screens project has the rendition-mapping configuration associated. See Adding Rendition Mapping to an Existing Project section for more information.

Adding Rendition Mapping Property to an Existing Project rendition-mapping-existing

  1. Navigate to CRXDE Lite.

  2. Explicitly define the rendition-mapping association by adding sling:configRef property pointing at /conf/screens to the project content node, as shown in the figure below.


Adding Rendition Mapping Rules add-rendition-mapping-rules

Follow the steps below to add a node under Rendition Mapping:

  1. Navigate to this path /conf/screens/sling:configs/rendition-mapping from CRXDE Lite.

  2. Create a node under rendition-mapping. Right-click rendition-mapping and click Create > Create Node, as shown in the figure below.


  3. Enter the Name for your mapping rule such as rule1 and the node Type as nt:unstructured in Create Node dialog box. Click OK.


  4. Add the expression property with the value containing the query expression.

    note note
    See Using Media Query Syntax to learn more.

    Click rule1 that you created, and enter expression in Name and (orientation:landscape) in Value, as shown below. Click Add.


  5. Add the pattern property with the value containing the rendition naming pattern.

    note note
    The value defined in the pattern property is matched to the new asset rendition and is selected, if the expression is evaluated to true.

    To add the pattern property, click rule1 that you created, and enter pattern in Name and landscape in Value, as shown below. Click Add.


  6. Click Save All and notice the properties under the node you created under rendition-mapping.


The Next Steps next-steps

After you add rendition-mapping properties and rules, as a Content Author, you can configure your assets. You do this by using Adaptive Renditions and also migrate your devices for large networks to use this feature in your AEM Screens channels. See Using Adaptive Renditions in AEM Screens for more information.