ConnectHTMLSDK Class
This class has all the methods, events and Properties which are exposed by the Connect HTML SDK
Item Index
Methods
- allowParticipantPublish
- dispatchSyncMessage
- getBreakoutRoomDetails
- getBreakoutRoomsList
- getConfig
- getMeetingInfo
- getMyBreakoutRoomDetails
- getMyUserDetails
- getPodInfo
- getUserDetails
- getUserList
- isBreakOutSessionOn
- isWhiteBoardOn
- maximize
- podVisible
- setMenuBarControlsVisibility
- setMyStatus
- setPodControlsVisibility
Properties
- AGREE
- AGREE_DISAGREE_CLEAR
- APPLAUSE
- archiveDuration
- BUILD_NO
- CLEAR_STATUS
- connectVersion
- DATE
- DISAGREE
- isSynced
- k_HOST
- k_PARTICIPANT
- k_PRESENTER
- language
- LAUGHTER
- LOWER_HAND
- playState
- podHeight
- podID
- podMinHeight
- podMinWidth
- podWidth
- RAISE_HAND
- SLOW_DOWN
- SPEAK_LOUDER
- SPEAK_SOFTER
- SPEED_UP
- STEP_AWAY
- STEP_IN
- VERSION
Methods
allowParticipantPublish
-
msgName
-
allowFlag
[Host Only] This method will allow/block the participants from sending a sync event
Parameters:
-
msgName
Stringname of the message for which the permission will be set
-
allowFlag
Booleanif true then participants will be allowed
Returns:
Example:
customPodObject.allowParticipantPublish("name", true)
dispatchSyncMessage
-
msgName
-
msgValue
-
isDelta
-
echoBack
Method to send a sync message to other participants
Parameters:
-
msgName
Stringname of the message to be sent -- should be meaningful to the pod running on other participant's machines
-
msgValue
Objectthe contents of the message to be sent, the format to be determined by your own custom pod
-
isDelta
Booleanif true, then all of the events matching this message name will be sent to new particpants. If false, then only the last known event will be sent.
-
echoBack
Booleanif true, then this instance of the custom pod will receive a corresponding sync message back, otherwise only the other participants will receive this message.
Example:
customPodObject.dispatchSyncMessage("name", ["Himanshu"], true, true)
getBreakoutRoomDetails
-
breakoutId
[Host Only Function] This method will return an object with information about a breakout room
Parameters:
-
breakoutId
Number
Returns:
Object that has two values breakoutRoom id and breakout room name, returns null if participant calls this function
Example:
let borObj = customPodObject.getBreakoutRoomDetails(1)
let name = borObj.name
let id = borObj.id
getBreakoutRoomsList
()
Array
[Host Only Function] This method will return the list of breakout rooms
Returns:
array that contains the list of breakout rooms object that contains room id and name, returns null if participant calls this function
Example:
let borList = customPodObject.getBreakoutRoomsList()
let room1Name = borList[0].name
let room1Id = borList[0].id
getConfig
()
Object
This method returns configuration of the meeting like accountId, isAddin, isWhiteBoardOn
Returns:
configuration
Example:
let data = customPodObject.getConfig();
data.accountId
data.archiveDuration
data.isAddin
data.isArchive
data.isBreakOutSession
data.isCaughtUp
data.isPointerOn
data.isSecure
data.isWhiteBoardOn
data.language
data.playState
data.podTitle
data.role
data.roomSCOID
data.url
data.userID
data.userName
getMeetingInfo
()
Object
This method will return a meeting info object
Returns:
object that has accountId, scoId, lang, url
Example:
let data = customPodObject.getMeetingInfo()
data.accountId
data.lang
data.url
getMyBreakoutRoomDetails
()
Object
This method will return the Object that contains the details of the bor in which calling user is currently in
Returns:
name, id
Example:
let myBorObj = customPodObject.getMyBreakoutRoomDetails()
let borId = myBorObj.id
let borName = myBorObj.name
getMyUserDetails
()
Object
This method will return a user data object for the current user
Returns:
object that has two properties message and data
Example:
let myUserData = customPodObject.getMyUserDetails()
myUserData.message // "Success" for live meeting and "Access Denied" for recording
myUserData.data.name
myUserData.data.fullName
myUserData.data.role
myUserData.data.id
myUserData.data.status // this will be an array containing all the status set by this user
getPodInfo
()
Object
This method will return a pod info object
Returns:
object that has podTitle, isWhiteBoardOn
Example:
let data = customPodObject.getPodInfo()
data.isWhiteBoardOn
data.podTitle
getUserDetails
-
userID
[Host Only Function]This method will return a user data object, assuming that the user is a host and that a valid UserID is provided
Parameters:
-
userID
StringID of the user
Returns:
object with user details, return null if participant call this function
Example:
let userData = customPodObject.getUserDetails(userId)
userData.message //"Success" for livemeeting and "Access Denied" for recording
userData.data.breakoutId
userData.data.breakoutRoomName
userData.data.fullName
userData.data.name
userData.data.role
getUserList
()
Object
This method will the object that has userIds of all the users in the meeting
Returns:
object that has two properties message and data
Example:
let userListData = customPodObject.getUserList()
userListData.message // "Success" for live meeting and "Access Denied" for recording
userListData.data //Array containing userIds of the user present in meeting
isBreakOutSessionOn
()
Boolean
This method will return a boolean that denote whether BreakoutRoom is started or not
Returns:
flag that denotes whether breakoutSession is started or not
Example:
let flag = customPodObject.isBreakOutSessionOn()
isWhiteBoardOn
()
Boolean
This method will return a boolean that denote whether BreakoutRoom is started or not
Returns:
flag that denotes whether whiteboard is started or not
Example:
let flag = customPodObject.isWhiteBoardOn
maximize
-
show
[Host Only] This method will switch Custom Pod b/w maximize and minimize state
Parameters:
-
show
Boolean
Returns:
Example:
customPodObject.maximize(true) // this will maximize the pod but only if function called from host side
customPodObject.maximize(false) // this will restore the pod but only if function called from host side
podVisible
-
showFlag
This method will show/hide the sharePod in which custom pod is loaded
Parameters:
-
showFlag
Boolean
Returns:
Example:
customPodObject.podVisible = true // to show the pod
customPodObject.podVisible = false // to hide the pod
setMenuBarControlsVisibility
-
showFlag
This method will show/hide the app bar items
Parameters:
-
showFlag
Boolean
Returns:
Example:
customPodObject.setMenuBarControlsVisibility(true) // to show the app bar items
customPodObject.setMenuBarControlsVisibility(false) // to hide the app bar items
setMyStatus
-
status
Allows user to set his own status.
Accepted Status Values are :
speechQuestion
: Raise HandspeechQuestionLower
: Lower Raised HandspeechAgree
: AgreespeechDisagree
: DisagreespeechAgreeClear
: Clear Agree or DisagreesteppedAway
: Step AwaystepIn
: Step InspeechLouder
: Speak LouderspeechQuieter
: Speak SofterspeechFaster
: Speed UpspeechSlower
: Slow DownspeechLaughter
: LaughterspeechApplause
: ApplauseclearStatus
: Clear Status
Parameters:
-
status
StringstatusValue
Returns:
Example:
setMyStatus("speechQuestion")
setPodControlsVisibility
-
showFlag
This method will show/hide the pod menu Items
Parameters:
-
showFlag
Boolean
Returns:
Example:
customPodObject.setPodControlsVisibility(true) // to show the pod options
customPodObject.setPodControlsVisibility(false) // to hide the pod options
Properties
AGREE
String
A String value that is used to set the "Agree" user status
AGREE_DISAGREE_CLEAR
String
A String value that is used to clear the Agree or disagree status
Example:
sdkobject.setMyStatus(sdkObject.AGREE_DISAGREE_CLEAR)
APPLAUSE
String
A String value that is used to set the "Applause" status in connect
archiveDuration
Number
This specifies the duration of the recording
BUILD_NO
String
This String defaults to "2.0"
CLEAR_STATUS
String
User status value used as an argument of setMyStatus function This String that is used to clear the status"
connectVersion
Number
A boolean that tells which version of connect you are using
DATE
String
This String value that will give today's date
DISAGREE
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Disagree" status
isSynced
Number
A boolean that tells whether share pod is Synced or not
k_HOST
String
A String value that denotes the host role in connect application
k_PARTICIPANT
String
A String value that denotes the participant role in connect application
k_PRESENTER
String
A String value that denotes the presenter role in connect application
language
String
A String value that denotes the language set in connect application
LAUGHTER
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Laughter" status
LOWER_HAND
String
User status value used as an argument of setMyStatus function A String value that is used to clear "Raise Hand" status
playState
String
A String that specifies the playState of the recording
podHeight
Number
A number that specifies the height of the pod containing the application.
podID
Number
A number that specifies the podId in which custom pod is loaded.
podMinHeight
Number
A number that specifies the minimum height of the pod containing the application.
podMinWidth
Number
A number that specifies the minimum width of the pod containing the application.
podWidth
Number
A number that specifies the width of the pod containing the application.
RAISE_HAND
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Raise Hand" status
SLOW_DOWN
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Slow Down" status
SPEAK_LOUDER
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Speak Louder" status
SPEAK_SOFTER
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Speak Softer" status
SPEED_UP
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Speed Up" status
STEP_AWAY
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Step Away" status
STEP_IN
String
User status value used as an argument of setMyStatus function A String value that is used to set the "Step In" status
VERSION
String
This String value that dafaults to 2.0"
Events
caughtUp
Event that indicates that the caughtUp phase is complete, but also is an indication that it is now safe to send messages more freely to the Connect application.
Event Payload:
-
UNKNOWN
Void
Example:
customPodObject.registerCallback("caughtUp",() => ( this.caughtUp() ));
this.caughtUp(){
console.log("Here my event got caught I will put my logic here");
}
playStateChanged
[RECORDING]: When playStateChanged from play to pause or vice versa
Event Payload:
-
event
Objectthis object has playState property
Example:
customPodObject.registerCallback("playStateChanged",(evt) => ( this.playStateChanged(evt) ));
this.roleChanged(evt){
evt.playState
evt.type // 'playStateChanged'
}
podClosed
When pod is hidden / closed
Event Payload:
-
event
Objectthis object only contains event type
Example:
customPodObject.registerCallback("podClosed",(evt) => ( this.podClosed(evt) ));
this.podClosed(evt){
evt.type // 'sizeChanged'
}
podTitleChanged
When title of pod in which custom pod is shared is changed
Event Payload:
-
event
Objectthis object has podTitle as property that gives the new title
Example:
customPodObject.registerCallback("podTitleChanged",(evt) => ( this.podTitleChanged(evt) ));
this.podTitleChanged(evt){
evt.podTitle
evt.type // 'podTitleChanged'
}
pointerToggle
When state of pointer is toggled
Event Payload:
-
event
Objectthis object has isPointerOn property
Example:
customPodObject.registerCallback("pointerToggle",(evt) => ( this.pointerToggle(evt) ));
this.pointerToggle(evt){
evt.isPointerOn
evt.type // 'pointerToggle'
}
roleChanged
When role of a user is changed
Event Payload:
-
event
Objectthis object has type, newRole and userId as property
Example:
customPodObject.registerCallback("roleChanged",(evt) => ( this.roleChanged(evt) ));
this.roleChanged(evt){
evt.newRole
evt.type // 'roleChanged'
evt.userId
}
sizeChanged
When pod Size is Changed
Event Payload:
-
event
Objectthis object has updated width and height as property
Example:
customPodObject.registerCallback("sizeChanged",(evt) => ( this.sizeChanged(evt) ));
this.sizeChanged(evt){
evt.width
evt.height
evt.type // 'sizeChanged'
}
syncMessageReceived
when sync messages are received
Event Payload:
-
event
Objectthis object has msgNm and msgVal
Example:
customPodObject.registerCallback("syncMessageReceived",(evt) => ( this.syncMessageReceived(evt) ));
this.syncMessageReceived(evt){
evt.isDelta
evt.msgNm
evt.msgVal
evt.type // 'syncMessageReceived'
evt.uID // userId of the user sending the sync message
}
syncModeChanged
When Sync Mode of share pod is changed
Event Payload:
-
event
Objectthis object has two properties didISync and isSynced
Example:
customPodObject.registerCallback("syncModeChanged",(evt) => ( this.syncModeChanged(evt) ));
this.syncModeChanged(evt){
evt.didISync
evt.isSynced
evt.type // 'syncModeChanged'
}
userDetailsChanged
When user details get changed such as name of the user is changed
Event Payload:
-
event
Objectthis object has type property that denotes the type of the event, fullName and userId of the user
Example:
customPodObject.registerCallback("userDetailsChanged",(evt) => ( this.userDetailsChanged(evt) ));
this.userDetailsChanged(evt){
evt.fullName
evt.name
evt.type // 'userDetailsChanged'
evt.userId
}
userJoined
Event fired when user enters the meeting
Event Payload:
-
event
Objectthis object has user property that holds details of the user joined and type property that shows type of event
Example:
customPodObject.registerCallback("userJoined",(evt) => ( this.userJoined(evt) ));
this.userJoined(evt){
evt.type // 'userJoined'
evt.user.breakoutId
evt.user.breakoutRoomName
evt.user.fullName
evt.user.id
evt.user.name
evt.user.role
}
userLeft
when user joins the meeting
Event Payload:
-
event
Objectthis object has type property and userId property
Example:
customPodObject.registerCallback("userLeft",(evt) => ( this.userLeft(evt) ));
this.userLeft(evt){
evt.type // "userLeft"
evt.userID
}
userStatusChanged
when user status gets changed
Event Payload:
-
event
Objectthis object has userId and status as its property
Example:
customPodObject.registerCallback("userStatusChanged",(evt) => ( this.userStatusChanged(evt) ));
this.userStatusChanged(evt){
evt.type // 'userStatusChanged'
evt.status // Array containing all the status of this user
evt.userId
}
whiteBoardToggle
When state of whiteboard is toggled
Event Payload:
-
event
Objectthis object has isWhiteBoardOn property
Example:
customPodObject.registerCallback("whiteBoardToggle",(evt) => ( this.whiteBoardToggle(evt) ));
this.whiteBoardToggle(evt){
evt.isWhiteBoardOn
evt.type // 'whiteBoardToggle'
}