Kickstart Guide kickstart-guide
The kickstart to AEM Screens demonstrates how to set up and run an AEM Screens project. It walks you through setting up a basic digital signage experience and adding content such as assets and/or videos to each channel and further publishing the content to an AEM Screens Player.
Prerequisites prerequisites
Follow the steps below to create a sample project for AEM Screens and further publish content to the Screens player.
You must enable the empty referrer to allow the device to post data to the server. For example, if the empty referrer property is disabled, the device cannot post a screenshot back. Currently some of these features are only available if the Apache Sling Referrer Filter Allow Empty is enabled in the OSGi Configuration. The dashboard may display a warning that security settings may prevent some of these features from working.
Follow the steps below to enable the Apache Sling Referrer Filter Allow Empty:
Allow Empty Referrer Requests allow-empty-referrer-requests
-
Navigate to ÃÛ¶¹ÊÓƵ Experience Manager Web Console Configuration by way of AEM instance > hammer icon > Operations > Web Console.
-
ÃÛ¶¹ÊÓƵ Experience Manager Web Console Configuration opens. Search for sling referrer.
For searching the sling referrer property, press Command+F for Mac and Control+F for Windows.
-
Check the Allow Empty option, as shown in the figure below.
-
Click Save to enable the Apache Sling Referrer Filter Allow Empty.
Creating a Digital Signage Experience in 5 minutes creating-a-digital-signage-experience-in-minutes
Creating an AEM Screens Project creating-project
The first step is to create an AEM Screens project.
-
Navigate to your ÃÛ¶¹ÊÓƵ Experience Manager (AEM) instance and click Screens. Alternatively, you can navigate directly from
https://localhost:4502/screens.html/content/screens](https://localhost:4502/screens.html/content/screens
. -
Click Create Screens Project so you can create a Screens project.
-
Enter the title as DemoScreens, then click Save.
note note NOTE After you create the project, it brings you back to the AEM Screens Project home page. You can now click your project. In a project, there are five different folders titled Applications, Channels, Devices, Locations, and Schedules.
Creating a Channel creating-channel
After you have created your AEM Screens project, create a channel where you manage the content.
Follow the steps below to create a channel for your project:
-
After you create a project, click the DemoScreens project and click the Channels folder, as shown in the figure below. Click + Create from the action bar.
-
Choose the Sequence Channel from the wizard and click Next.
-
Enter the Title as TestChannel and click Create.
The TestChannel is now added to your channels folder, as shown in the figure below.
Adding Content to a Channel adding-content
When you have your channel in place, add content to your channel that AEM Screens Player can display.
Follow the steps below to add content to the channel (TestChannel) in your project:
-
Navigate to the DemoProject you created and click the TestChannel from the Channels folder.
-
Click Edit from the action bar (see the figure below). The editor for the TestChannel opens.
-
Click the icon that toggles the side panel on the left-hand side of the action bar to open the assets and components.
-
Drag and drop the components you want to add to your channel.
Creating a Location creating-location
When you have your channel in place, create a location.
Follow the steps below to create a location for your project:
- Navigate to the DemoProject you created and click the Locations folder.
- Click + Create from the action bar.
- Click Location from the wizard and click Next.
- Enter the Name for your location (enter the title as TestLocation) and click Create.
The TestLocation is created and added to your Locations folder.
Creating a Display for Location creating-display
When you have created a location, create a display for your location.
-
Navigate to the TestLocation and click it.
-
Click Create from the action bar.
-
Click Display from the Create wizard and click Next.
-
Enter the Title as LobbyDisplay and click Create.
A new display titled as TestDisplay is now added to your location TestLocation, as shown in the figure below.
Assigning a Channel assigning-channel
When the project setup is complete, assign the channel to a display to view the content.
-
Navigate to the required display from DemoScreens > Locations > TestLocation > LobbyDisplay.
-
Click Assign Channel from the action bar.
Or,
Click Dashboard from the action bar and click +Assign Channel from the ASSIGNED CHANNELS & SCHEDULES panel.
-
The Channel Assignment dialog box opens.
-
From the Settings option, choose the channel by path and Supported Events such as Initial Load and Idle Screen.
note note NOTE The Channel Role, Priority, and Interruption Methods are all populated by default. See the Channel Properties section for more information about channel assignment properties. Also, you can click the Activation Window and Recurrence Schedule.
note note NOTE The Recurrence Schedule lets you set a recurring schedule for your channel. You can set up multiple recurrence schedules for a channel.
See Recurrence Schedule for more details. -
Click Save once you have configured your preferences.
Registering a Device and Assigning Device to a Display registering-device
Register your device using the AEM dashboard.
- Click to download the latest Chrome Player.
- Unzip and save it on disk.
- Open the Chrome browser and click Extensions from the menu or directly navigate to chrome://extensions.
- Switch on the Developer mode from the top-right corner.
- Click Load Unpacked from the top-left corner and load unzipped Chrome Player.
- Check AEM Screens Chrome Player plugin if it is available in the list of extensions.
- Open a new tab and click the Apps icon from the top-left corner, or directly navigate to chrome://apps.
- Click AEM Screens Plugin so you can launch Chrome Player. By default, the player is launched in full screen mode. Press Esc to exit full screen mode.
After your Chrome OS player is on, follow the steps below to register a Chrome device.
-
Navigate to the Devices folder of your project from your AEM instance.
-
Click the Device Manager from the action bar.
-
Click the Device Registration from the top right.
-
Click the required device and click Register Device.
-
Wait for the device to send its registration code and simultaneously check the Registration Code from your Chrome device.
-
If the Registration Code is the same on both machines, click Validate in AEM.
-
Set the desired name as ChromeDeviceforDemo for the device, and click Register.
-
Click Assign Display from the Device Registration Successful dialog box.
-
Click the path to your display as DemoScreens > Locations > TestLocation > LobbyDisplay and click Assign.
-
When the device is successfully assigned, you see the following confirmation.
-
Click Finish to complete the registration process. You can now view your registered device from the display dashboard.
Viewing the Content in Chrome Player viewing-content-output
All the assets in your channel are now playing on your Chrome OS player.
Congratulations you are now playing content in an AEM Screens channel!