Installing and Configuring Screens

You are reading the AEM 6.3 version of Configuring and Deploying Screens.
This documentation is also available for the following versions: 

This page shows how to install and configure the Screens players on your devices.

The AEM Screens players are available for iOS, OS X, and Android.

Note

To download AEM Screens Player, click here.

AEM Screens is also available in Google Play and iTunes App Store. 

file

Server Configuration

The following key points below helps to configure and AEM server to be ready to use for AEM Screens:

Allow Empty Referrer Requests

Follow the steps below to enable the Apache Sling Referrer Filter Allow Empty. This is required for optimal operation of the control protocol between AEM Screens Player and AEM Screens server.

  1. Navigate to Adobe Experience Manager Web Console Configuration
  2. Check the allow.empty option.
  3. Click Save.

AEM in NOSAMPLECONTENT runmode

Running AEM in production uses the NOSAMPLECONTENT runmode. Remove the the X-Frame-Options=SAMEORIGIN header (in the additional response header section) from

http://localhost:4502/system/console/configMgr/org.apache.sling.engine.impl.SlingMainServlet.

This is required for the AEM Screens Player to play online channels.

Password Restrictions

AEM Screens Player registration will fail, if the password restrictions are set.

Remove the following config to set it correctly,

http://localhost:4502/system/console/configMgr/org.apache.jackrabbit.oak.spi.security.user.action.DefaultAuthorizableActionProvider.

Dispatcher Configuration

For Dispatcher, add client headers to .any file. Allow the following headers through:

  • "X-Requested-With"
  • "X-SET-HEARTBEAT"
  • "X-REQUEST-COMMAND"

Java encoding

Set the Java encoding to Unicode. For example, Dfile.encoding=Cp1252 will not work.

Note

Recommendation:

It is recommended to use HTTPS for AEM Screens Server in production use.

AEM Screens Player for iOS

To install the Screens player on your iPad:

  1. Click iTunes App Store to download AEM Screens for iPad.

    file
  2. Once you install the AEM Screens player, you need to configure your Screens Player.

    file

To configure the player:

  1. Open the Settings for AEMScreensPlayer.

    file
  2. Change the URL field to contain the IP of your AEM server.

    Note

    The Device Id, User and Password will be filled by the registration process.

The resolution field allows you to set the resolution you would like to simulate on the iPad.

Note

If you leave the Resolution field empty, it will use the native resolution of the device.

AEM Screens Player for OS X

To install and configure the Screens player on your mac:

  1. Download OS X player from AEM Screens Player Downloads.

  2. Double-click on the DMG file and move AEMScreensPlayer to the Application folder.

  3. Start the application.

  4. Press Ctrl+Cmd+F to exit fullscreen mode.

  5. Click on AEMScreensPlayer and then Preferences.

    file
  6. Enter the URL of your AEM server.

    file

    Note

    The Device Id, User and Password will be filled by the registration process.

  7. Restart the player for the new preferences to be applied.

AEM Screens Player for Android

To install and configure the Screens player on your Android device:

  1. Download Android Player from AEM Screens Player Downloads.

  2. Install the application and tap DONE.

    file
  3. Find the AEM Settings widget and drag and drop it to the home screen.

    file
  4. Open the settings widget from the home screen and configure it accordingly.

    file

    Note

    The device id, User and Password will be filled by the registration process.

Device Registration

The devices registration process is done on 2 separate machines:

  • The actual device to be registered, for example your Signage Display
  • The AEM server that is used to register your device
  1. On your device, start the AEM Screens Player. The registration UI is shown.

    file
  2. In AEM, navigate to the Devices folder of your project.

    Note

    To get more information on creating a new project for Screens in the AEM dashboard, see Creating and Managing Screens Project.

     

  3. Tap/click the Device Manager button in the action bar.

    file
  4. Tap/click the Device Registration button on the top right.

    file
  5. Select the required device (same as step 1) and tap/click Register Device.

    file
  6. In AEM, wait for the device to send its registration code.

  7. In your device, check the Registration Code.

    file
  8. If the Registration Code is the same on both machines, tap/click Validate button in AEM.

    file
  9. Set the desired name for the device, and select Register button.

    file

    Note

    If you don't set a name, it will use its unique identifier as name.

  10. Tap/click Finish to complete the registration process .

    file

    Note

    The Go Back button would allow you to register a new device.

    The Assign Display button would let you directly add the device to a display.

In your device, the registration UI should be updated to show the device identifier.

file

In AEM, the device should be added to the list and remain unassigned. To learn how to assign it, see Device Assignment.

Before, you learn device assignment, it is recommended you have prior knowledge on how to:

file

Additional Resources

To learn about AEM Screens Player, see Working with Screens Player.

Any questions?

Have a question about this or any other AEM topic? Ask our Community.
Learn more about AEM topics on our help hub.
Was this helpful?

By submitting your feedback, you accept the Adobe Terms of Use.

Thank you for submitting your feedback.