Microsoft Teams Room (MTR)

Q-SYS Designer Software version 9.0.0 and later is required.

The Q-SYS Software Feature License for Microsoft Teams Rooms is a single SKU that enables two software features on the Q-SYS Core processor:

• Q-SYS Scripting Engine
• Q-SYS UCI Deployment

Note: If your Core already has active licenses for both scripting and UCI deployment, the Q-SYS Software Feature License for Microsoft Teams Rooms is not needed. Refer to the Licensing topic for Core model support.

This sample design file enables Q-SYS to meet Microsoft Teams Room experience expectations, including audio DSP signal flow, DSP settings, room type optimization, and loudspeaker configuration optimization. The design file can be augmented with other DSP and control programming as long as the required signal flow remains intact.

The Teams Sample design is available in Asset Manager and includes the Mobile Device Companion App and Teams UCI Style – each described separately below.

The Mobile Device Companion App is a UCI embedded in the Teams Sample Design. Use it to fine-tune and optimize the DSP parameters in the design based on room acoustics.

Access the Mobile Device Companion App using a mobile device with network access to the Core. This could be via the HTML5 UCI viewer in Core Manager or from the Q-SYS Control app for iOS devices.

Tip: If you adjust the DSP settings in the Mobile Device Companion App and later change your mind, you can easily start over in the companion app and repeat the process with the default Teams-certified settings.

The Teams UCI Style is included with the Teams Sample Design and also available for download separately via Asset Manager. Use it to apply CSS classes to controls in a native Q-SYS UCI. The CSS Style automatically applies colors, fonts, and control style information to match the Teams Room aesthetic.

To see a list of Teams style classes and examples for each, refer to the CSS Class Reference in the UCI Styles topic.

Q-SYS Control for MTR is an application, installed on the Microsoft Teams Room compute via .exe installer, that allows the Teams Room console to display any Q-SYS UCI deployed on the Core – typically for room control. An icon appears on the Teams Room touch panel to switch over to Room Control mode to view the Q-SYS UCI. You can then switch back to the native Teams Room console display when ready.

The Q-SYS Control for MTR .exe installer is included with the Q-SYS Designer Software download and also available separately from the Q-SYS Software and Firmware website.

The Q-SYS MTR Component connects to the Q-SYS Control for MTR application running on the Microsoft Teams Room compute. Use it to obtain the status of that connection and define what UCI is displayed on the Microsoft Teams Room console.

See the Licensing topic to review feature licensing requirements and for license activation instructions on the Q-SYS Core processor.

Download and install Q-SYS Designer version 9.0.0 and later from the Q-SYS Software and Firmware website.

The Q-SYS Control for MTR .exe installer is included with the Designer download bundle. Or, you can download separately from the Q-SYS Software and Firmware website. Follow this procedure to install the application on the Microsoft Teams Room compute.

Note: Install the application on the Teams Room compute, not the PC running Q-SYS Designer Software.

1. Ensure that the Teams Rooms platform is already installed and running on the Teams Room compute.
2. Copy the Q-SYS Control for MTR Installer.exe file to a thumb drive.
3. Insert the thumb drive into a USB port on the Microsoft Teams Room compute.
4. On the Teams Room console, tap More > Settings.
5. On the User Account Control prompt, type the Administrator password, and then tap Yes. If you do not know the password, consult your IT administrator.
6. On the Settings page, tap Windows Settings.
7. In the lower left corner, tap the Administrator user and log in with the Administrator password.
8. In Windows, use File Explorer to navigate to the USB thumb drive.
9. Double-tap the .exe installer file.
10. Follow the prompts to install the Q-SYS Control for MTR application and reboot the Microsoft Teams Room compute.

In Q-SYS Designer, go to Tools > Show Asset Manager (or click from the toolbar) to find, select, and download the Teams Sample Design.

Go to File > Open Sample Design and select the Teams Sample Design to open. Then, select File > Save to Core & Run (or press F5) to deploy the design to the Core.

Tip: For help with saving designs to the Core, see the Loading and Saving Designs topic.

On the Teams Room console:

1. Tap More > Settings.
2. Enter the system password.
3. Select Peripherals from the left pane.
4. In the center window, select "Echo Canceling Speakerphone (Core110f)" for the Microphone, Speaker, and Default Speaker boxes.
5. Tap Save and Exit to go back to the main control window.

The setup procedure varies depending on the microphone selected. Use the manufacturer's recommended procedures and software to deploy their microphone properly.

With the Teams Sample Design running on the Core, follow the Room Setup steps in the design:

Step 1: Network Interface

Select the correct network interface that will be used to load the companion app. This will provide the correct network address via the QR code in order to load the Mobile Device Companion App.

Step 2: Microphone Dante Receive

Configure the communication parameters for the selected microphone:

Dante receive: Select the appropriate Dante device and channel for the microphone.

Step 3: Microphone Dante Transmit

Configure the communication parameters for the selected microphone:

Dante transmit: To send audio back to the microphone as a reference, specify a unique channel name for this purpose. Then, use Dante Controller software to route that channel from the Core back to the microphone.

Step 4: Loudspeaker Model

Select the model of NL Series PoE loudspeakers in use. Add the correct model into the inventory window and drag them into the design. You will need to remove the previous models and reconnect the wiring to the new models.

Step 5: Microphone LED Sync

Configure the communication parameters for the selected microphone:

Control IP address: Specify the microphone's control IP address, which is obtainable from the selected manufacturer's microphone software.

Step 6: Microsoft Teams Room Compute

This configures the MTR component in the sample design.

• MTR IP address: Specify the IP address of the PC that is running the Microsoft Teams Rooms software. This is visible on the idle screen of the Q-SYS Control for MTR application when you switch to the Room Controls view (when the application is not connected to the Core).
• Room Console UCI: Select the UCI from the design file to display on the Teams Room console. For now, you can leave this set to the room controls sample UCI.

Step 7: Mobile Device Companion App

From a mobile device with network access to the Q-SYS Core:

1. Scan the QR code to load the Mobile Device Companion App. (Alternatively, you can open Core Manager, navigate to the User Control Interfaces page, and select the "Companion App" UCI.)
2. Follow the instructions to fine-tune the audio settings for your specific room.
3. At the end of the process, save the settings.

Build a Q-SYS UCI to display on the Teams Room console for users to control and monitor camera selection and positioning, displays, HVAC, shades, mic and loudspeaker meters, etc.

Tip: You can modify the Room Controls sample UCI (included with the Teams Sample Design) for your own application.

1. Disconnect from the running Teams Sample Design (F7).
2. From the navigation pane, click User Control Interfaces.
3. Click to create a new UCI.
4. Add controls to the UCI. For information about creating UCIs, see User Control Interface (UCI) Design Overview.
5. From the navigation pane, select your UCI name.
6. From the User Control Interface Properties, select "Teams" as the Style. (The Teams style is included with the Teams Sample Design.)
7. For each control (text box, button, etc.), assign a CSS Class Name from the drop-down menu. To see a list of Teams style classes and examples for each, refer to the CSS Class Reference in the UCI Styles topic.

Tip: The Teams style CSS classes automatically apply the colors, fonts, and control style information to match the Microsoft Teams Rooms aesthetic.

1. Save and run the Teams Sample Design to the Core, which now includes your Q-SYS room controls UCI.
2. On the Teams Room console, switch to Room Controls by tapping the fader icon in the bottom right corner. The Q-SYS UCI should display.

   Tip: If you are in a call, you can switch to Room Controls by tapping the . . . icon at the bottom of the screen and then tapping Room Controls.

The Teams Sample Design includes an Advanced Configurations section for tweaking the audio, video, and control components for your specific room. Double-click a component's icon to understand the effects of changing its controls.

Note: The Q-SYS sample design file includes audio signal flow and processing settings that meet Microsoft Teams Rooms certification. We recommend using this design file. If you cannot, you should ensure that the signal integrity and gain structure is maintained to meet Microsoft Teams Rooms performance expectations.