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

Scheduling a Recurring Meeting Series

API Description

This API is used to schedule a recurring meeting series.

Precautions

  • This API can be called only when you have logged in to Huawei Cloud Meeting.
  • The meeting start time must be later than the current time, and the meeting duration must be longer than 15 minutes.
  • The vmrId parameter must be passed for a personal meeting or cloud meeting room.
  • The attendees parameter must be passed if participant information needs to be carried.
  • The maximum time span of a recurring meeting series is one year. The number of recurring meetings in a series cannot exceed 50. Otherwise, only the first 50 meetings are scheduled.
  • The result parameter in the callback returns the meeting details. For details, see Table 3.

API Class

NativeSDK
Method Definition
1
2
3
4
5
6
    /**
     * Schedules a recurring meeting series.
     * @param bookCycleConfParam Indicates parameters for scheduling a recurring meeting series.
     * @param callback Indicates the result callback.
     */
   void bookCycleConf(BookCycleConfParam bookCycleConfParam, HwmCallback<ConfInfo> hwmCallback);

Parameter Description

Table 1 Parameter description

Parameter

Mandatory

Type

Description

bookCycleConfParam

Yes

BookCycleConfParam

Parameter body for scheduling a recurring meeting series.

callback

Yes

HwmCallback<ConfInfo> hwmCallback

Result callback for creating the recurring meeting series.

Table 2 BookCycleConfParam description

Parameter

Mandatory

Type

Description

bookConfParam

Yes

BookConfParam

Parameters for scheduling the recurring meeting series.

cycleConfParam

Yes

CycleConfParam

Recurring meeting parameters.

Table 3 CycleConfParam description

Parameter

Mandatory

Type

Description

startDate

Yes

long

Start date and timestamp, accurate to seconds (GMT).

endDate

Yes

long

End date and timestamp, accurate to seconds (GMT).

cycleType

Yes

CycleType

Period type.

interval

Yes

int

Interval of recurring meetings.

1. If cycleType is set to daily, there is a meeting every several days. The value range is [1,15].

2. If cycleType is set to weekly, there is a meeting every several weeks. The value range is [1,5].

3. If cycleType is set to monthly, there is a meeting every several months. The value range is [1,3].

listPoints

Yes

String

Point for holding recurring meetings. This parameter is valid only when meetings are held weekly or monthly. Values are separated by colons (,), for example, 1,3,5.

- Weekly: The value range is [0,6]. 0 indicates Sunday, 1 indicates Monday, and so on.

- Monthly: The value range is [1,31]. If the specified maximum value exceeds the number of days in a given month, the system will interpret it as referring to the last day of that month.

preRemindDays

Yes

int

Number of days in advance users are notified of a recurring meeting.

Sample Code

CycleConfParam cycleConfParam = new CycleConfParam();
cycleConfParam.setCycleType(mSelectedCycleType);
cycleConfParam.setInterval(interval);
cycleConfParam.setListPoints(subDates);
cycleConfParam.setStartDate(startTimeStamp);
cycleConfParam.setEndDate(endTime.getTimeInMillis() / 1000);
cycleConfParam.setPreRemindDays(preMindDays);

BookConfParam bookConfParam = new BookConfParam()
		.setConfSubject(getSubject())
		.setStartTime(1599574798)
		.setTimeZone(56)
		.setDuration(60)
		.setConfType(MeetingType.CONF_VIDEO)
		.setVmrIdFlag(false)
		.setVmrId("")
		.setNeedConfPwd(true)
		.setJoinConfRestrictionType(JoinConfPermissionType.PERMIT_EVERYONE)
		.setRecordOn(true)
		.setMailOn(true)
		.setSmsOn(true)
		.setEmailCalenderOn(true)
 
		.setAttendees(attendeeInfos);

BookCycleConfParam bookCycleConfParam = new BookCycleConfParam();
bookCycleConfParam.setBookConfParam(bookConfParam);
bookCycleConfParam.setCycleConfParam(cycleConfParam);
HWMBizSdk.getBizOpenApi().bookCycleConf(bookCycleConfParam, completeHandler);