JoinOptions

The JoinOptions model defines how the application expects to join a conference.

For more information related to JoinOptions in terms of media preference, see MediaStreamConstraints.

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: any

Sets the conference WebRTC constraints. By default, only audio is enabled: {audio: true, video: false} unless a video has been started before joining a conference.

Note: A video started before joining a conference will be added to the conference if video constraints are unfilled.


customVideoTrack

Optional customVideoTrack: MediaStreamTrack

A custom video track object to add to a conference. Defining this property causes ignoring video constraints defined in the constraints property.


forwardingStrategy

Optional forwardingStrategy: VideoForwardingStrategy

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


dvwc

Optional dvwc: boolean

Changes the audio codec used in Dolby Voice conferences in SDK 3.5 and later versions:

  • If set to true, the SDK uses the Dolby Voice Codec (DVC) on Chrome and Edge on desktop operating systems; on other browsers and mobile operating systems, the SDK uses Opus. If, for some reason, DVC cannot be used in a conference, the SDK uses Opus.

  • If set to false, the SDK uses Opus on all browsers and operating systems.

By default, this parameter is set to false. For more information about the supported audio codecs, see the Dolby Voice document.


leaveConferenceOnBeforeUnload

Optional leaveConferenceOnBeforeUnload: boolean

Allows handling the beforeunload event on the application level instead of on the SDK level. By default, the SDK listens to the beforeunload event and leaves a conference when this event is triggered. When leaveConferenceOnBeforeUnload is set to false, the SDK stops reacting on the beforeunload event, which allows customizing the beforeunload handling. When leaveConferenceOnBeforeUnload is set to false, the SDK does not react to events such as closing a tab to leave a conference and such events need to be also handled on the application level.


maxVideoForwarding

Optional maxVideoForwarding: number

Sets the maximum number of video streams that may be transmitted to the joining participant. The valid parameter's values are between 0 and 25 for desktop browsers and between 0 and 4 for mobile browsers. In the case of providing a value smaller than 0 or greater than the valid values, SDK triggers the VideoForwardingError. If the parameter value is not specified, the SDK automatically sets the maximum possible value: 25 for desktop browsers and 4 for mobile browsers.

This property is available in SDK 3.1 and later.


mixing

Optional mixing: MixingOptions

Allows joining conferences as Mixer.


preferRecvMono

Optional preferRecvMono: Boolean

Indicates whether a participant wants to receive mono sound. By default, participants receive stereo audio. This configuration is only applicable when using the Opus codec and is available in non-Dolby Voice and Dolby Voice conferences.


preferSendMono

Optional preferSendMono: Boolean

Indicates whether a participant wants to send mono sound to a conference. By default, when using the Opus codec, participants' audio is sent as stereo. This configuration is only applicable when using the Opus codec and is available in non-Dolby Voice and Dolby Voice conferences.


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 participantUpdated event to ensure that all participants are assigned to specific positions.


videoFilter

Optional videoFilter: VideoFilter

The video filter that allows blurring or changing the local participant's background. The video filters are available only for the Dolby.io Communications SDK for Desktop users.


videoFilterOptions

Optional videoFilterOptions: VideoFilterOptions

Video filter options that include the image file for the staticImage filter and information about the video stream on which the video filter should be applied.


videoProcessor

Optional videoProcessor: VideoProcessor

The video processor that allows blurring or changing the local participant's background. This property is available only in SDK 3.7 and later.


Did this page help you?