Connect app settings

There are various configuration settings available within the Pexip Connect apps. The table below provides information about each of these settings.

Note that administrators can change, disable or provide default text for many of these settings by Customizing and branding the Connect apps.

Administrators can also provision individual Connect desktop app users with their registration details and automatically apply those registration settings to their app. See Registering and provisioning the Connect desktop app for more information.

Setting Description
Home page
Name

The name that appears to other conference participants.

You're asked to enter your name the first time you use the Connect app, but you can change your name from the home page by clicking on it.

For Connect desktop app users, your name may already have been pre-filled if your administrator has sent you a link that automatically applies your personalized settings to your app, but it can still be overwritten.

Settings

(Camera)

Shows the currently selected camera. Select this option to change the camera to use.

When the selected camera is working properly, your self view is shown in the main video window.

If you select None you will join the meeting without a camera, but you can still see everyone else's video. (This option is not available to iOS users.)

(Microphone)

Shows the currently selected microphone. Select this option to change the microphone to use.

When the selected microphone is working properly, a green bar appears under the main video window when audio is detected. The length of the bar represents the level of audio volume being picked up by the microphone.

If you select None you will join the meeting without a microphone, but you can still hear everyone else's audio. (This option is not available to iOS users.)

(Speakers)

Shows the currently selected speakers or headset. Select this option to change the speakers to use.

To check that the selected speakers are working properly, select the speaker icon from the bottom left of the main video window and then select the speaker to use. A tone will be played from that speaker.

Bandwidth *

The maximum bandwidth for the call, and the bandwidth at which the initial call attempt is made. Note that calls may be temporarily downspeeded due to network conditions.

The default is Medium (up to 1264kbps), but if you are on a cellular connection or slow Wi-Fi connection you may want to reduce this to Very Low (up to 256kbps).

You should also reconnect using a lower bandwidth if you experience slow or low-quality video.

Languages *

(Only applies if additional languages have been enabled by your administrator.)

Allows you to select from a drop-down menu the language to use in the Connect app.

If your browser or device's default language is supported by the Connect app, that language is used automatically. Alternatively, your administrator may have specified a default language to use.

Registration (Connect desktop app only)
Registration Host *

The domain, FQDN or IP address of the server to which registration requests are sent. This should be the IP address or FQDN of a local Conferencing Node.

For more information, see Setting up DNS records and firewalls for Connect app connectivity).

Alias

The alias that this Connect desktop app will register with. This is the alias that other users should dial when they want to call this app.

This alias must match one of the entries on the Management Node under Users & Devices > Device aliases.

For more information, see Registering devices to Pexip Infinity.

Username / Password

The username and password to use when this device registers to Pexip Infinity and is not using Single Sign-On (SSO) services, such as AD FS.

The username and password must match those configured for this alias on the Management Node under Users & Devices > Device aliases.

If the Connect app is configured for SSO, you will be asked to sign in to an alternative authentication service.

The registration fields are read-only when the app is successfully registered — you must Unregister if you want to change them. When the Connect app has been configured (provisioned) with SSO registration information, the Username / Password fields are blank and the registration settings can only be modified by resetting the app.

Advanced settings
Confirm when disconnecting * When this option is selected, you must confirm each time you wish to disconnect from a meeting. This prevents you from accidentally disconnecting yourself. This is on by default.
View incoming presentation in full motion *

This setting determines how presentations from other participants are initially received.

Presentations can be received in two formats:

  • A higher-bandwidth full motion HD stream (suitable for presentations with a lot of movement). With this option, Pexip Infinity sends the presentation to the Connect app as a video stream at up to 30 fps, so movement will appear smooth.

    The actual frame rate used depends on the capabilities of the endpoint that is sending the presentation. The Connect app can send presentations at up to 30 fps; other clients may send at a higher or lower frame rate.

  • A lower-bandwidth series of still images (suitable when very sharp images are required). With this option, Pexip Infinity periodically takes a snapshot of the presentation and converts it to JPG format, and sends that to the Connect app at between 0.5 to 1 fps. For this reason, presentations that contain a lot of movement may appear jerky to clients using this option.

This setting is on by default: presentations are initially received as full motion video, and you can subsequently elect to view them as still images by selecting the button on the toolbar at any time during the call. However, when View incoming presentation in full motion is not selected, presentations received by you are always shown as still images by default, and you can then elect to view them as full motion video by selecting the button.

Send anonymous statistics * When this option is selected, anonymous information about how the client is being used is sent to Pexip. For more information, see Automatically sending usage statistics. This is on by default.
Play ringtone on incoming calls *

(Connect desktop app only)

This is on by default; if you do not want to hear the default ringtone when you are receiving an incoming call, you can de-select this option.

Start application in background *

(Connect desktop app only)

The Connect app will always start automatically when the device it is installed on starts. This option allows you to select whether it starts minimized (in the background), or maximized (in the foreground).

If you have previously entered your registration details the Connect app will also register on startup. If you are configured for SSO, you may be asked to sign in to your alternative authentication service, such as AD FS.

This is off by default.

High contrast * When this option is enabled, there is a higher contrast between foreground and background elements of the user interface, making them more legible. This is off by default.
Device pairing

This setting toggles the availability of the option to pair with an alternative device when placing a call.

This is on by default for the Connect desktop app and Connect web app, and is not supported on the Connect mobile app.

Enable far-end camera control *

(Connect desktop app and Webapp2 only)

This setting controls whether the currently selected camera can be controlled (if it supports pan/tilt/zoom or zoom-only) by another participant (typically another Connect app user — see Control another participant's camera for more information).

The Connect web app requires Chrome version 87 or later. You can go to chrome://media-internals/ to check if your device's camera supports pan/tilt/zoom. Your browser will also ask for permission to allow your camera to be controlled:

Far-end camera control (FECC) is off by default.

Enable push to talk

This setting controls whether, when you have muted your microphone, you can unmute it temporarily by holding down the spacebar on your keyboard.

Push to talk is on by default.

Background effects

This setting enables and disables the selected background effect (i.e. background blur or replacement).

You can also toggle the selected effect on and off from a button in your self-view window at any time before or during a meeting.

Background blur *

This setting controls whether your local background blur is enabled or not. This lets you obfuscate a distracting or sensitive background.

Note that background blur is available:

  • on the Connect desktop app
  • on the Connect Webapp2 via Chrome or Edge browsers
  • on Connect Webapp3 via Chrome, Edge or Firefox browsers.

When this feature is used in a browser, it must be on a desktop device with hardware acceleration enabled. This feature incurs a significant local processing overhead which could affect the performance of your device.

Background blur is off by default.

Background replacement

(Connect desktop app only)

This setting allows you to replace your local background with either the default image (a grey gradient) or an image of your choice.

  • To upload your own image to use, select Add new and then select the image you wish to use. The file must meet the following requirements:
    • images must be at least 432 pixels high, and 768 pixels wide
    • images must be 16/9 ratio or narrower
    • supported formats are .JPG, .JPEG, .PNG and .WEBP
    • maximum file size is 3 MB
    • we recommend you use high-definition images
  • To revert to the default image, select Default.

Note that background replacement incurs a significant local processing overhead which could affect the performance of your device.

Note that background replacement is available:

  • on the Connect desktop app
  • on Connect Webapp3 via Chrome, Edge or Firefox browsers, on desktop devices with hardware acceleration enabled.

This feature incurs a significant local processing overhead which could affect the performance of your device.

Background replacement is off by default.

Screen sharing quality

This setting determines the maximum frame rate used when you share your screen with other participants. A lower frame rate results in images with more Sharpness and is best for static presentations; a higher frame rate is less sharp and is best for content where there is more Motion. The default is 2 frames per second; the maximum is 15fps for the Connect desktop app and 30fps for the Connect web app.

Note that the actual frame rate at which a presentation is sent depends on the browser, computer, network quality, and nature of the presentation.

Import trusted key

(Connect desktop app only)

If customized branding or configuration has been applied to the client, you have to load a trusted key and confirm that you want to apply the customizations before they can take effect. Your administrator needs to supply you with the appropriate key file.

About this app
Reset app The Reset option clears the app storage and any registration settings.
Logs If you are having issues with your Connect app, your administrator may ask you to Download logs (Connect web app), Open log folder (Connect desktop app), or Copy to clipboard (Connect mobile app) to obtain logging information about the last call.

* The administrator can provide a first-time default for this option by Customizing and branding the Connect apps.