Controlling the layout during a conference

Conference participants have a range of options available to them to control aspects of the conference layout and how they receive presentation content. They can:

Changing the conference layout

The layout used in a conference can be changed dynamically during the conference by the conference participants.

See Conference layouts and speaker names for full details about all of the available layouts and how to configure the default layout settings for a conference.

Note that any layout changes are applied to all participants in the conference.

Hardware endpoint participants (SIP/H.323)

Host participants on video endpoints can change the layout currently being used in the conference by sending DTMF/keypad commands to the conference.

By default the layout changes every time the endpoint sends *8 to the conference, and it cycles through all of the available Pexip layout types in this order: 1+7, Adaptive Composition, 1+21, 2+21, 2x2, 3x3, 4x4, 5x5, 1+0, 1+33.

The ability to change the layout, the layouts that are used, the sequence in which they are displayed, and the DTMF keypad control used to change the layout, are all customizable via themes.

For more information see Using a DTMF keypad to control a conference and Theme configuration.

Infinity Connect participants

Host participants on Infinity Connect clients can dynamically change the layout during a conference and they can also show/hide participant names: from the top of the side panel in the client, select Control and then select Change layout. An overlay dialog opens from where you can select a layout and control the display of participant names.

Bespoke client applications could also make use of the transformLayout function in the PexRTC client API.

Multiscreen participant display

If you have a dual screen SIP endpoint you can display conference participants across both screens, allowing you to show more participants than if you have a single screen. This display mode is currently only available for the following meeting, layout and endpoint types:

  • Conferences hosted in a VMR (it is not currently available in a Virtual Auditorium).
  • Calls into a Microsoft Teams conference.
  • Where the conference layout is 1+7, 1+0 or 2x2.
  • Available to SIP endpoints only.

The same layout format is used on both screens. If a participant starts presenting, the second screen reverts to showing the presentation content. In-conference indicators are displayed on the primary screen only.

Multiscreen participant display

Note that multiscreen participant display is a technology preview feature. It is disabled by default and has to be enabled via Platform > Global settings > Enable Dual Screen layouts.

When multiscreen participant display is enabled on Pexip Infinity, it is used automatically on endpoints that are known to have dual screens — see Determining if an endpoint has single or multiple screens for details.

Toggling multiscreen display

You can toggle multiscreen display mode by a using a DTMF keypad command sent from the endpoint. This command defaults to *9 but it can be customized via themes. This command can also be used to apply multiscreen display mode to a dual screen endpoint that has dual screens but the additional screen has not been detected.

When toggling the multiscreen mode, it only applies to the endpoint sending the enable/disable command, and not to all participants in the conference.

For more information see Using a DTMF keypad to control a conference.

Receiving the presentation stream as part of the layout mix (Adaptive Composition)

When using Adaptive Composition, single-screen endpoints automatically receive the presentation stream as part of the layout mix (replacing some of the other video participants), but you can choose to switch to receiving it as a separate stream.

When the presentation is received in the layout mix:

  • The person presenting is shown alongside the presentation. Note that the "presenter" is the participant that the artificial intelligence driving the layout has decided is the person who is actually presenting (this is based on activity — such as speaking frequency — and not necessarily the device/person that is physically sharing the content).
  • A maximum of 12 other video participants are included in the layout, as well as the presentation content.
  • If the "presenter" is a group of people then the presentation occupies the entire top row and the presenter group is shown in the bottom row instead, plus up to 8 other participants.
  • The presentation is pillarboxed or letterboxed to fit into its position in the layout.
  • The presentation segment has its own framerate regardless of the source framerate of the presentation stream. For example, even though the presentation input stream is 5 fps, the framerate of the presentation in the layout could still be 30 fps.

Hardware endpoint participants (SIP/H.323)

The presentation mode can be toggled between receiving it in the layout mix and receiving it as a separate stream by a using a DTMF keypad command sent from the endpoint. This command defaults to *4 but it can be customized via themes.

  • Single-screen endpoints receive the presentation as part of the layout mix by default, and it always resets to this mode when the endpoint joins a new conference. However, within a conference, the current state is remembered if one presentation stops and a new presentation starts.
  • When toggling the presentation mode, it only applies to the endpoint sending the enable/disable command, and not to all participants in the conference.
  • It does not apply to SIP endpoints with multiple screens — they always receive a separate presentation stream.

See Determining if an endpoint has single or multiple screens for more information.

Infinity Connect participants

When receiving presentation content in an Adaptive Composition layout, the presentation stream is shown as part of the layout mix (replacing some of the other video participants), providing the client is receiving video at a medium or higher bandwidth setting (otherwise it is displayed as one large separate stream).

You can toggle the presentation content between the "in mix" and "separate" streams via the maximize and reset buttons in the bottom-right corner of the presentation.

Enabling and disabling the display of participant names

Each Virtual Meeting Room and Virtual Auditorium can be configured to show the names of the participants in a text overlay along the bottom of their video image. See Showing the names of active speakers and participants for full details about how to enable or disable participant names by default for a conference, and how the display name is determined.

Host participants on Infinity Connect clients can dynamically change the layout during a conference and they can also show/hide participant names: from the top of the side panel in the client, select Control and then select Change layout. An overlay dialog opens from where you can select a layout and control the display of participant names.

Bespoke client applications could also make use of the transformLayout function in the PexRTC client API.