The Dolby.io Communications APIs conferencing infrastructure supports large conferences while maintaining high audio and video quality. The conferencing infrastructure also offers a mechanism that prevents overloading conferences.
This article describes a conference capacity in relation to participants. There are two types of participants: users who join conferences using the join method and listeners who join conferences using the listen method. Users can send and receive streams whereas listeners can only receive streams. The ratio of users to listeners determines how many total participants can join a conference without degrading audio and video quality.
The supported number of users depends on the conference type and the audio codec used. Non-Dolby Voice conferences support only the Opus codec. Dolby Voice conferences support the Opus codec for Web SDK users and the DVC codec for Android SDK, iOS SDK, and Desktop SDK users. The following table presents the supported number of users in different scenarios:
|Conference type||Codec||Shared media||Maximum number of users|
|Dolby Voice||DVC||Audio and video||50|
|Dolby Voice||Opus||Audio and video||50|
|Non-Dolby Voice||Opus||Audio and video||50|
Participants can only receive up to 25 video streams. In conferences where more than 25 users join a conference with an enabled camera, each conference participant receives video streams from only 25 users who actively talk. Applications can choose which streams to receive using the Video Forwarding API.
The maximum number of listeners who may join a conference depends on the number of users that are in the same conference. In a conference where only one user shares audio and video, the platform can support up to 5000 listeners. If more users join a conference, the maximum number of listeners decreases. In an audio-only conference, the platform can handle up to 5000 listeners, with up to 50 users. The following table presents the supported number of listeners in different scenarios:
|Number of users||Shared media||Maximum number of listeners|
|1 - 50||Audio||5000|
|1 - 10||Audio and video||3000|
|11 - 50||Audio and video||120|
To handle large webinars, we disabled the participantAdded and participantUpdated events for listeners. Listeners only receive events about users; they do not receive events for other listeners. In SDK 3.2 and prior releases, users receive events about users and the first 1000 listeners. However, in SDK 3.3 and next releases, users receive events about other users and do not receive any events about listeners. To notify all application users about the number of participants who are present at a conference, SDK 3.3 introduces the activeParticipants events. If you want to continue to use participantAdded and participantUpdated for listener events, please contact contact the Dolby.io Support team to enable the events through backend configuration.
Overloading conferences may trigger a decreased audio and video quality and result in a poor experience for end-users. To avoid such behavior, the Communications APIs platform offers a capacity limit mechanism that impacts streams distributed by the platform. If a conference capacity reaches the limit, the mechanism does not allow additional participants to join the conference. Participants who can exceed the limit are not able to join a conference and receive ConferenceAtMaxCapacityError in the case of the Web SDK, capacityLimit error in the case of iOS SDK, and ConferenceAtMaxCapacityError in the case of Android SDK. The Dolby Communications APIs platform does not allow creating conferences that may exceed the capacity limit.
Updated 29 days ago