ConferenceJoinOptions

The ConferenceJoinOptions interface defines how an application expects to join a conference in terms of media preference.

Properties

conferenceAccessToken

Optional conferenceAccessToken: string

The conference access token that is required to join a protected conference if the conference is created using the create REST API. If the conference is created using the create method, the token is managed by the SDK and is not visible to the application users. For more information, see the Enhanced Conference Access Control document.


constraints

Optional constraints: ConferenceConstraints

Sets the conference WebRTC constraints. By default, only audio is enabled: {audio: true, video: false}.


maxVideoForwarding

Optional maxVideoForwarding: number

Sets the maximum number of video streams that may be transmitted to the joining participant. The valid parameter values are between 0 and 4 for mobile browsers, with 4 set as the default value.


mixing

Optional mixing: ConferenceMixingOptions

Allows joining conferences as a special participant called Mixer. For more information, see the Recording Conferences article.


preferRecvMono

Optional preferRecvMono: boolean

Indicates whether a participant wants to receive mono sound. By default, the property is set to false.


preferSendMono

Optional preferSendMono: boolean

Indicates whether a participant wants to send mono sound to a conference. By default, the property is set to true in most cases. The only situation when the property is set to false is when you set the capture mode to Unprocessed before joining a conference while using Opus.


simulcast

Optional simulcast: boolean

Enables sending the Simulcast video streams to other conference participants.


spatialAudio

Optional spatialAudio: boolean

Enables spatial audio for the local participant who joins a Dolby Voice conference. By default, this parameter is set to false. When set to true in a conference that uses the individual spatial audio style, the application must place remote participants in a 3D space using the setSpatialPosition method.

❗️

Warning

In the individual spatial audio style, remote participants' audio is disabled until the participants are assigned to specific locations. We recommend calling setSpatialPosition from the participantAdded event to ensure that all participants are assigned to specific positions.


videoForwardingStrategy

Optional videoForwardingStrategy: VideoForwardingStrategy

Changes the video forwarding strategy for the local participant. This option is available only in SDK 3.6 and later.