Skip to content

Commit

Permalink
Merge pull request #15894 from lhenrika/patch-34
Browse files Browse the repository at this point in the history
Update digital-signage.md
  • Loading branch information
garycentric authored Oct 28, 2024
2 parents 62d36eb + de2a9e1 commit dfc42d1
Showing 1 changed file with 27 additions and 21 deletions.
48 changes: 27 additions & 21 deletions Teams/rooms/digital-signage.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,7 @@ description: Learn more about how
---
# Configure digital signage on Teams Rooms

This feature is only available for Technology Adoption Program (TAP) Preview and early adopter customers.

Digital signage on Microsoft Teams Rooms expands organizational communications into your meeting spaces, enabling you to inform, connect, and engage your teams. When your Teams Rooms devices are not used for meetings or presentations, they can be configured to display dynamic content and relevant information like how to guides, company or organizational news, upcoming events, and more in signage mode. You can adjust when signage mode is activated and deactivated, including whether signage mode will adhere to the operating system's screen time-out setting. When your Teams Rooms devices are in signage mode, signage content appears in full screen on the front-of-room displays. You have the option to show the Teams Rooms banner so that users can see the room information and calendar preview alongside the signage content on the front-of-room displays. Tapping the touch console during signage mode seamlessly returns the user to the home screen.
Digital signage on Microsoft Teams Rooms expands organizational communications into your meeting spaces, enabling you to inform, connect, and engage your teams. When your Teams Rooms devices aren't used for meetings or presentations, they can be configured to display dynamic content and relevant information like how to guides, company or organizational news, upcoming events, and more in signage mode. You can adjust when signage mode is activated and deactivated, including whether signage mode will adhere to the operating system's screen time-out setting. When your Teams Rooms devices are in signage mode, signage content appears in full screen on the front-of-room displays. You have the option to show the Teams Rooms banner so that users can see the room information and calendar preview alongside the signage content on the front-of-room displays. Tapping the touch console during signage mode seamlessly returns the user to the home screen.

:::image type="content" source="media/digital-signage/ds-meeting-enlarged-console.jpg" alt-text="Teasms Rooms homescreen." lightbox="media/digital-signage/ds-meeting-enlarged-console.jpg":::

Expand All @@ -42,7 +40,7 @@ Configuring digital signage for your tenant requires the following:
Currently, digital signage isn't yet available on the following clients and environments:

- Teams Rooms on Android (MTR-A)
- Multi-tenant Management portal (MTMA)
- Multitenant Management portal (MTMA)
- Government Community Cloud (GCC)
- Government Community Cloud High (GCC-H)
- Department of Defense (DoD)
Expand All @@ -54,15 +52,15 @@ To enable digital signage for your Teams Rooms devices, you need to follow these
1. Manage permissions for digital signage.
1. Enable digital signage for the tenant.
1. Add signage sources for the tenant, including enabling native third-party integrations as desired.
1. Assign a source and settings to rooms which will register rooms onto supported third-party content management systems (if applicable).
1. Assign a source and settings to rooms which register rooms onto supported third-party content management systems (if applicable).

> [!IMPORTANT]
> Before you enable and set up digital signage, consider your privacy and compliance requirements. See [Adding an external signage source](#step-3---adding-an-external-signage-source) for more information.
The following sections show you how to complete each step.

## Step 1 - Managing permissions for digital signage

By default, Microsoft 365 Global Admins and Teams Rooms Pro Managers have the digital signage *tenant* management and digital signage *room* management permissions which grants the ability to perform the following actions respectively:
By default, Microsoft 365 Global Admins and Teams Rooms Pro Managers have the digital signage *tenant* management and digital signage *room* management permissions which grant the ability to perform the following actions respectively:

> [!IMPORTANT]
> Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
Expand All @@ -74,7 +72,7 @@ By default, Microsoft 365 Global Admins and Teams Rooms Pro Managers have the di
- Set default signage source and settings for the tenant.

- Digital signage *room* management permission
- Enable and disable digital signage for a room.
- Enable, disable, and reset digital signage for a room.
- Select an existing signage source from the list of sources that has been added to the tenant for a room.
- Modify signage settings for a room.

Expand All @@ -83,7 +81,7 @@ Microsoft 365 Global Admins and Teams Rooms Pro Managers can assign additional u
> [!IMPORTANT]
> Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
1. Log in to **Teams Rooms Pro Management** portal > go to **Settings** > **Roles** > select **Create** **role** > enter a unique name and description for the role > select **Next**.
1. Sign in to **Teams Rooms Pro Management** portal > go to **Settings** > **Roles** > select **Create** **role** > enter a unique name and description for the role > select **Next**.
1. Under **Role permissions**, select **Digital signage tenant management: View, Modify** and/or **Digital signage room management: Modify** as desired > select **Next** > enter a name and description for the assignment > select **Next**.
1. Under **Assign members**, search and/or select user(s) and/or security group(s) that will be part of this role with the selected permissions > select **Next**.
1. Under **Assign scope**, search and/or select room(s) and/or room group(s) that this role can manage > select **Next** > **Add new role**.
Expand All @@ -93,9 +91,9 @@ Microsoft 365 Global Admins and Teams Rooms Pro Managers can assign additional u
## Step 2 - Enabling digital signage

To enable digital signage for your tenant, log in to **Teams Rooms Pro Management** portal > go to **Settings** > **Digital signage** > toggle On **Digital signage** on the digital signage tenant management page.
To enable digital signage for your tenant, sign in to **Teams Rooms Pro Management** portal > go to **Settings** > **Digital signage** > toggle On **Digital signage** on the digital signage tenant management page.

Next, you'll need to add a signage source. You can add multiple signage sources for your tenant and assign a different source per room or room group. Supported signage sources include third-party digital signage providers and web URLs. Native integrations with the following trusted third-party digital signage providers are available:
Next, you need to add a signage source. You can add multiple signage sources for your tenant and assign a different source per room or room group. Supported signage sources include third-party digital signage providers and web URLs. Native integrations with the following trusted third-party digital signage providers are available:

- [Appspace](https://www.appspace.com/microsoft-teams-rooms/)

Expand All @@ -106,7 +104,11 @@ Next, you'll need to add a signage source. You can add multiple signage sources
## Step 3 - Adding an external signage source

To enable a third party integration, from the digital signage tenant management page, select **Add source** > enter a unique name and description for this source > select **Next** > choose the third party system of your choice > enter a valid integration ID that you must obtain from the third-party system > select **Validate** > **Next** > acknowledge terms of use > select **Next** > review and finish > select **Submit**.
To enable a third party integration, from the digital signage tenant management page, select **Add source** > enter a unique name and description for this source > select **Next** > choose the third party system of your choice > enter a valid integration ID that you must obtain from the third-party system > select **Validate** > **Next** > acknowledge terms of use > select **Next** > review and finish > select **Submit**. You can find the setup instructions for the following supported third party providers below:

- [Appspace](https://docs.appspace.com/latest/devices-app/advanced-registration-microsoft-meeting-room-devices/)

- [XOGO](https://www.xogo.io/microsoft-teams-rooms-setup)

If you don’t use any of the supported third party providers, you can set web URLs as a signage source. To ensure the web application loads successfully on your Teams Rooms device, the URL must meet the following requirements:

Expand All @@ -128,11 +130,14 @@ To add a web URL as signage source, from the digital signage tenant management p

Once you've added signage source(s) for your tenant, you can now assign a signage source and settings to your rooms. If you're assigning one of the trusted third party providers as a signage source to a room, this step automatically registers that specific room onto the third-party content management system. You can assign a signage source and settings for multiple rooms or room groups at the tenant level or for individual rooms at a room level:

- Tenant-level - from the digital signage tenant management page, choose a signage source > select **Assign to rooms** > confirm the pre-selected source that you intend to assign > select **Next** > review or modify signage settings > select **Next** > search or select room(s) and/or room group(s) where you'd like to assign your chosen source and settings > select **Next** > review and finish > select **Submit**.
- Room-level - navigate to the specific room's settings. Go to **Rooms** > choose a specific room > select **Settings** > **Digital signage** > toggle ON **Digital signage** > modify signage settings as desired > choose a signage source from any of the sources added to the tenant > select **Apply**.
- Tenant-level - from the digital signage tenant management page, choose a signage source > select **Assign to rooms** > confirm the preselected source that you intend to assign > select **Next** > review or modify signage settings > select **Next** > search or select room(s) and/or room group(s) where you'd like to assign your chosen source and settings > select **Next** > choose when the configuration will be applied > review and finish > select **Submit**.
- Room-level - navigate to the specific room's settings. Go to **Rooms** > choose a specific room > select **Settings** > **Digital signage** > toggle ON **Digital signage** > modify signage settings as desired > choose a signage source from any of the sources added to the tenant > select **Apply** > choose when the configuration will be applied > select **Submit**.

> [!IMPORTANT]
> Whether you choose to apply the settings now or during the maintenance window, the room must be online, connected, and signed into the Teams Rooms app for settings to be applied. Note that after a room restarts, it takes about 10-15 minutes for the Teams Rooms Pro Management agent to be connected.
> [!NOTE]
> Settings will only be applied during the maintenance window. To find the setting application results, go to **Rooms** > select **Export** **all** and filter through the rooms and settings in the CSV file.
> To find the setting application results, go to **Rooms** > select **Export** **all** and filter through the rooms and settings in the CSV file.
Once settings have been applied, rooms are now registered with the third party provider. You can manage and update the content that plays in the room directly from the third party content management system.

> [!TIP]
Expand All @@ -150,7 +155,7 @@ While each room or room group can be assigned with a unique configuration, you c
- **Display period** - from the digital signage tenant management page, select **Preferences** >
- **Activation timer** - enter the number of minutes (between 1 to 100) that a device has been idle before signage mode activates.
- **Deactivation** **timer** - enter the number of minutes (between 0 to 100) before a scheduled meeting starts when signage mode deactivates and returns to the home screen.
- **Screen timeout** - toggle On or Off **Allow screen timeout when device is idle** as desired. Turn On to adhere to the operating system's screen timeout settings (i.e., the screen light goes out regardless of when signage mode is activated). Turn Off to bypass the operating system's screen timeout settings (i.e., the screen remains lit up on idle devices when signage mode is activated).
- **Screen timeout** - toggle On or Off **Allow screen timeout when device is idle** as desired. Turn On to adhere to the operating system's screen timeout settings (i.e., the screen light goes out regardless of when signage mode is activated). Turn Off to bypass the operating system's screen timeout settings (that is, the screen remains lit up on idle devices when signage mode is activated).

> [!NOTE]
> If you add video content in your signage playlist, the screen timeout setting might not consistently honored due to underlying operating system behavior for video playback.
Expand All @@ -162,10 +167,10 @@ While each room or room group can be assigned with a unique configuration, you c

When using a supported third party digital signage provider as the signage source of a room, you can proactively monitor the health of digital signage in the room using the new digital signage health signal when you expand the display signal. To view the digital signage health signal: go to **Rooms** > choose the specific room > select **Status** > toggle On **Show all signals** > expand **Display** > select **Digital signage**. Alternatively, go to **Incidents** > expand **Display** > select **Digital** **signage**.

When there is an issue with the third party player or signage content, the issue description, and actions you can take to resolve the issue (if applicable) will be visible in the messages. Depending on the nature of the issue, the Teams Rooms experience will vary:
When there's an issue with the third party player or signage content, the issue description, and actions you can take to resolve the issue (if applicable) will be visible in the messages. Depending on the nature of the issue, the Teams Rooms experience varies:

- If there is no signage content available to play in a room whether caused by a system error (i.e., server error, offline) or human error (i.e., no content assigned to the room, no cached content), signage mode will remain deactivated until the issue is resolved at the next device restart. The room will remain on the home screen to avoid showing error messages or empty screens on front-of-room displays. Alerts will be provided on the Teams Rooms Pro Management portal and the third party content management system as appropriate.
- If there is signage content available to play in a room (i.e., cached content) despite an error, signage mode will continue to activate per the activation timer. Any applicable alerts will still be provided on the Teams Rooms Pro Management portal and/or the third party content management system.
- If there's no signage content available to play in a room whether caused by a system error (that is, server error, offline) or human error (that is, no content assigned to the room, no cached content), signage mode will remain deactivated until the issue is resolved at the next device restart. The room remains on the home screen to avoid showing error messages or empty screens on front-of-room displays. Alerts are provided on the Teams Rooms Pro Management portal and the third party content management system as appropriate.
- If there's signage content available to play in a room (i.e., cached content) despite an error, signage mode continues to activate per the activation timer. Any applicable alerts will still be provided on the Teams Rooms Pro Management portal and/or the third party content management system.

> [!NOTE]
> The digital signage health signal is not available for rooms with a web URL (custom option) signage source.
Expand All @@ -178,6 +183,7 @@ If you have issues with configuring signage settings on your Teams Rooms device

|Issue or limitation|Workaround|
| -------- | -------- |
|Settings are only applied during the maintenance window.|There is no way to immediately apply the settings.|
|Regardless of the signage source, the digital signage health signal isn't available.|If digital signage has been enabled but signage mode isn't activated after the maintenance window, submit an issue using **Report a problem**.|

|Regardless of the signage source, the digital signage health signal isn't available on the Teams Rooms Pro Management portal.|There's no workaround. Users must report issues for you to be alerted of issues with digital signage in the room.|
|When the **Apply now** option for applying settings is selected and the room is in use, the changes won't be applied immediately to avoid disruption in the room. Rather, we'll retry to apply the changes during the maintenance window.|When settings fail to apply immediately, you can either wait for the maintenance window or push another update when the room is no longer in use to override the changes scheduled to be applied during the maintenance window.|
|In some instances, assigning an Appspace channel to a room results in a failure to load signage mode in the room.|To troubleshoot, run the **Restart device-Clear cache** action with the **Delete Teams cache** option selected on the Teams Rooms Pro Management portal for the impacted room. If the issue persists, contact Appspace.|
|Rooms with dual displays that use Appspace may see a black screen on one of the displays when the Appspace player loads for the first time.|When a black screen is showing on of one of the dual displays, tap the touch console to exit signage mode. When the room goes back to the home screen, the next time signage mode loads, both screens will properly show signage mode.|

0 comments on commit dfc42d1

Please sign in to comment.