ConferenceJoinOptions.Builder

The ConferenceJoinOptions.Builder model constructs the ConferenceJoinOptions model that defines how the application expects to join a conference.

Available in the package com.voxeet.sdk.services.builders.ConferenceJoinOptions.Builder.

Constructors

Builder

Builder(@NonNull conference: Conference)

Creates a new builder.

Parameters

NameTypeDescription
conferenceConferencenon null valid conference.

Methods

setConstraints

setConstraints(@NonNull constraints: Constraints): ConferenceJoinOptions.Builder

Parameters

NameTypeDescription
constraintsConstraintsnon null

Returns: ConferenceJoinOptions.Builder


setConferenceParticipantType

setConferenceParticipantType(@NonNull conferenceParticipantType: ConferenceParticipantType): ConferenceJoinOptions.Builder

Sets the type of the joining participant, from a local point of view.
There are the following participant types:

  • normal - the default value
  • broadcaster - a participant can actively participate in a conference and transmit media to the rest of conference participants
  • listener - a participant can only listen to a conference and cannot actively participate

Parameters

NameTypeDescription
conferenceParticipantTypeConferenceParticipantTypenon null specified type of the conference participant

Returns: ConferenceJoinOptions.Builder - the builder instance.


setVideoForwardingStrategy

setVideoForwardingStrategy(@NonNull videoForwardingStrategy: VideoForwardingStrategy): ConferenceJoinOptions.Builder

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

Parameters

NameTypeDescription
videoForwardingStrategyVideoForwardingStrategynon null The strategy that defines how the SDK should select conference participants whose videos will be received by the local participant. The selection can be either based on the participants' audio volume or the distance from the local participant.

Returns: ConferenceJoinOptions.Builder


setMaxVideoForwarding

setMaxVideoForwarding(max: int): ConferenceJoinOptions.Builder

Sets the maximum number of video streams that may be transmitted to the joining participant. The valid values are between 0 and 49.

Parameters

NameTypeDescription
maxintThe maximum number of video streams that may be transmitted to the local participant. The valid values are between 0 and 49. The default value is 4. In the case of providing a value smaller than 0, SDK triggers the IllegalStateException error. In the case of providing a value greater than 49, the Dolby.io server triggers an error.

Returns: ConferenceJoinOptions.Builder - the builder instance.


setConferenceAccessToken

setConferenceAccessToken(@NonNull conferenceAccessToken: String): ConferenceJoinOptions.Builder

The conference access token received from the create or invite REST API. The conference access token is required to join a protected conference. For more information, see the Enhanced Conference Access Control article.

Parameters

NameTypeDescription
conferenceAccessTokenStringnon null the Conference Access Token

Returns: ConferenceJoinOptions.Builder - the builder instance.


setSpatialAudio

setSpatialAudio(@NonNull spatialAudio: boolean): ConferenceJoinOptions.Builder

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

Parameters

NameTypeDescription
spatialAudiobooleannon null A flag indicating if the local participant wants to join a conference with spatial audio enabled.

Returns: ConferenceJoinOptions.Builder - The builder instance.


build

build(): ConferenceJoinOptions

Constructs the corresponding ConferenceJoinOptions from the data set.

Returns: @NonNull ConferenceJoinOptions - a new valid instance of the conference join representation.

❗️

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

Parameters

NameTypeDescription
spatialAudiobooleannon null A flag indicating if the local participant wants to join a conference with spatial audio enabled.

Returns: ConferenceJoinOptions.Builder - The builder instance.


build

build(): ConferenceJoinOptions

Constructs the corresponding ConferenceJoinOptions from the data set.

Returns: @NonNull ConferenceJoinOptions - a new valid instance of the conference join representation.