Modifying a Meeting

Function

This API is used to modify 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	Y	EditConfParam	Parameters for modifying a meeting.
onEditConfResult	Y	(ret: SDKERR, reason: string) => void	Callback of modifying the meeting.

**Table 2** EditConfParam
Parameter	Mandatory	Type	Description
confId	Y	string	Meeting ID.
startTime	Y	number	Meeting start time. If the start time is not specified, the meeting starts immediately. The value is accurate to seconds (GMT).
duration	Y	number	Meeting duration, in minutes.
confCommonParam	Y	ConfCommonParam	Common meeting parameters.
isSendCalendar	N	boolean	Whether to send calendar notifications.

**Table 3** ConfCommonParam
Parameter	Mandatory	Type	Description
subject	Y	string	Meeting topic.
mediaType	N	MediaType	Meeting type. By default, the meeting is an audio meeting.
needPassword	N	boolean	Whether a guest password is required. By default, the guest password is not required (valid only for meetings with a random ID).
isAutoRecord	N	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	N	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	N	boolean	Reserved field. This parameter is transparently transmitted during meeting modification.
timezone	Y	Timezone	Time zone code. This parameter is used for sending meeting notifications.
vmrId	N	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	N	ConfAllowJoinUserType	Users who are allowed to join the meeting. By default, everyone is allowed.
isSendSms	N	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	N	boolean	Whether to send an email notification.
vmrConfIdType	N	VmrConfIdType	ID type of the cloud meeting room. When modifying a meeting, set this parameter to HWM_cloud meeting room_CONF_ID_TYPE_FIXED if vmrConfId in meeting details is not empty, or set it to HWM_cloud meeting room_CONF_ID_TYPE_RANDOM if vmrConfId in meeting details is empty.
guestPwd	N	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	N	boolean	Waiting room status. This parameter takes effect only when the waiting room function is enabled.
numOfAttendee	Y	number	Number of participants.
attendees	Y	AttendeeBaseInfo	Participant list.
allowGuestStartConf	N	boolean	Whether to allow guests to start the meeting.
allowGuestStartConfTime	N	number	Time range for a guest to join the meeting in advance, in minutes. 0: at any time; n: n minutes in advance.

**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	Nur-Sultan, 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	Y	string	Participant name.
number	Y	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	Y	string	Third-party user ID. This parameter is used for app ID authentication. Either this parameter or number must be set.
accountId	N	string	Huawei Cloud Meeting account.
email	N	string	Email address used for receiving email notifications.
sms	N	string	Mobile number used for receiving SMS notifications.
isAutoInvite	N	boolean	Whether to automatically invite participants.
isMute	N	boolean	Whether to mute the microphone.
role	N	ConfRole	Participant role in the meeting.
type	N	AttendeeType	Participant type.

**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).