Pexip Macro for Meeting Controls

Enhance your meeting room experience with the Meeting Controls macro for Microsoft Teams meetings on Cisco endpoints. Using the Cisco endpoint's touch panel during a Teams meeting, the Meeting Controls macro allows you to:

  • Change the conference layout
  • Enable/disable the overlay text (the names of the participants or endpoints)
  • View the participants list
  • View who is presenting
  • View who is spotlighted
  • Spotlight a participant

On this page:

Supported endpoints and conferences

Meeting Controls are supported:

  • on Cisco Room Devices MX, SX, DX and Room Kit Series, but not SX10. Firmware CE9.13 or newer required for all.
  • in Microsoft Teams conferences.

Prerequisites

  • Admin user access to the Cisco endpoint for configuration.
  • Pexip Infinity version 29 or newer.
  • A Teams Connector as part of your Pexip deployment.

Downloads

During the macro installation, you require the following files so we recommend that you download and customize them now:

Macro file

meeting-controls-macro.js This file is required in all installations but you do not need to customize it.

Settings file

Below is an example settings file for the Meeting Controls macro. You must customize these settings for your organization:

  1. Copy the settings below.
  2. Open the settings in Notepad or a tool of your choice.
  3. For nodeURL and regex, edit <CUSTOMER DOMAIN> with the relevant domain for your organization.
  4. Save the settings file.
Copy to clipboard
const call_macro_settings = {
  "services": [
    {
      "nodeURL": "https://<CUSTOMER DOMAIN>/api/client/v2/conferences",
      "layouts": ["1:0", "1:7", "5:7", "4:0"],
      "regex": "^{{teamsMeetingId}}@<CUSTOMER DOMAIN>$",
      "panelSettings": {
        "controls": ["layout", "overlayText"],
        "roster": true
      }
    }
  ],
  "InCallButton": {
    "panelId": "panel_pex_in",
    "type": "InCall",
    "icon": "Info",
    "name": "Meeting Controls"
  },
  "LayoutButton": {
    "panelId": "layout_panel",
    "type": "Never",
    "icon": "Info",
    "name": "Change Layout"
  }
}

 

Manual installation of Meeting Controls

The following instructions explain how to install the Meeting Controls macro manually on a single endpoint. If you use Enhanced Room Management (ERM) and want to provision the macro on multiple endpoints simultaneously, proceed to ERM installation of Meeting Controls.

  1. Log into the web interface of your Cisco endpoint in your browser.
  2. Go to Macro Editor.

  3. Select Enable Macros. This prompt only appears if you have never used a macro before.
  4. In the Macro Editor, select Import from file and select the settings file that you edited and saved earlier.
  5. Select the Save to video system icon.

  6. Select Import from file again and select the macro file that you downloaded earlier.
  7. Select the Save to video system icon.

  8. Toggle the macro and settings switches from off to on.
  9. Refresh the page if required.

As of immediate effect, the touch panel of the Cisco endpoint shows the additional control features during Teams conferences.

Troubleshooting

If you need to troubleshoot the Meeting Controls macro at any point, you can download logs from the web interface in

System Maintenance > Issues and Diagnostics > Systems logs > Download logs...

ERM installation of Meeting Controls

If you use Enhanced Room Management (ERM), you can enable Meeting Controls on multiple endpoints simultaneously.

Installing Meeting Controls in ERM

  1. Go to Enhanced Room Management > Panels and macros.
  2. On the Room Controls tab, select the + button.

  3. Enter a title and description for the settings.
  4. Attach the settings file that you downloaded earlier and select Add.
  5. Again, select the + button.
  6. Enter a title and description for the macro.
  7. Attach the macro file that you downloaded earlier and select Add.

The Meeting Controls macro and settings are now installed in ERM.

Provisioning Meeting Controls on multiple endpoints in ERM

The following instructions explain how to provision one or more Cisco endpoints in ERM with Meeting Controls.

  1. Go to Enhanced Room Management > Systems.
  2. On the Search tab, select all room systems that you want to deploy the Meeting Controls macro to.
  3. Select Provisioning.
  4. Tick Apply room Controls and select Call Controls from the Controls options.
  5. Click Apply to enable the macro on the endpoints for immediate effect or Schedule for the night.