The Portal offers Automatic Bandwidth Detection (ABWD) to ensure optimum Audio/ Video Communication based on the available bandwidth at the Client endpoint. In case Video Call is not feasible at an End Point because of low-bandwidth, communication falls back to Audio-Only call. When bandwidth improves, Video communication is restored automatically.
The ABWD detects a change in the available bandwidth when it cannot continue to support all the Videos being received and notifies the Client endpoint with Callback room-bandwidth-alert. You can handle this event by choosing to reduce the number of Active Talker’s Videos being received or by switching to audio-only mode.
This helps users facing extremely poor network conditions to go into audio-only mode without disrupting the session.
Event Listener: room-bandwidth-alert
- Notification is sent to the affected Client endpoint when:
- Bandwidth at the endpoint reduces to a level where all Videos being received cannot be supported.
- Bandwidth at the endpoint increases to a level where more Videos than those currently being received can be supported.
- Notification is not triggered for any bandwidth fluctuation that does not affect the number of Videos being received at the Client endpoint.
// To receive notification
room.addEventListener("room-bandwidth-alert", function (evt) {
/* evt carries JSON data, sample given below */
});
room-bandwidth-alert JSON Payload:
bandwidth– Updated (Reduced or Increased) Bandwidth at the Client endpoint.stream_bandwidth– Bandwidth consumption by streams.number_of_videos– Number of Videos that can be supported at the available bandwidth.
{
"msg": {
"bandwidth": 240,
"stream_bandwidth": 80,
"number_of_videos": 2
}
}