Use these properties to initialize the meeting with your preferred settings and UI. Use events and methods for further customizations while the conference is in progress or when it ends.
ClanMeeting Constructor #
domain
and consumerId
are mandatory arguments and need to be passed in the respective order.
new ClanMeeting(domain, consumerId, [optionalProperties])
Example Usage #
Use the ClanMeeting
constructor to set different meeting properties as follows.
Initialize a meeting with optionalProperties
for more control.
xxxxxxxxxx
121const optionalProperties = {
2 roomName: 'unique-room-name',
3 displayName: 'John Doe',
4 jwt: 'token-for-host',
5 elementId: 'my-meeting',
6};
7const domain = 'clanmeeting-domain';
8const consumerId = 'clanmeeting-consumer-id';
9const meeting = new ClanMeeting(domain, consumerId, optionalProperties);
10
11window.onload = function() { meeting.start(); }
12window.onunload = function() { meeting.end(); }
All Meeting Properties #
domain #
Clan Meeting domain name (first mandatory argument)
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | true |
consumerId #
Clan Meeting consumer ID (second mandatory argument)
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | true |
roomName #
Unique meeting room name (lowercase alphabets, digits, dashes and underscores only).
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | true |
displayName #
Display Name of the meeting user as visible to other users. Display names are also captured as a part of attendance.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | true |
jwt #
Required only by the host to join/start a meeting. Participants do not need to pass a JWT.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | true | true (for host) |
audioLevelsInterval #
How frequently is audio level updated.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Number | 500 | false | false |
autofillPassword #
Setting this to the meeting password enables a participant to bypass the password prompt programmatically without revealing the password.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | false |
avatarUrl #
Set avatar image URL for the meeting users. Use compressed images.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | false |
disabledSounds #
Disable the following sounds.
'ASKED_TO_UNMUTE_SOUND', 'INCOMING_MSG_SOUND', 'KNOCKING_PARTICIPANT_SOUND', 'LIVE_STREAMING_OFF_SOUND', 'LIVE_STREAMING_ON_SOUND', 'NO_AUDIO_SIGNAL_SOUND', 'NOISY_AUDIO_INPUT_SOUND', 'OUTGOING_CALL_EXPIRED_SOUND', 'OUTGOING_CALL_REJECTED_SOUND', 'OUTGOING_CALL_RINGING_SOUND', 'OUTGOING_CALL_START_SOUND', 'PARTICIPANT_JOINED_SOUND', 'PARTICIPANT_LEFT_SOUND', 'RAISE_HAND_SOUND', 'REACTION_SOUND', 'RECORDING_OFF_SOUND', 'RECORDING_ON_SOUND', 'TALK_WHILE_MUTED_SOUND'
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Array | [] | false | false |
enable1On1Mode #
Hide remote thumbnails when in a 1-on-1 conference call.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableWebinarMode #
Enables the webinar mode in Clan Meeting. If you need webinar mode, this property needs to be set for both the host and the participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableAddingBackgroundImages #
Allow participants to add their own virtual background images.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableAudioLevels #
Show audio levels when participants speak.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableAutoKnockLobby #
Automatically knock when lobby is enabled. If set to false, participant has to click on the lobby button to request access to the meeting room.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableChatSmileys #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableClanMeetingApps #
Shows Clan Meeting app download page for mobile users. Disabling this opens the meetings directly on mobile browser.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableConferenceTimer #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableConnectionIndicators #
Display connection indicators on participant thumbnails that show the connection status.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableConnectionIndicatorsAutoHide #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
connectionIndicatorsAutoHideTimeout #
Autohide connection indicators above participant thumbnails after these many milliseconds.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Number | 5000 | false | false |
enableConnectionIndicatorsDetails #
Show connection details when connection indicators are hovered upon.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableConnectionIndicatorsInactive #
Enable connection indicator for inactive participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableDisplayName #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableEmailInSettings #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
elementId #
Meeting DOM element.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | my-meeting | false | false |
enableFollowMe #
Everyone follows what the host does on his screen.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | true | false |
enableGrantModerator #
Allow host to grant moderator access to a participant by hovering on the three dots over participant thumbnail.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | true | false |
enableInsecureRoomNameWarning #
Shows a warning if you are using insecure room names.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableInviteFunctions #
Allow to invite others into the meeting.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableJoinMeetingPage #
Shows a join meeting page where the participants can test their mic and camera.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableJoinMeetingPageDisplayName #
Enable editing of display name on the join meeting page.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableKickParticipant #
Kick unwanted participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | true | false |
enableLobbyButton #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableLobbyChat #
Allow chatting between the people waiting in the lobby and the host.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableLocalVideoFlip #
Flip the local video.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableLowBandwidthMode #
Local participant will not see any video to save bandwidth even if the remote participants have their videos turned on. Meeting will continue as usual for others.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableMandatoryDisplayName #
Make display names mandatory.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableMobileView #
Optimizations for responsiveness.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableModeratorIndicator #
Indicated by a "Star" symbol.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableMuteParticipant #
Allow muting other participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | true | false |
enableNoAudioDetection #
Shows a notification if someone is trying to speak while on mute.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableNoisyMicDetection #
Shows a notification if a participant's background is noisy.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableParticipantsPaneModeratorSettings #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableParticipantsPaneMoreActionsButton #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableParticipantsPaneMuteAllButton #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enablePolls #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enablePrivateChat #
Allows private chatting amongst participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableProfile #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableReactions #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableReactionsModeration #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableReadOnlyName #
Makes the display names read only. Useful if you do not want to allow participants to edit their names and you want to enforce names set by the API displayName property.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableRecordingLabel #
Shows a recording icon when recording is on.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableRemoteVideoMenu #
Shows three dot icon on participant thumbnails.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableRemoveRaisedHandOnFocus #
Removes raised hand automatically when the raised hand participant speaks.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableResponsiveTiles #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableScreensharingVirtualBackground #
Enables shared screen as virtual background.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableSelfView #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableSelfViewSettings #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableShortcuts #
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableSilentMode #
Disable any sounds coming from another participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
enableSpeakerStatsSearch #
Allows participant search bar on the speaker stats dialog.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableStereoAudioQuality #
Enables HD audio quality. Remember that enabling this disables other audio optimizations like noise cancellation. Used with audioQualityMaxBitRate.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
audioQualityMaxBitRate #
enableStereoAudioQuality should be set to true for this. Ranges between 6000 and 51000.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Number | 6000 | false | false |
enableTileEnlargement #
In tileview.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableTileView #
Enables tile (grid) view for the participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
enableWhiteboardOnJoin #
Turns on whiteboard by default.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | false | false | false |
initialZoom #
Initial zoom level in smaller devices.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Number | 1.0 | false | false |
joinMeetingPageButtons #
Show these buttons on the Join Meeting page.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Array | ['microphone', 'camera', 'select-background', 'invite', 'settings'] | false | false |
lang #
Language.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | en | false | false |
localSubject #
Subject shown beside the timer for the local participant.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | false |
maxZoom #
Set maximum zoom level on smaller devices. Useful to zoom in to shared screen on mobile devices.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Number | 1.0 | false | false |
muteAudioOnJoin #
Initial mic status when local participant joins a meeting.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
muteVideoOnJoin #
Initial camera status when local participant joins a meeting.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Boolean | true | false | false |
noticeMessage #
Displays a notice at the top. Used for showing an important message to the participants.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | false | false |
overriddenToolbarButtons #
Override the default behavior of the above toolbarButtons with your custom logic when one of these buttons is clicked. Used often in conjunction with overriddenToolbarButtonClicked event.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Array | [] | false | false |
password #
Sets the meeting password to this and locks meeting automatically as soon as the host joins. Needs host privilege. Setting this for non-hosts (participants) will have no effect.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | true | false |
subject #
Subject as shown to all participants beside the timer.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
String | empty | true | false |
tileViewNumberOfVisibleTiles #
Number of participants visible in the tile view.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Number | 25 | false | false |
toolbarButtons #
Show these toolbar buttons (desktop = screen sharing and etherpad = notepad).
Note that notepad (etherpad) is a private notepad and whiteboard is a collaborative notepad visible and editable by all participants. One can share the private notepad using screen sharing if they do not want to allow edits to their board.
type | default | needsHostPrivilege | isRequired |
---|---|---|---|
Array | ['camera', 'chat', 'desktop', 'embedmeeting', 'etherpad', 'filmstrip', 'fullscreen', 'hangup', 'help', 'highlight', 'invite', 'livestreaming', 'microphone', 'noisesuppression', 'participants-pane', 'raisehand', 'recording', 'security', 'select-background', 'settings', 'shareaudio', 'sharedvideo', 'shortcuts', 'stats', 'tileview', 'toggle-camera', 'videoquality', 'whiteboard'] | false | false |