WebRTC Environment
One can use WebRTC with XiVO PBX and XiVO CC in the following environment:
LAN network (currently no support for WAN environment),
with the:
UC Assistant or CC Agent with Chrome browser version 85 or later
or Desktop Application
Requirements
The requirements are:
to have a microphone and headphones for your PC,
to configure your XiVO PBX:
configure Asterisk HTTP server,
and then create users with a WebRTC line (see: Configuration of user with WebRTC line),
have a SSL/TLS certificate signed by a certification authority installed on the nginx of XiVO CC (see: Signed SSL/TLS certificate for WebRTC),
and use https:
UC Assistant: you must connect to the UC Assistant via https protocol,
Desktop Application: you must check Protocol -> Secure in the application parameters.
Note
Currently you can not have a user configured for both WebRTC and a phone set at the same time.
WebRTC Features
The UC Assistant, CC Agent and Switchboard can be used by users with WebRTC configuration, without physical phone.
For configuration and requirements, see WebRTC Environment.
*55 (echo test)
To test your microphone and speaker, you may call the echo test application. After a welcome message, the application will echo everything what you speak.
Dial the *55 number.
You should hear the “Echo” announcement.
- After the announcement, you will hear back everything you say.
If you hear what you are saying it means that your microphone and speakers are working.
Press # or hangup to exit the echo test application.
Plantronics Devices Actions (Windows only)
Note
New feature of Freya. Works only with devices in the supported list on Windows 10.
This new feature allows plantronics devices among the supported list to answer or hangup calls with their associated button. Besides the plantronics device, it requires the plantronics hub to be installed and running on the user Windows 10 machine.
The plantronics service is loaded when logging in. To use it correctly be sure to have your device connected and to have the plantronics hub (referenced as plantronics software) running while logging in.
Depending of the case, pushing the button should start the followings actions :
if your webrtc is ringing, you will answer
if your webrtc is dialing, you will hangup
if you are in a call or a conference, you will hangup
if the only call or conference you have is on hold, you will retrieve it
Each of those actions can still be completed as usual, but the service offers you a new way to do them.
Ringing device and ringing tone
When receiving a call, your computer will play a ringing sound. However, you can choose to play this sound on a separate audio device than the default selected by your operating system. For example, on a configuration with a headset, this device may be your default device but you can override this selection to play the ringing sound on your computer instead.
You can also choose to change your ringtone sound, both those options are available in the respective menu of the UCAssistant, CCAgent, and Switchboard, on the top right corner.
This feature is only available when using a WebRTC line.
Mute your microphone
Being a webrtc user allows you to mute your microphone while being in a call with somebody. Clicking this button again will unmute the microphone. Clicking directly on the volume meter will have the same effect as clicking on the mute button. The little microphone icon in the volume meter will change according to your mute state.
On UC Assistant :
On CC Agent and Switchboard :
Volume indication
Two progress bars show the volume level of the speaker and the microphone. It certifies that the audio flow has been sent.
Sound detection
During the first five seconds of your call, if the application detect that there is no sound coming from your microphone, a small message will appear.
Call quality detection
If the call quality can be impacted by some network issues or server configuration issues, a small message will appear.
The message will stay up to 10 seconds after the audio quality is back to normal. The advanced statistics in the “show details” section and the play icon colors are updated live.
The current treshold are as following :
- Quality goes to medium when something is higher than :
Jitter: 50 ms
Packet losts: 10%
Round trip time: 150 ms
- Quality goes to bad when something is higher than :
Jitter: 100 ms
Packet losts: 20%
Round trip time: 300 ms
Call quality server-side feedbacks
If the quality of a call goes wrong, a live statistics feedback will be sent to the server. There will also be an automatic feedback at the end of each call, giving informations on the point where the call quality was at it’s worst state. For more informations on those logs - see Audio quality issues.
Additional details
Live feedbacks
Live audio quality measurement is taken every 2 seconds. If the quality is bad enough compared to the treshold, they are visible on the user interface as a small yellow message, and are also visible in the browser console. The statistics that are calculated using those measurements are done using the segment of time inbetween the last measurement and the new one, so it will be the last 2 seconds of the call for each measurement. The quality feedbacks are sent in xuc server logs only when it deteriorate enough to match the medium or bad quality treshold, and they respect a pause of at least 20 seconds inbetween each one to prevent flooding logs. For more informations on those logs - see Audio quality issues.
End of call report
The quality report at the end of each call is always sent to the xuc server logs even if the call went well. The statistics that are present in this end of call report are equals to the worst numbers found during the call. For example, if at some point the user had a spike of 20% packet loss during a few seconds but the rest of the call went well, the report will state that the packet loss spike was 20%. It is the same with jitter and RTT. It’s not an average, it’s always the highest detected statistic. For more informations on those logs - see Audio quality issues.
Upload and download directions
The upload direction is the direction from the user point of view (local outbound flow) sending data to the server (remote inbound flow). The download direction is the direction from the server point of view (remote outbound flow) sending data to the user (local inbound flow)
Opus Codec
By default WebRTC line uses the Opus codec.
It enhances the audio quality of calls with a lower bitrate (around 20kbps with the current configuration compared to 64kbps for alaw codec).
Limitations
Known limitation are :
Voice may not be able to hear if your computer have more than 4 network interfaces up at the same time (this can happen if you use virtualization)
Note
ls /sys/class/net
ifdown <ifname>
Additional chrome WebRTC-specific options
There are various additional settings used in the code. They are used to improve audio quality by enabling or disabling chrome WebRTC-specific flags.
Note
Chrome currently supports these audio quality options :
Automatic gain control : Adjust voice sound level to make it linear, lowering sound level when the user speaks too loudly.
Echo cancellation : Detect and delete echo coming from the playback of the user’s own voice.
Noise suppression : Cancel background noises coming from the user’s environment.
Highpass filter : Filters out low frequencies noises (like microphone background buzzing permanent sound).
Audio mirroring : Reflect sound coming from different directions into a focus point (similar to a parabola).
Typing noise detection : Detect and delete keypress sounds.
The current production code is set as follows :
googAutoGainControl is set to false
googAutoGainControl2 is set to false
googEchoCancellation is set to true
googEchoCancellation2 is set to true
googNoiseSuppression is set to false
googNoiseSuppression2 is set to false
googHighpassFilter is set to false
googAudioMirroring is set to false
googTypingNoiseDetection is set to true
Note