Updated on 2024-09-13 GMT+08:00

Editing a Meeting

Function

This API is used to edit a scheduled meeting. 1. Call this API only after login. 2. Call this API to modify a meeting that has not started. If the meeting has started, a failure message is returned. 3. All parameters are mandatory. Before modifying a meeting, query the meeting details. For the data that does not need to be changed, use the data returned after the meeting details are queried.

Function Prototype

editConf(editConfParam: EditConfParam, onEditConfResult?: (ret: SDKERR, reason: string) => void): voideditConf(editConfParam: EditConfParam, onEditConfResult?: (ret: SDKERR, reason: string) => void): void

Request Parameters

Table 1 Input parameter description
Parameter Mandatory Type Description
editConfParam Yes EditConfParam Parameters for modifying a meeting.
onEditConfResult Yes (ret: SDKERR, reason: string) => void Callback of modifying the meeting.
Table 2 EditConfParam
Parameter Mandatory Type Description
confId Yes string Meeting ID.
startTime Yes number Meeting start time. If the start time is not specified, the meeting starts immediately. The value is accurate to seconds (GMT).
duration Yes number Meeting duration, in minutes.
confCommonParam Yes ConfCommonParam Common meeting parameters.
isSendCalendar No boolean Whether to send calendar notifications.
Table 3 ConfCommonParam
Parameter Mandatory Type Description
subject Yes string Meeting topic.
mediaType No MediaType Meeting type. By default, the meeting is an audio meeting.
needPassword No boolean Whether a guest password is required. By default, the guest password is not required (valid only for meetings with a random ID).
isAutoRecord No boolean Whether to enable automatic meeting recording. By default, this function is disabled. 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.
allowLive No boolean Reserved field. This parameter is transparently transmitted during meeting modification.
timezone Yes Timezone Time zone code. This parameter is used for sending meeting notifications.
vmrId No string Unique cloud meeting room ID. To schedule a meeting using concurrent participants, set this parameter to an empty string. When you modify a meeting, you cannot modify this parameter and need to enter the value returned in meeting details.
confAllowJoinUser No ConfAllowJoinUserType Users who are allowed to join the meeting. By default, everyone is allowed.
isSendSms No boolean Whether to send an SMS notification. To use this function, enable it in the enterprise configuration first. Otherwise, this parameter does not take effect.
isSendEmail No boolean Whether to send an email notification.
vmrConfIdType No VmrConfIdType ID type of the cloud meeting room. When modifying a meeting, set this parameter to HWM_VMR_CONF_ID_TYPE_FIXED if vmrConfId in meeting details is not empty, or set it to HWM_VMR_CONF_ID_TYPE_RANDOM if vmrConfId in meeting details is empty.
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.
numOfAttendee Yes number Number of participants.
attendees Yes AttendeeBaseInfo Participant list.
allowGuestStartConf No boolean Whether to allow guests to start the meeting.
allowGuestStartConfTime No number Time range for a guest to join the meeting in advance, in minutes. 0: at any time; n: n minutes in advance.
concurrentParticipants Yes number Maximum number of participants in the meeting. The value can be 0 (unlimited) or greater than 0 (specific maximum number of participants).
customInfo No string User-defined information.
confResType No ConfResType Meeting resource type.
defaultSummaryState No SummaryState Initial state of whether the cloud recording contains minutes (unavailable for recurring meetings; 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 4 Enumerated values of MediaType
Enumeration Name Enumerated Value Description
HWM_MEDIA_TYPE_AUDIO 0 Audio.
HWM_MEDIA_TYPE_VIDEO 1 Video.
Table 5 Enumerated values of Timezone
Enumeration Name Enumerated Value Description
HWM_TIMEZONE_DEFAULT 0 Default MediaX time zone
HWM_TIMEZONE_INTERDATE_LINE 1 International Date Line West
HWM_TIMEZONE_MIDWAY_ISLAND 2 Midway Island, Samoa
HWM_TIMEZONE_HAWAII 3 Hawaii
HWM_TIMEZONE_ALASKA 4 Alaska
HWM_TIMEZONE_PACIFIC_TIME 5 Pacific Time (US & Canada), Tijuana
HWM_TIMEZONE_ARIZONA 6 Arizona
HWM_TIMEZONE_MOUNTAIN_TIME 7 Mountain Time (US & Canada)
HWM_TIMEZONE_CENTRAL_AMERICA 8 Central America
HWM_TIMEZONE_CENTRAL_TIME 9 Central Time (US & Canada)
HWM_TIMEZONE_MEXICO_CITY 10 Mexico City
HWM_TIMEZONE_SASKATCHEWAN 11 Saskatchewan
HWM_TIMEZONE_BOGOTA 12 Bogota, Lima, Quito
HWM_TIMEZONE_EASTERN_TIME 13 Eastern Time (US & Canada)
HWM_TIMEZONE_INDIANA 14 Indiana (East)
HWM_TIMEZONE_ATLANTIC_TIME 15 Atlantic Time (Canada)
HWM_TIMEZONE_CARACAS 16 Caracas, La Paz
HWM_TIMEZONE_SANTIAGO 17 Santiago
HWM_TIMEZONE_NEWFOUNDLAND 18 Newfoundland
HWM_TIMEZONE_BRASILIA 19 Brasilia
HWM_TIMEZONE_BUENOS_AIRES 20 Buenos Aires, Georgetown
HWM_TIMEZONE_GREENLAND 21 Greenland
HWM_TIMEZONE_MID_ATLANTIC 22 Mid-Atlantic
HWM_TIMEZONE_AZORES 23 Azores
HWM_TIMEZONE_CAPEVERDE 24 Cape Verde Is.
HWM_TIMEZONE_MONROVIA 25 Monrovia
HWM_TIMEZONE_GREENWICH_MEANTIME 26 Greenwich Mean Time: Dublin, Edinburgh, Lisbon, London
HWM_TIMEZONE_AMSTERDAM 27 Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna
HWM_TIMEZONE_BELGRADE 28 Belgrade, Bratislava, Budapest, Ljubljana, Prague
HWM_TIMEZONE_BRUSSELS 29 Brussels, Copenhagen, Madrid, Paris
HWM_TIMEZONE_SARAJEVO 30 Sarajevo, Skopje, Vilnius, Sofia, Warsaw, Zagreb
HWM_TIMEZONE_WESTCENTRAL_AFRICA 31 West Central Africa
HWM_TIMEZONE_ATHENS 32 Athens, Istanbul, Minsk
HWM_TIMEZONE_BUCHAREST 33 Bucharest
HWM_TIMEZONE_CAIRO 34 Cairo
HWM_TIMEZONE_HARARE 35 Harare, Pretoria
HWM_TIMEZONE_HELSINKI 36 Helsinki, Riga, Tallinn
HWM_TIMEZONE_JERUSALEM 37 Jerusalem
HWM_TIMEZONE_BAGHDAD 38 Baghdad
HWM_TIMEZONE_KUWAIT 39 Kuwait, Riyadh
HWM_TIMEZONE_MOSCOW 40 Moscow, St. Petersburg, Kazan, Volgograd
HWM_TIMEZONE_NAIROBI 41 Nairobi
HWM_TIMEZONE_TEHRAN 42 Tehran
HWM_TIMEZONE_ABU_DHABI 43 Abu Dhabi, Muscat
HWM_TIMEZONE_TBILISI 44 Tbilisi, Yerevan
HWM_TIMEZONE_KABUL 45 Kabul
HWM_TIMEZONE_EKATERINBURG 46 Ekaterinburg
HWM_TIMEZONE_ISLAMABAD 47 Islamabad, Karachi, Tashkent
HWM_TIMEZONE_CALCUTTA 48 Kolkata, Chennai, Mumbai, New Delhi
HWM_TIMEZONE_KATHMANDU 49 Kathmandu
HWM_TIMEZONE_ALMATY 50 Almaty
HWM_TIMEZONE_ASTANA 51 Astana, Dhaka
HWM_TIMEZONE_SRIJAYA 52 Sri Jayawardenepura
HWM_TIMEZONE_RANGOON 53 Yangon (Rangoon)
HWM_TIMEZONE_BANGKOK 54 Bangkok, Jakarta, Hanoi
HWM_TIMEZONE_NOVOSIBIRSK 55 Novosibirsk
HWM_TIMEZONE_BEIJING 56 Beijing, Chongqing, Hong Kong, Urumqi, Taipei
HWM_TIMEZONE_KRASNOYARSK 57 Krasnoyarsk, Ulaanbaatar
HWM_TIMEZONE_KUALA_LUMPUR 58 Kuala Lumpur, Singapore
HWM_TIMEZONE_PERTH 59 Perth
HWM_TIMEZONE_OSAKA 60 Tokyo, Osaka, Sapporo
HWM_TIMEZONE_SEOUL 61 Seoul
HWM_TIMEZONE_YAKUTSK 62 Yakutsk
HWM_TIMEZONE_ADELAIDE 63 Adelaide
HWM_TIMEZONE_DARWIN 64 Darwin
HWM_TIMEZONE_BRISBANE 65 Brisbane
HWM_TIMEZONE_CANBERRA 66 Canberra, Melbourne, Sydney
HWM_TIMEZONE_GUAM 67 Guam, Port Moresby
HWM_TIMEZONE_HOBART 68 Hobart
HWM_TIMEZONE_VLADIVOSTOK 69 Vladivostok
HWM_TIMEZONE_SOLOMON 70 Solomon Is., New Caledonia
HWM_TIMEZONE_AUCKLAND 71 Auckland, Wellington
HWM_TIMEZONE_FIJI 72 Fuji, Kamchatka, Marshall Is.
HWM_TIMEZONE_NUKUALOFA 73 Nuku'alofa
HWM_TIMEZONE_IRKUTSK 74 Irkutsk
HWM_TIMEZONE_CASABLANCA 75 Casablanca
HWM_TIMEZONE_BAKU 76 Baku
HWM_TIMEZONE_MAGADAN 77 Magadan
Table 6 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 7 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 8 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 9 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 10 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 11 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 12 Enumerated values of SummaryState
Enumeration Name Enumerated Value Description
SUMMARY_STATE_CLOSE 0 Disabled.
SUMMARY_STATE_OPEN 1 Enabled.
Table 13 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) => void

Table 14 Input parameter description
Parameter Type Description
ret For details about SDKERR, see Error Code Reference. Error code.
reason string Error description.