Conference Service for Android | Video SDK

The ConferenceService allows the application to manage the conference life cycle and interact with the conference.

Typical application APIs workflow:

1. The application creates a conference.

2. The application uses the fetchConference method to obtain the conference object.

3. The application can choose to either:

Join a conference
Replay a conference
Listen to a conference
Broadcast a conference

4. The application can request a specific quality of Simulcast video streams through the Simulcast method.

5. The application can start and stop sending the local participant's audio streams to the conference.

6. The application can start and stop sending the local participant's video streams to the conference. The application can also start and stop sending the remote participants' video streams to the local participant.

7. During a conference, the application can:

Customize the number of the received video streams, select the video forwarding strategy, and prioritize the selected participants' video streams.
Mute the local or remote participant
Check if the local participant is muted
Control playing remote participants' audio to the local participant.
Inform whether the application plays the remote participants' audio to the local participant.
Check which participant is speaking
Check the audio level of a specific participant
Decrease network bandwidth consumption by disabling participants' video streams
Get information about the conference, such as the conference type, Conference object, conference status
Get information about conference participants, such as the participant instance, information if a participant is present at a conference, a list of invited participants, a list of all conference participants, and information if at least one participant is present at a conference.
Cancel timeout
Check the standard WebRTC statistics for the application
Control the audio processing state through the setAudioProcessing method.
Check the audio processing state through the getAudioProcessing method.
Kick a participant from a conference.
Update the participant's permissions.
Set a participant's position to enable the spatial audio experience during a Dolby Voice conference
Configure a spatial environment of the application for the spatial audio feature
Set the direction a participant is facing during a conference with enabled spatial audio

8. The application calls the leave method to leave a conference.

The application can interact with the service through these events:

The ConferenceHistoryResult event provides historical conference details.
The ConferenceTimeoutNoParticipantsJoinedEvent informs that during the maximum awaiting time nobody has joined the current participant at a conference.
The IncomingCallEvent informs about incoming calls.
The VideoStateEvent informs about the state of the local video.
The ParticipantAddedEvent and the ParticipantUpdatedEvent notify about participants status changes.
The QualityIndicators event informs about the audio quality.
The ConferenceStatusUpdatedEvent informs about conference status changes.
The StreamAddedEvent, StreamUpdatedEvent, and the StreamRemovedEvent notify about changes in stream statuses.

Warning: Always implement the error for each called promise. You can also use the execute method, but in case of exceptions, you will trigger errors.

Available in the package com.voxeet.sdk.services.ConferenceService.

Methods

mute

▸ mute(mute: boolean): boolean

Stops playing the local participant's audio to the conference. The mute method does not notify the server to stop audio stream transmission.

Parameters

Name	Type	Description
mute	boolean	A boolean, true indicates that the local participant is muted, false indicates that a participant is not muted

Returns: boolean - informs if the mute state has changed.

mute

▸ mute(@NonNull participant: Participant, mute: boolean): boolean

Stops playing the specified remote participants' audio to the local participant. The mute method does not notify the server to stop audio stream transmission.

Note: This API is not supported when the client connects to a Dolby Voice conference. If you wish to mute remote participants in Dolby Voice conferences, you must use the stopAudio API. This API allows the conference participants to stop receiving the specific audio streams from the server.

Parameters

Name	Type	Description
participant	Participant	non null A remote participant
mute	boolean	A boolean, true indicates that the participant is muted, false indicates that a participant is not muted

Returns: boolean - informs if the mute state has changed.

isMuted

▸ isMuted(): boolean

Informs whether the local participant is muted.

Note: This API is no longer supported for remote participants.

Returns: boolean - information if the local participant is muted. Returns false if the participant is not muted or is not present at the conference. Returns true if the participant is muted.

muteOutput

▸ muteOutput(mute: boolean): boolean

Controls playing remote participants' audio to the local participant.

Note: This API is only supported when the client connects to a Dolby Voice conference.

Parameters

Name	Type	Description
mute	boolean	A boolean, true indicates that remote participants are muted, false indicates that remote participants are not muted.

Returns: boolean - a boolean indicating whether remote participants are muted.

setAudioProcessing

▸ setAudioProcessing(@NonNull audioProcessing: AudioProcessing): boolean

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the setCaptureMode method.

Enables and disables audio processing for the local participant.

Parameters

Name	Type	Description
audioProcessing	AudioProcessing	non null The audio processing mode

Returns: boolean - a boolean indicating whether the audio processing mode is updated.

getAudioProcessing

▸ getAudioProcessing(): AudioProcessing

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the getCaptureMode method.

Gets the current audio processing state for a conference.

Returns: @NonNull AudioProcessing - the audio processing mode.

isOutputMuted

▸ isOutputMuted(): boolean

Informs whether the application plays the remote participants' audio to the local participant.

Returns: boolean - a boolean indicating whether the application plays the remote participants' audio to the local participant.

isSpeaking

▸ isSpeaking(@NonNull participant: Participant): boolean

Indicates whether the current participant is speaking.

Parameters

Name	Type	Description
participant	Participant	non null participant

Returns: boolean - a boolean indicating whether the current participant is speaking.

findParticipantById

▸ findParticipantById(@NonNull participantId: String): Participant

Provides the instance of the desired participant.

Parameters

Name	Type	Description
participantId	String	non null participant's ID

Returns: @Nullable Participant - the instance of the participant. The null value informs that the conference or the participant does not exist in the current time session.

getConferenceType

▸ getConferenceType(): LocalConferenceType

Gets the current conference type.

Returns: @NonNull LocalConferenceType - the ConferenceType. the ConferenceType.NONE is a default value.

getConference

▸ getConference(): Conference

Gets the current Conference object.

Returns: @Nullable Conference - the nullable object.

isInConference

▸ isInConference(): boolean

Informs if the specific conference exists. It can be used together with the ConferenceStatus.

Returns: boolean - Returns true if the conference exists or if the connection attempt to the conference is pending.

audioLevel

▸ audioLevel(@Nullable participant: Participant): double

Gets the participant's audio level. The audio level value ranges from 0.0 to 1.0.

Note: When the local participant is muted, the audioLevel value is set to a non-zero value, and isSpeaking is set to true if the audioLevel is greater than 0.05. This implementation allows adding a warning message to notify the local participant that their audio is not sent to a conference.

Parameters

Name	Type	Description
participant	Participant	nullable participant, the value can be safely set to an incorrect one

Returns: double - the value between 0 and 1.

startVideo

▸ startVideo(): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the start methods that are available in the LocalVideo and RemoteVideo models.

Notifies the server to either start sending the local participant's video stream to the conference or start sending a remote participant's video stream to the local participant. The startVideo method does not control the remote participant's video stream; if a remote participant does not transmit any video stream, the local participant cannot change it using the startVideo method.

The reject value informs about PromisePermissionRefusedEventException or MediaException.

If the application does not have a permission sto start a video stream, it emits PermissionRefusedEvent.

Returns: @NonNull Promise<Boolean>

stopVideo

▸ stopVideo(): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the stop methods that are available in the LocalVideo and RemoteVideo models.

Notifies the server to either stop sending the local participant's video stream to the conference or stop sending a remote participant's video stream to the local participant.
Use this method only when the current participant is at the conference, otherwise the application emits an exception in the catch block of the promise.

Returns: @NonNull Promise<Boolean> - the promise to resolve.

startVideo

▸ startVideo(@NonNull participant: Participant): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the start methods that are available in the LocalVideo and RemoteVideo models.

Informs the server to start sending video streams of a specific participant.

Parameters

Name	Type	Description
participant	Participant	non null

Returns: @NonNull Promise<Boolean>

stopVideo

▸ stopVideo(@NonNull participant: Participant): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the stop methods that are available in the LocalVideo and RemoteVideo models.

Informs the server to stop sending video streams of a specific participant. Use this method to decrease network bandwidth consumption.

Parameters

Name	Type	Description
participant	Participant	non null

Returns: @NonNull Promise<Boolean>

startAudio

▸ startAudio(): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the start methods that are available in the LocalAudio and RemoteAudio models.

Starts sending local participant’s audio streams from the local client to the conference. The startAudio method in Dolby Voice conferences is not available for listeners.

The startAudio method requires up to a few seconds to become effective.

The possible audio track statuses: starting, started, or stopped.

Returns: @NonNull Promise<Boolean>

startAudio

▸ startAudio(@NonNull participant: Participant): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the start methods that are available in the LocalAudio and RemoteAudio models.

Starts sending remote participant’s audio from the conference to the local client. This allows the local participant to unmute remote participants who are locally muted through the stopAudio method. The startAudio method impacts only the audio streams that the local participant receives; the method does not impact the audio transmission between remote participants and a conference and does not allow the local participant to force sending remote participants’ streams to the conference or to the local participant.

The startAudio method in Dolby Voice conferences is not available for listeners.

The startAudio method requires up to a few seconds to become effective.

Parameters

Name	Type	Description
participant	Participant	non null The participant whose stream should be sent to the local participant.

Returns: @NonNull Promise<Boolean>

stopAudio

▸ stopAudio(): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the stop methods that are available in the LocalAudio and RemoteAudio models.

Stops sending local participant’s audio from the local client to the conference. The stopAudio method in Dolby Voice conferences is not available for listeners.

Leaving a conference resets the stopAudio settings. Participants who rejoin a conference need to provide the desired stopAudio parameters and call the stopAudio method once again.

The possible audio track statuses: stopping or started.

The stopAudio method requires up to a few seconds to become effective.

Returns: @NonNull Promise<Boolean>

stopAudio

▸ stopAudio(@NonNull participant: Participant): Promise<Boolean>

deprecated
Note: This method is deprecated in SDK 3.7 and replaced with the stop methods that are available in the LocalAudio and RemoteAudio models.

Stops sending remote participant’s audio from the conference to the local client. This allows the local participant to locally mute remote participants. The stopAudio method impacts only the audio streams that the local participant receives; the method does not impact the audio transmission between remote participants and a conference and does not allow the local participant to stop sending remote participants’ streams to the conference.

The stopAudio method in Dolby Voice conferences is not available for listeners.

Leaving a conference resets the stopAudio settings. Participants who rejoin a conference need to provide the desired stopAudio parameters and call the stopAudio method once again.

The stopAudio method requires up to a few seconds to become effective.

Parameters

Name	Type	Description
participant	Participant	non null The participant whose stream should not be sent to the local participant.

Returns: @NonNull Promise<Boolean>

create

▸ create(@NonNull conferenceCreateOptions: ConferenceCreateOptions): Promise<Conference>

Creates the conference based on information from the ConferenceCreateOptions.

Parameters

Name	Type	Description
conferenceCreateOptions	ConferenceCreateOptions	non null information holder where the ID, parameters, and metadata can be passed

Returns: @NonNull Promise<Conference> - the conference creation information holder.

listen

▸ listen(@NonNull conference: Conference): Promise<Conference>

Joins the conference in the listener mode in which the conference participant can only receive video and audio and cannot transmit any media.

Possible rejection causes :

ServerErrorException
InConferenceException
MediaEngineException
ParticipantAddedErrorEventException

Note: Conference events from other listeners are not available for listeners. Only users will receive conference events from other listeners.

Parameters

Name	Type	Description
conference	Conference	non null conference

Returns: @NonNull Promise<Conference> - the promise to resolve.

listen

▸ listen(@NonNull options: ConferenceListenOptions): Promise<Conference>

Joins the conference in the listener mode in which the conference participant can only receive video and audio and cannot transmit any media.

Possible rejection causes :

ServerErrorException
InConferenceException
MediaEngineException
ParticipantAddedErrorEventException

Parameters

Name	Type	Description
options	ConferenceListenOptions	non null the holder of the options to join

Returns: @NonNull Promise<Conference> - the promise to resolve.

broadcast

▸ broadcast(@NonNull conference: Conference): Promise<Conference>

Joins the conference in the broadcaster mode which allows transmitting audio and video.

Possible rejection causes:

ServerErrorException
InConferenceException
MediaEngineException
ParticipantAddedErrorEventException

Parameters

Name	Type	Description
conference	Conference	non null conference

Returns: @NonNull Promise<Conference> - the promise to resolve.

join

▸ join(@NonNull options: ConferenceJoinOptions): Promise<Conference>

Joins the conference with the conference. The ConferenceJoinOptions model can be constructed using the ConferenceJoinOptions.Builder model.

The possible exception in the rejection:

ServerErrorException
InConferenceException
MediaEngineException
ParticipantAddedErrorEventException

Parameters

Name	Type	Description
options	ConferenceJoinOptions	non null the holder of the options to join

Returns: @NonNull Promise<Conference> - the promise to resolve.

kick

▸ kick(@NonNull participant: Participant): Promise<Boolean>

Allows the conference owner, or a participant with adequate permissions, to kick another participant from the conference by revoking the conference access token. The kicked participant cannot join the conference again.

Parameters

Name	Type	Description
participant	Participant	non null The participant who needs to be kicked from the conference.

Returns: @NonNull Promise<Boolean> - the promise to resolve.

updatePermissions

▸ updatePermissions(@NonNull participantPermissions: List<ParticipantPermissions>): Promise<Boolean>

Updates the participant's conference permissions. If a participant does not have permission to perform a specific action, this action is not available for this participant during a conference, and the participant receives ConferencePermissionException. If a participant started a specific action and then lost permission to perform this action, the SDK stops the blocked action. For example, if a participant started sharing a screen and received the updated permissions that do not allow him to share a screen, the SDK stops the screen sharing session and the participant cannot start sharing the screen again.

Parameters

Name	Type	Description
participantPermissions	List<ParticipantPermissions>	non null An array of ParticipantPermissions that includes the new participant's permissions.

Returns: @NonNull Promise<Boolean> - a promise with a boolean indicating conference permissions were successfully updated.

replay

▸ replay(@NonNull conference: Conference, offset: long): Promise<Conference>

Replays the previously recorded conference. For more information, see the Recording Conferences article.

Possible rejection causes:

ServerErrorException
InConferenceException
MediaEngineException
ParticipantAddedErrorEventException

Parameters

Name	Type	Description
conference	Conference	non null conference
offset	long	the offset to start with

Returns: @NonNull Promise<Conference> - the promise to resolve that indicates the result of the request.

localStats

▸ localStats(): Map<String, JSONArray>

Provides standard WebRTC statistics for the application to implement its own quality monitoring mechanisms.

Returns: @NonNull Map<String, JSONArray> - The WebRTC Stat Matrix.

getConferenceStatus

▸ getConferenceStatus(conferenceId: String): Promise<ConferenceStatusResult>

Gets the conference status.

Parameters

Name	Type	Description
conferenceId	String	the conference ID

Returns: @NonNull Promise<ConferenceStatusResult> - the promise to resolve containing the ConferenceStatusResult.

simulcast

▸ simulcast(@NonNull requested: List<ParticipantQuality>): Promise<Boolean>

Requests a specific quality of the received Simulcast video streams. Use this method only for selected conference participants or for all participants that are present at the conference.

Parameters

Name	Type	Description
requested	List<ParticipantQuality>	non null list of simulcast configurations

Returns: @NonNull Promise<Boolean> - the promise to resolve.

getMaxVideoForwarding

▸ getMaxVideoForwarding(): Integer

Gets the maximum number of video streams that may be transmitted to the local participant.

Returns: @Nullable Integer - The maximum number of video streams that the local participant can receive in the current conference.

getVideoForwardingStrategy

▸ getVideoForwardingStrategy(): VideoForwardingStrategy

Gets the video forwarding strategy that the local participant uses in the current conference. This method is available only in SDK 3.6 and later.

Returns: @Nullable VideoForwardingStrategy - The strategy that the local participant uses in the current conference.

videoForwarding

▸ videoForwarding(max: int, @Nullable participants: List<Participant>): Promise<Boolean>

deprecated
Sets the maximum number of video streams that may be transmitted to the local participant. This method also allows the local participant to use a pin option to prioritize the specific participant's video streams and display their videos even when these participants do not talk. For more information, see the Video Forwarding article.

This method was introduced in SDK 3.1 and deprecated in SDK 3.6.

Parameters

Name	Type	Description
max	int	The maximum number of video streams that may be transmitted to the local participant. The valid values are between 0 and 25. 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 25, the Dolby.io server triggers an error.
participants	List<Participant>	nullable The list of participant objects.

Returns: @NonNull Promise<Boolean>

videoForwarding

▸ videoForwarding(@NonNull options: VideoForwardingOptions): Promise<Boolean>

Sets the video forwarding functionality for the local participant. The method allows:

Setting the maximum number of video streams that may be transmitted to the local participant
Prioritizing specific participants' video streams that need to be transmitted to the local participant
Changing the video forwarding strategy that defines how the SDK should select conference participants whose videos will be received by the local participant

This method is available only in SDK 3.6 and later.

Parameters

Name	Type	Description
options	VideoForwardingOptions	non null The video forwarding options.

Returns: @NonNull Promise<Boolean>

getInvitedParticipants

▸ getInvitedParticipants(@NonNull conferenceId: String): Promise<ConferenceParticipantsInvitedResult>

Retrieves the list of participants invited to the conference.

Parameters

Name	Type	Description
conferenceId	String	non null conference ID

Returns: @NonNull Promise<ConferenceParticipantsInvitedResult> - the promise to resolve.

getParticipants

▸ getParticipants(): List<Participant>

Retrieves a list of conference participants.

Returns: @NonNull List<Participant> - A list of conference participants.

leave

▸ leave(): Promise<Boolean>

Leaves the current conference.

Returns: @NonNull Promise<Boolean>

fetchConference

▸ fetchConference(@NonNull conferenceId: String): Promise<Conference>

Provides a Conference object that allows joining a conference. For more information about using the fetch method, see the Conferencing document.

Parameters

Name	Type	Description
conferenceId	String	non null conference ID.

Returns: @NonNull Promise<Conference> - the ConferenceInformation in the Promise to resolve.

hasParticipants

▸ hasParticipants(): boolean

Informs that at least one participant is actively connected.

Returns: boolean - indicates if at least one participant is actively connected to the conference.

setSpatialDirection

▸ setSpatialDirection(@NonNull direction: SpatialDirection): void

Sets the direction the local participant is facing in space. This method is available only for participants who joined the conference with the setSpatialAudio parameter enabled. Otherwise, SDK triggers the SpatialAudioException.

This method is not available for listeners. To set a spatial direction for listeners, use the Set Spatial Listeners Audio REST API. Using setSpatialDirection for listeners triggers the SpatialAudioException.

If the local participant hears audio from the position (0,0,0) facing down the Z-axis and locates a remote participant in the position (1,0,1), the local participant hears the remote participant from their front-right. If the local participant chooses to change the direction they are facing and rotate +90 degrees about the Y-axis, then instead of hearing the speaker from the front-right position, they hear the speaker from the front-left position. The following video presents this example:

Parameters

Name	Type	Description
direction	SpatialDirection	non null The direction the local participant is facing in space.

setSpatialEnvironment

▸ setSpatialEnvironment(@NonNull scale: SpatialScale, @NonNull forward: SpatialPosition, @NonNull up: SpatialPosition, @NonNull right: SpatialPosition): void

Configures a spatial environment of an application, so the audio renderer understands which directions the application considers forward, up, and right and which units it uses for distance. This method is available only for participants who joined the conference with the setSpatialAudio parameter enabled. Otherwise, SDK triggers the SpatialAudioException.

This method is not available for listeners. To set a spatial environment for listeners, use the Set Spatial Listeners Audio REST API. Using setSpatialEnvironment for listeners triggers the SpatialAudioException.

If not called, the SDK uses the default spatial environment, which consists of the following values:

forward = (0, 0, 1), where +Z axis is in front
up = (0, 1, 0), where +Y axis is above
right = (1, 0, 0), where +X axis is to the right
scale = (1, 1, 1), where one unit on any axis is 1 meter

The default spatial environment is presented in the following diagram:

Parameters

Name	Type	Description
scale	SpatialScale	non null A scale that defines how to convert units from the coordinate system of an application (pixels or centimeters) into meters used by the spatial audio coordinate system. For example, if SpatialScale is set to (100,100,100), it indicates that 100 of the applications units (cm) map to 1 meter for the audio coordinates. In such a case, if the listener's location is (0,0,0)cm and a remote participant's location is (200,200,200)cm, the listener has an impression of hearing the remote participant from the (2,2,2)m location. The scale value must be greater than 0. For more information, see the Spatial Audio article.
forward	SpatialPosition	non null A vector describing the direction the application considers as forward. The value can be either +1, 0, or -1 and must be orthogonal to up and right.
up	SpatialPosition	non null A vector describing the direction the application considers as up. The value can be either +1, 0, or -1 and must be orthogonal to forward and right.
right	SpatialPosition	non null A vector describing the direction the application considers as right. The value can be either +1, 0, or -1 and must be orthogonal to forward and up.

setSpatialPosition

▸ setSpatialPosition(@NonNull position: SpatialPosition): void

Sets a location from which the local participant listens to a Dolby Voice conference with enabled spatial audio. If the local participant does not have an established location, the participant hears audio from the default location (0, 0, 0). This method is available for the local participant only if the participant joined a conference with the setSpatialAudio parameter enabled. Otherwise, SDK triggers the SpatialAudioException.

This method is not available for listeners. To set a spatial position for listeners, use the Set Spatial Listeners Audio REST API. Using setSpatialPosition for listeners triggers the SpatialAudioException.

For example, if a local participant Eric, who does not have a set direction, calls setSpatialPosition(VoxeetSDK.session.participant, {x:3,y:0,z:0}), Eric hears audio from the position (3,0,0).

Parameters

Name	Type	Description
position	SpatialPosition	non null The location from which the participant will hear a conference.

setSpatialPosition

▸ setSpatialPosition(@NonNull participant: Participant, @NonNull position: SpatialPosition): void

Sets a remote participant's position in space in a Dolby Voice conference to render the participant's audio from the specified location. Setting the remote participants’ positions is required in conferences that use the individual spatial audio style. In these conferences, if a remote participant does not have an established location, the participant does not have a default position and will remain muted until a position is specified. The shared spatial audio style does not support setting the remote participants' positions. In conferences that use the shared style, the spatial scene is shared by all participants, so that each client can set a position and participate in the shared scene. Calling this method for remote participants in the shared spatial audio style triggers the SpatialAudioException.

This method is available only for participants who joined a conference using the join method with the setSpatialAudio parameter enabled. Otherwise, SDK triggers the SpatialAudioException. To set a spatial position for listeners, use the Set Spatial Listeners Audio REST API.

For example, if a local participant Eric, who does not have a set direction, calls setSpatialPosition(VoxeetSDK.session.participant, {x:3,y:0,z:0}), Eric hears audio from the position (3,0,0). If Eric also calls setSpatialPosition(Sophia, {x:7,y:1,z:2}), he hears Sophia from the position (7,1,2). In this case, Eric hears Sophia 4 meters to the right, 1 meter above, and 2 meters in front. The following graphic presents the participants' locations:

Parameters

Name	Type	Description
participant	Participant	non null The selected remote participant.
position	SpatialPosition	non null The participant's audio location from which their audio will be rendered.

Events

ActiveSpeakerChangeEvent

Emitted when an active speaker changes during a conference.

Available in the package com.voxeet.sdk.events.v3.ActiveSpeakerChangeEvent.

conference (Conference)

The conference in which an active speaker changed.

activeParticipants (List)

The list of active speakers.

unknownActiveSpeakers (List)

The list of unknown active speakers who were not visible for the SDK due to a WebSocket issue.

ConferenceHistoryResult

Emitted when the application asks about historical conference elements (by calling the history restful endpoint).

Available in the package com.voxeet.sdk.events.sdk.ConferenceHistoryResult.

items (List)

The events list.

ConferenceStatusUpdatedEvent

Emitted when the conference changes status.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.sdk.ConferenceStatusUpdatedEvent.

state (ConferenceStatus)

The new status.

conference (Conference)

The conference. It can be a null value in case when nobody joined the conference.

conferenceAlias (String)

The conference alias. It is a mandatory property if nobody joined the conference.

error (Throwable)

The error object informing that participant's permissions changed.

ConferenceTimeoutNoParticipantsJoinedEvent

Emitted when within the maximum awaiting time nobody has joined the current participant at the conference.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.sdk.ConferenceTimeoutNoParticipantsJoinedEvent.

timeout (long)

A timeout set in the SDK.

IncomingCallEvent

Emitted when the application receives an incoming call. This event is optional when the NotificationService is properly referenced and set up on the developer side.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.sdk.IncomingCallEvent.

conferenceId (String)

The conference ID.

ParticipantAddedEvent

Emitted when a new participant is invited to a conference. The SDK does not emit ParticipantAddedEvent for a local participant. Listeners only receive the participantAdded 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 the participantAdded events about 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, the Android SDK 3.3 introduces the activeParticipants events.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.v2.ParticipantAddedEvent.

participant (Participant)

The conference participant.

ParticipantUpdatedEvent

Emitted when a participant changes ConferenceParticipantStatus. Listeners only receive the participantUpdated 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 the participantUpdated events about 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, the Android SDK 3.3 introduces the activeParticipants events.

The following graphic shows possible status changes during a conference:

5122 — Diagram that presents the possible status changes

This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.v2.ParticipantUpdatedEvent.

participant (Participant)

The conference participant.

PermissionsUpdatedEvent

Emitted when the local participant's permissions are updated.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.sdk.PermissionsUpdatedEvent.

permissions (Set)

The updated conference permissions.

QualityIndicators

The Mean Opinion Score (MOS) which represents the participants' audio quality. The SDK calculates the audio quality scores and displays the values in a range from 1 to 5, where 1 represents the worst quality and 5 represents the highest quality. In cases when the audio MOS score is not available, the mos property returns the value -1.
This object can be accessed through the WebSocket usage.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.sdk.QualityIndicators.

mos (float)

The quality indicator.

StreamAddedEvent

Emitted when the SDK adds a new stream to a conference participant. Each conference participant can be connected to two streams: the audio and video stream and the screen-share stream. If a participant enables audio or video, the SDK adds the audio and video stream to the participant and emits StreamAddedEvent to all participants. When a participant is connected to the audio and video stream and changes the stream, for example, enables a camera while using a microphone, the SDK updates the audio and video stream and emits StreamUpdatedEvent. When a participant starts sharing a screen, the SDK adds the screen-share stream to this participants and emits StreamAddedEvent to all participants. The following graphic shows this behavior:

3048 — The difference between the streamAdded and streamUpdated events

When a new participant joins a conference with enabled audio and video, the SDK emits StreamAddedEvent that includes audio and video tracks.

The SDK can also emit StreamAddedEvent only for the local participant. When the local participant uses the stopAudio method to locally mute the selected remote participant who does not use a camera, the local participant receives StreamRemovedEvent. After using the startAudio method for this remote participant, the local participant receives StreamAddedEvent.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.v2.StreamAddedEvent.

participant (Participant)

The conference participant.

mediaStream (MediaStream)

The media stream.

StreamRemovedEvent

Emitted when the SDK removes a stream from a conference participant. Each conference participant can be connected to two streams: the audio and video stream and the screen-share stream. If a participant disables audio and video or stops a screen-share presentation, the SDK removes the proper stream and emits StreamRemovedEvent to all conference participants.

The SDK can also emit StreamRemovedEvent only for the local participant. When the local participant uses the stopAudio method to locally mute a selected remote participant who does not use a camera, the local participant receives StreamRemovedEvent.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.v2.StreamRemovedEvent.

participant (Participant)

The conference participant.

mediaStream (MediaStream)

The media stream.

StreamUpdatedEvent

Emitted when a conference participant who is connected to the audio and video stream changes the stream by enabling a microphone while using a camera or by enabling a camera while using a microphone. The event is emitted to all conference participants. The following graphic shows this behavior:

The SDK can also emit StreamUpdatedEvent only for the local participant. When the local participant uses the stopAudio or startAudio method to locally mute or unmute a selected remote participant who uses a camera, the local participant receives StreamUpdatedEvent.
This object is generated locally by the SDK.

Available in the package com.voxeet.sdk.events.v2.StreamUpdatedEvent.

participant (Participant)

The conference participant.

mediaStream (MediaStream)

The media stream.