How do I enable automatic alerts or classroom alerts on an AppleTV?

Your AppleTV Rise Vision displays can be set up to receive automatic alerts or classroom alerts from any service that supports CAP (Common Alerting Protocol). When an alert is received, scheduled content will be interrupted in order to show the override message on the screen for the specified duration. If Airplay is currently in use, it will be disabled in order to show the message.

Requirements

• AppleTVs must be enrolled using Jamf Pro
• Single App Mode must be be enabled

Refer to this article to learn how to enroll your AppleTV in Jamf Pro, install Rise Vision via that tool, and enable Single App Mode.

Step 1: Create a Device Group to allow overriding of AirPlay streams

This group will be used to define which devices have the AirPlay restrction.

1. Log in to Jamf Pro.
2. Choose "Devices" from the tabs on the top-left.
3. Select "Groups"
4. Select "Static Device Groups", and select "New".
5. Name this group "DisableAirPlay". Ensure there are no spaces between the words in the name.
   

Step 2: Configure profile for AirPlay restriction

This part of the configuration is the restricting action that will temporarily block AirPlay.

1. Return to "Devices" from the tabs on the top-left.
2. Select "Configuration Profiles"
3. On the right click "+ New" to create a new profile and name it "DisableAirPlay"
4. Scroll down to "Restrictions" and select "Functionality".
5. Toggle on "AirPlay incoming request" so that it says "Restrict".
6. From the top, select the "Scope" tab.
7. On the right select "+ Add".
8. From the "Add Deployment Targets" table, select "Mobile Device Groups", and then the "Add" button for the "DisableAirPlay" group made in Step 1.
9. Click "Done" back in the "Add Deployment Targets" table, and then "Save" at the bottom-right.

Step 3: Configure the Jamf Pro client

This will allow the client to fetch the key API data.

1. Go to "Settings" from the tabs on the top-left.
2. Select the "Systems" tab.
3. Choose "API roles and clients".
4. Select the "API Roles" tab.
5. Click "+ New" on the right to create a new API role.
6. Provide a name to this API role, such as "RiseVision", and then from the privilege choose "Update Static Mobile Device Groups", and then save the role.
7. Return to "API roles and clients".
8. Select the "API Clients" tab and choose "New". Give the client a name, and add the API role that was made in bullet-point #6. Set 3600 for the duration.
9. Click "Enable" and "Save".
10. Click the "Generate client secret" and note the "Client ID" and "Client Secret" information for later use in Step 4.

Step 4: Copy that API information into your Rise Vision account

This will allow the Rise Vision server to notify your Jamf client that an automatic alert is coming.

1. In a separate window or tab, log in to your account at risevision.com
2. Click on your username on the top-right hand corner of the screen.
3. Choose “Company Settings.”
4. The JAMF Pro Display Management options are on the right-hand side of the settings page. Click the toggle to enable them and fill in the "Client ID" and "Client Secret" that you copied from Step 3. The "JAMF Pro Server" is the unique domain associated to your institution's Jamf Pro account, and most likely consists of "https://(your-institution).jamfcloud.com".

Your Rise Vision account is now setup to communicate with the Jamf Pro server, in order to interrupt normal AppleTV functions. Automatic alerts are now enabled. If you want to setup emergency classroom alerts, you are not yet done. Please refer to this article to connect Rise Vision with an appropriate Cap Alert provider.