Meeting Controls for Cisco endpoints

When using a Cisco endpoint, you can enhance your Microsoft Teams or Pexip VMR meeting room experience with Meeting Controls for Cisco endpoints. To use Meeting Controls on Webex-registered Cisco endpoints with a self-hosted Pexip Infinity installation, please contact your Pexip authorized support representative for more information.

On this page:

• About Meeting Controls
• Supported endpoints and conferences
• Prerequisites
• Downloads
• Manual installation of Meeting Controls
• ERM installation of Meeting Controls
• Release notes

About Meeting Controls

To enhance your Microsoft Teams or Pexip VMR meeting room experience, you can use the Cisco endpoint's touch panel to:

• change the conference layout (only for the endpoint on which the macro is being used)(hosts only in Pexip VMRs)
• enable/disable overlay text (the names of the participants or endpoints visible from the endpoint on which the macro is being used)(hosts only in Pexip VMRs)
• spotlight / pin a participant*
• view who is presenting, spotlighted, muted or has raised their hand
• view the full participants list — sorted by raised hand time, then spotlight status, then time joined

Note that the Teams-like layout does not support meeting control options such as disabling the display of participant names or spotlighting.

* For Microsoft Teams meetings, the macro gives you the option to "pin" a participant. This focuses on that participant, but only on the endpoint on which the macro is being used. People using native Teams clients can also "spotlight" a participant, which means that the participant has focus in the video layout that is shown to all participants.

For Pexip VMRs, the meeting control of focusing on a participant is labeled "spotlight" for that endpoint only.

Mute status

By default, if you mute the Cisco endpoint locally using the touch panel, the endpoint's muted status is not visible in the Teams client.

If you mute the Cisco endpoint from the Teams client, this is synchronized with the mute status visible on the endpoint's touch panel, which becomes muted.

This default mute status behavior can be modified in the settings file during installation.

Supported endpoints and conferences

The Meeting Controls feature is supported:

• on Cisco Room Devices MX, SX, DX and Room Kit Series, but not SX10. Firmware CE9.13 or later, or RoomOS 11 or later, is required for all.
• on Webex-registered endpoints.
• in Microsoft Teams conferences.
• in Pexip VMRs.

If you are using RoomOS 11.28.1.3 or later, you must use v1.7.1 or later of the Meeting Controls macro.

Prerequisites

• Admin user access to the Cisco endpoint for configuration.
• The Cisco endpoint must be registered to either Pexip Infinity or a SIP registrar that is able to proxy messages.
• The Cisco endpoint must be able to access port TCP/443 on any Transcoding Conferencing Nodes, Proxying Edge Nodes, or reverse proxies to which it connects.
• Pexip Infinity version 34 or newer.
• Any Transcoding Conferencing Nodes, Proxying Edge Nodes, or reverse proxies to which the Meeting Controls macro connects must have a valid TLS certificate trusted by the endpoint.
• A Teams Connector as part of your Pexip deployment if you intend to use the Meeting Controls macro in Microsoft Teams conferences.

Downloads

The Meeting Controls feature uses a Meeting Controls macro that is installed on the Cisco endpoint. During the macro installation, you require the macro file and the settings file. These settings must be customized for your organization before being uploaded to the endpoint. Information on how to access and save these files is given below.

Macro file

Download the following file (you may need to right-click and select Save link as...):

const meeting_controls_settings = {
  "services": [
    {
    "nodeURL": "https://<DOMAIN>/api/client/v2/conferences",
    "layouts": ["1:7", "teams", "ac", "2x2", "3x3", "1:0"],
    "regex": "^({{teamsMeetingId}}|teams)@<DOMAIN>$",
    "shouldMCUMute": false,
    "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"
  }
}

const meeting_controls_settings = {
  "services": [
  {
    "nodeURL": "https://<DOMAIN>/api/client/v2/conferences",
    "layouts": ["1:0", "1:7", "ac", "4:0"],
    "regex": "^(.+)@<DOMAIN>$",
    "shouldMCUMute": false,
    "panelSettings": {
    "controls": [
          "layout",
          "overlayText",
          "lockConference",
          "muteGuests",
          "disconnectAll"
    ],
    "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 and settings 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 (e.g. settings.js) 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 (e.g. meeting-controls-macro.js) that you downloaded earlier.

7. Select the Save to video system icon:

   

8. Toggle the macro from off to on:

   

9. Refresh the web page.

With immediate effect, during Teams and Google Meet conferences the touch panel of the Cisco endpoint shows the additional control features.

Troubleshooting

General

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 macro 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 Meeting Controls to.
3. Select Provisioning.
4. Select Apply macros/panels and from the Controls options select Meeting Controls macro.

5. To enable the macro on the endpoints with immediate effect select Apply, otherwise select Schedule for the night.

   

Release notes