ConferenceService
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:
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. The application can also start and stop sending the remote participants' audio streams to the local participant.
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 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 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 |
|---|---|---|
| mute | boolean | A boolean, true indicates that the local participant is muted, false indicates that a participant is not muted |
| participant | Participant | A remote participant |
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
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
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.
cancelTimeout
▸ cancelTimeout(): ConferenceService
Cancels the timeout.
Returns: @NonNull ConferenceService
startVideo
▸ startVideo(): Promise<Boolean>
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>
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.
startRemoteVideo
▸ startRemoteVideo(@NonNull participant: Participant): Promise<Boolean>
Informs the server to start sending video streams of a specific participant.
Parameters
| Name | Type | Description |
|---|---|---|
| participant | Participant | non null |
Returns: @NonNull Promise<Boolean>
stopRemoteVideo
▸ stopRemoteVideo(@NonNull participant: Participant): Promise<Boolean>
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>
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>
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>
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>
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(@Nullable conferenceAlias: String): Promise<CreateConferenceResult> [
Creates a conference based on the provided conference alias.
Parameters
| Name | Type | Description |
|---|---|---|
| conferenceAlias | String | nullable alias of the conference |
Returns: @NonNull Promise<CreateConferenceResult> - the promise to resolve.
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 mechanism 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
Provides the maximum number of video streams that may be transmitted to the local participant.
Returns: @Nullable Integer - the max video forwarded value for the current conference
videoForwarding
▸ videoForwarding(max: int, participants: List<Participant>): Promise<Boolean>
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.
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 4. The default value is 4. In the case of providing a value smaller than 0 or greater than 4, SDK triggers the IllegalStateException error. |
| participants | List<Participant> | The list of participants' objects. |
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, forward: SpatialPosition, up: SpatialPosition, 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 frontup= (0, 1, 0), where +Y axis is aboveright= (1, 0, 0), where +X axis is to the rightscale= (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 ,position: SpatialPosition): void
Sets a remote participant's position in space to enable the spatial audio experience during a Dolby Voice conference. If the 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. 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 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). 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.
conference
The conference in which an active speaker changed.
activeParticipants
The list of active speakers.
unknownActiveSpeakers
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.
ConferenceTimeoutNoParticipantsJoinedEvent
Emitted when within the maximum awaiting time nobody has joined the current participant at the conference.
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.
Available in the package com.voxeet.sdk.events.sdk.IncomingCallEvent.
conferenceId (String)
The conference ID.
VideoStateEvent
Emitted when the local video state information has changed.
Available in the package com.voxeet.sdk.events.v2.VideoStateEvent.
mediaState (MediaState)
The new local video state.
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:
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.
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.
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 difference between the streamAdded and streamUpdated events
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.
Available in the package com.voxeet.sdk.events.v2.StreamUpdatedEvent.
participant (Participant)
The conference participant.
mediaStream (MediaStream)
The media stream.
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.
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:
Diagram that presents the possible status changes
Available in the package com.voxeet.sdk.events.v2.ParticipantUpdatedEvent.
participant (Participant)
The conference participant.
QualityIndicators
The Mean Opinion Score (MOS) 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.
Available in the package com.voxeet.sdk.events.sdk.QualityIndicators.
This object can be accessed through the WebSocket usage.
mos (float)
The quality indicator.
ConferenceStatusUpdatedEvent
Emitted when ta conference changes status.
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.
Available in the package com.voxeet.sdk.events.sdk.PermissionsUpdatedEvent.
PermissionsUpdatedEvent
▸ PermissionsUpdatedEvent(@NonNull permissions: Set<ConferencePermission>)
Emitted when the local participant's permissions are updated.
Parameters
| Name | Type | Description |
|---|---|---|
| permissions | Set<ConferencePermission> | non null |
permissions (Set)
The updated conference permissions.
Updated 3 months ago