Help Center/ Meeting/ Client SDK Reference/ Electron SDK/ APIs/ Meeting Control Objects/ Creating a Meeting
Updated on 2024-09-13 GMT+08:00
View PDF

Creating a Meeting

Function

This API is used to create an instant meeting. 1. By default, calling this API will add you to the meeting as the host. You do not need to pass your own information in the participant parameters. 2. If other participants need to be invited when a meeting is created, the information about other participants needs to be passed. If other participants are not required to join the meeting, participant details and the number of participants can be empty.

Function Prototype

createConf(createConfInfo: CreateConfInfo, onCreateConfResult?: (ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void): voidcreateConf(createConfInfo: CreateConfInfo, onCreateConfResult?: (ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void): void

Request Parameters

Table 1 Input parameter description
Parameter Mandatory Type Description
createConfInfo Yes CreateConfInfo Meeting creation information.
onCreateConfResult Yes (ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void Callback of creating the meeting.
Table 2 CreateConfInfo
Parameter Mandatory Type Description
subject Yes string Meeting topic.
mediaType Yes MediaType Meeting type.
needPassword Yes boolean Whether a guest password is required. This parameter is valid only for meetings with a random ID.
isAutoRecord No boolean Whether automatic meeting recording is enabled. If automatic meeting recording is enabled, the meeting will be recorded by default, regardless of whether recording is enabled or disabled in the meeting. This parameter is valid only for cloud recording, not for local recording on clients.
allowRecord No boolean Whether meeting recording is supported. (This parameter is valid only for the Windows platform.) This parameter is valid only for cloud recording, not for local recording on clients.
confAllowJoinUser No ConfAllowJoinUserType Users who are allowed to join the meeting. By default, everyone is allowed.
vmrId No string Unique cloud meeting room ID. To schedule a meeting with a random meeting ID, set this parameter to an empty string.
vmrConfIdType No VmrConfIdType ID type of the cloud meeting room.
guestPwd No string Guest password. If this parameter is left empty, the server randomly generates a password. This parameter is valid only for meetings with a random ID.
isOpenWaitingRoom No boolean Waiting room status. This parameter takes effect only when the waiting room function is enabled.
duration No number Meeting duration, in minutes. The value ranges from 15 to 1,440. If this parameter is left blank, the server uses the default meeting duration.
isMicOn No boolean Whether to enable the microphone. The options are true (yes) and false (no).
isCameraOn No boolean Whether to enable the camera. The options are true (yes) and false (no).
concurrentParticipants No number Maximum number of participants in the meeting. The value can be 0 (unlimited) or greater than 0 (specific maximum number of participants).
numOfAttendee Yes number Number of participants. If participants are not required, set this parameter to 0.
attendees Yes AttendeeBaseInfo Participant details. If participants are not required, leave this parameter empty.
customInfo No string User-defined information.
confResType No ConfResType Meeting resource type.
defaultSummaryState No SummaryState Initial state of whether the cloud recording contains minutes (valid only for the Windows platform).
autoMuteMode No AutoMuteType Whether soft client guests are automatically muted when they join the meeting.
hardTerminalAutoMuteMode No AutoMuteType Whether hard terminal guests are automatically muted when they join the meeting.
Table 3 Enumerated values of MediaType
Enumeration Name Enumerated Value Description
HWM_MEDIA_TYPE_AUDIO 0 Audio.
HWM_MEDIA_TYPE_VIDEO 1 Video.
Table 4 Enumerated values of ConfAllowJoinUserType
Enumeration Name Enumerated Value Description
CONF_ALLOW_JOIN_ANYONE 0 Everyone.
CONF_ALLOW_JOIN_LOGINED_USER 1 Logged-in users.
CONF_ALLOW_JOIN_IN_COMPANY_USER 2 Corporate users only.
CONF_ALLOW_JOIN_INVITED_USER 3 Invited users only.
Table 5 Enumerated values of VmrConfIdType
Enumeration Name Enumerated Value Description
HWM_VMR_CONF_ID_TYPE_FIXED 0 Fixed ID of the cloud meeting room.
HWM_VMR_CONF_ID_TYPE_RANDOM 1 Random ID of the cloud meeting room.
Table 6 AttendeeBaseInfo
Parameter Mandatory Type Description
nickName Yes string Participant name.
number Yes string Number. If this parameter is set to the SIP number (for example, +99111244216210249) allocated to the account, the Huawei Cloud Meeting app is called. If this parameter is set to a PSTN number (for example, 18700000000), the number is called through the VoIP gateway if the enterprise has enabled PSTN call. This parameter is used for account and password authentication. Either this parameter or thirdUserId must be set.
thirdUserId Yes string Third-party user ID. This parameter is used for app ID authentication. Either this parameter or number must be set.
accountId No string Huawei Cloud Meeting account.
email No string Email address used for receiving email notifications.
sms No string Mobile number used for receiving SMS notifications.
isAutoInvite No boolean Whether to automatically invite participants.
isMute No boolean Whether to mute the microphone.
role No ConfRole Participant role in the meeting.
type No AttendeeType Participant type.
userUuid No string Participant UUID.
Table 7 Enumerated values of ConfRole
Enumeration Name Enumerated Value Description
HWM_CONF_ROLE_ATTENDEE 0 Common participant.
HWM_CONF_ROLE_HOST 1 Host.
HWM_CONF_ROLE_AUDIENCE 2 Attendee.
HWM_CONF_ROLE_COHOST 3 Co-host.
HWM_CONF_ROLE_WAITING 4 Waiting room member.
Table 8 Enumerated values of AttendeeType
Enumeration Name Enumerated Value Description
ATTENDEE_TYPE_NORMAL 0 Voice, HD, and SD participant addresses.
ATTENDEE_TYPE_TELEPRESENCE 1 Address of a telepresence participant (uni-screen or tri-screen telepresence participant).
ATTENDEE_TYPE_TERMINAL 2 Meeting room or hard terminal.
ATTENDEE_TYPE_OUTSIDE 3 External participant.
ATTENDEE_TYPE_CUSTOMNUMBER 4 Custom number.
ATTENDEE_TYPE_MOBILE 5 Soft client user's mobile phone.
ATTENDEE_TYPE_ANONYMOUS 6 Anonymous user.
ATTENDEE_TYPE_TELEPHONE 7 Phone user.
ATTENDEE_TYPE_BOARD 8 Whiteboard user.
ATTENDEE_TYPE_IDEAHUB 9 Large-screen device with HiSilicon chips.
ATTENDEE_TYPE_HWVISION 10 Smart TV.
ATTENDEE_TYPE_WELINKC 11 WeLink (public edition).
Table 9 Enumerated values of ConfResType
Enumeration Name Enumerated Value Description
HWM_CONF_RESTYPE_DEFAULT 0 Default.
HWM_CONF_RESTYPE_SHARE_VMR 3 Shared cloud meeting room.
Table 10 Enumerated values of SummaryState
Enumeration Name Enumerated Value Description
SUMMARY_STATE_CLOSE 0 Disabled.
SUMMARY_STATE_OPEN 1 Enabled.
Table 11 Enumerated values of AutoMuteType
Enumeration Name Enumerated Value Description
AUTO_MUTE_TYPE_DEFAULT 0 Default.
AUTO_MUTE_TYPE_MUTE 1 Muted.
AUTO_MUTE_TYPE_UNMUTE 2 Unmuted.

Return Values

void

Callback Method Parameters

(ret: SDKERR, reason: string, createConfResult: CreateConfResult) => void

Table 12 Input parameter description
Parameter Type Description
ret For details about SDKERR, see Error Code Reference. Error code.
reason string Error description.
createConfResult CreateConfResult Meeting creation result.
Table 13 CreateConfResult
Parameter Type Description
confId string Meeting ID.
vmrConfId string Cloud meeting room ID (valid only for the macOS platform).
hostPwd string Host password.
guestPwd string Guest password.
mediaType MediaType Meeting media type (valid only for the macOS platform).
guestJoinUri string Guest link.
selfConfRole ConfRole Role in the meeting.
subject string Meeting topic.
startTime number Meeting start time, accurate to seconds (GMT).
endTime number Meeting end time.
schedulerName string Name of the user who schedules the meeting.
customInfo string Custom extension information.
Parent topic: Meeting Control Objects