Configuring the Test Call Service
Pexip Infinity provides a test loopback service that allows users to check the quality of their video and audio (i.e. that their local camera, microphone and speakers are working properly), and verifies that they can connect to a Conferencing Node.
Test Call Services are configured within Pexip Infinity in the same manner as other services such as Virtual Receptions. By default, Pexip Infinity includes a preconfigured Test Call Service (called "Test Call Service") and an associated alias of "test_call" that can be used to dial into the Test Call Service. Additional test call services and aliases can be added if required.
We recommend that you add a test_call@<yourdomain> alias to the preconfigured Test Call Service to cater for devices that automatically add a domain to their called alias.
After a call into a Test Call Service (e.g. to the "test_call" alias) is answered, the user receives some instructions and then the user's video and audio of themselves is played back from the Conferencing Node with a 2 second delay. The test call then automatically disconnects after approximately 20 seconds.
The instructions and timeouts can all be customized via themes, and different themes can be applied to different Test Call Services, if required.
Note that the Test Call Service does not support connections over RTMP (calls from the Infinity Connect Web App via Internet Explorer and Safari browsers).
To configure Test Call Services and their associated aliases, go to . The options are:
|Name||The name used to refer to this Test Call Service.|
|Description||A description of the Test Call Service.|
The theme for use with this Test Call Service. For more information, see Customizing images and voice prompts using themes.
Default: <use Default theme> (the global default theme will be used).
|Maximum inbound call bandwidth (kbps)||Enter a value in this field to limit the bandwidth of media being received by Pexip Infinity from the user dialed in to this Test Call Service. For more information see Restricting call bandwidth.|
Allows you to limit the media content of the conference. For more information, see Controlling media capability.
Default: Main video + presentation.
|Service tag||This optional field allows you to assign a unique identifier to this service, which you can then use to track use of the service.
The alias that, when received by Pexip Infinity, will cause it to route the call to this service (Virtual Meeting Room, Virtual Auditorium, Virtual Reception or Test Call Service).
The alias entered here must match exactly the alias as it is received by Pexip Infinity. Wildcards and regular expressions are not supported.
In most cases, the alias received by Pexip Infinity will be the same as the alias that the conference participant dialed from their endpoint, but there are some exceptions, described in About aliases.
You may also want to define multiple aliases for the same service to ensure that it can be accessed by devices and protocols that enforce specific alias formats — for more information, see Using multiple aliases to access the same service.
|Description||An optional description of the alias. This is useful if you have more than one alias for a service.|
|Add another Alias||Select this option if you want the Test Call Service to be accessible by more than one alias. For more information, see Using multiple aliases to access the same service.|
As with other Pexip Infinity services, the images that are shown, and the audio prompts that the end user hears, can all be fully customized via themes. You can also control the playback delay and the duration of the test call by configuring settings in the themeconfig.json theme file.
The following theme files and settings are used during a test call:
|Theme file/setting||Default content||Notes|
"Let's test your video and audio. Count out loud from one to three, now."
|Audio file played at the start of a call to a Test Call Service.|
"If you have technical issues, check your settings or contact your administrator."
|Audio file played at the end of a call to a Test Call Service.|
Shown at the start of a call to a Test Call Service.
Shown during a call to a Test Call Service. Note that a large, live (with a short delay) video image of the test call participant is shown on top of this JPG file during a test call.
Shown briefly prior to automatically disconnecting the participant from a Test Call Service.
The number of seconds that media is delayed before being looped back to the caller when using a Test Call Service.
The number of seconds that a user can test their media before the disconnect message is played, when using a Test Call Service.
The following sequence describes the test call process and explains when each theme file and setting is used:
- When a test call is answered, the test_call.jpg image is displayed and the conf-test_call_48kHz_mono.wav audio file is played.
- The test_call_during_recording.jpg image is displayed (after the conf-test_call_48kHz_mono.wav audio file has finished).
- The caller's audio and video media is replayed back to them with a <test_call_service_media_delay> seconds delay (
2seconds by default).
- The media replay stops after <test_call_service_disconnect_timeout> seconds (
10seconds by default).
- The test_call_disconnect.jpg image is displayed and the conf-test_call_disconnect_48kHz_mono.wav audio file is played.
- The call automatically disconnects after a further 5 seconds (not configurable).