Help Center/ Meeting/ Client SDK Reference/ macOS SDK/ APIs/ Meeting Management/ Scheduling a Recurring Meeting Series
Updated on 2025-05-29 GMT+08:00

Scheduling a Recurring Meeting Series

bookCycleConf

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.
  • For details about the meeting details returned in the callback, see HWMConfDetail.

Method Definition

1
- (void)bookCycleConf:(HWMBookCycleConfParam *_Nonnull)param callback:(_Nonnull HWMSDKCompleteHandler)callback;

Parameter Description

Table 1 HWMBookCycleConfParam parameter description

Parameter

Mandatory

Type

Description

confParam

Yes

HWMOrderConfParam

Parameters for scheduling the recurring meeting series.

cycleConfParam

Yes

HWMCycleConfParam

Recurring meeting parameters.

Table 2 HWMCycleConfParam parameter description

Parameter

Mandatory

Type

Description

startTimeStamp

Yes

NSTimeInterval

Start time. The value is a UTC timestamp, accurate to seconds.

endTimeStamp

Yes

NSTimeInterval

End time. The value is a UTC timestamp, accurate to seconds.

cycleMode

Yes

HWMCycleMode

Period type.

interval

Yes

NSUInteger

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

NSString *

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

preRemindDays

Yes

NSUInteger

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

Table 3 Enumerated values of HWMCycleMode

Value

Description

HWMCycleModeDay

Daily.

HWMCycleModeWeek

Weekly.

HWMCycleModeMonth

Monthly.

Sample Code
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
/// Schedule a recurring meeting series.
- (void)bookCycleConf{
    HWMOrderConfParam * orderConfParam = [[HWMOrderConfParam alloc] init];
    orderConfParam.confSubject = @"My Scheduled Meeting";
    orderConfParam.isAutoRecord = YES;
    orderConfParam.startTime = 1633017600; // UTC timestamp, in seconds. If the obtained time is the local time, the time needs to be converted to the UTC time.
    orderConfParam.duration = 30; // Meeting duration, in minutes
    orderConfParam.timeZone = 56;
    orderConfParam.callInRestrictionType = HWMCallRestrictionAll;
    HWMAttendeeInfo * attendeeInfo = [[HWMAttendeeInfo alloc] init];
    attendeeInfo.name = @"Mike";
    attendeeInfo.number = @"+991116003543";
    attendeeInfo.isMute = YES;
    orderConfParam.attendee = @[attendeeInfo];
    
    HWMCycleConfParamModel * cycleConfParamModel = [[HWMCycleConfParamModel alloc] init];
    cycleConfParamModel.startDate = 1633017600; // UTC timestamp, in seconds. If the obtained time is the local time, the time needs to be converted to the UTC time.
    cycleConfParamModel.endDate = 1636560000;
    cycleConfParamModel.cycleType = HWMSDKCycleTypeWeek;
    cycleConfParamModel.preRemindDays = 1;
 
    
    HWMBookCycleConfParam *param = [[HWMBookCycleConfParam alloc] init];
    param.confParam = orderConfParam;
    param.cycleConfParam = cycleConfParamModel;
    [[HWMBizSdk getBizOpenApi] bookCycleConf:param callback:^(NSError * _Nullable error, id  _Nullable result) {
        if (!error) {
            NSLog(@"book cycle conf success");
        }else{
            NSLog(@"book cycle conf fail errorCode : %zd",error.code);
        }
    }];
}