Help Center> Meeting> Client SDK Reference> iOS SDK> API Reference> Meeting Management> Scheduling a Recurring Meeting Series
Updated on 2023-03-23 GMT+08:00

Scheduling a Recurring Meeting Series

bookCycleConf

API Description

This API is used to schedule a recurring meeting series.

Precautions

  1. This API can be called only when you have logged in to Huawei Cloud Meeting.
  2. The meeting start time must be later than the current time, and the meeting duration must be longer than 15 minutes.
  3. The vmrId parameter must be passed for a personal meeting or cloud meeting room.
  4. The attendees parameter must be passed if participant information needs to be carried.
  5. 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 information returned in the callback, see HWMConfDetail.

Method Definition

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

Parameter Description

Table 1 HWMOrderCycleConfParam parameter description

Parameter

Mandatory

Type

Description

orderConfParam

Yes

HWMOrderConfParam

Common meeting parameters.

cycleParam

Yes

HWMSDKCycleConfParamModel

Recurring meeting series parameters.

Table 2 HWMSDKCycleConfParamModel parameter description

Parameter

Mandatory

Type

Description

startDate

Yes

NSUInteger

Start date timestamp, in seconds (GMT).

endDate

Yes

NSUInteger

End date timestamp, in seconds (GMT).

cycleCount

Yes

NSUInteger

Number of recurring meetings.

cycleType

Yes

HWMCycleType

Period type.

interval

Yes

NSUInteger

Interval of recurring meetings.

1. If cycleType is set to Day, the recurring meeting is held at an interval of the specified number of days. The value ranges from 1 to 15.

2. If cycleType is set to Week, the recurring meeting is held at an interval of the specified number of weeks. The value ranges from 1 to 5.

3. If cycleType is set to Month, the recurring meeting is held at an interval of the specified number of months. The value ranges from 1 to 3.

listPoints

Yes

NSString *

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

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

- Monthly: The value range is [1,31]. The maximum value is the last day of a month, for example, 30 when a month only has 30 days.

preRemindDays

Yes

NSUInteger

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

Table 3 Enumerated values of Contact

Value

Description

HWMSDKCycleTypeDay

Daily.

HWMSDKCycleTypeWeek

Weekly.

HWMSDKCycleTypeMonth

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
34
35
/// Schedule a recurring meeting series.
- (void)bookCycleConf{
    HWMOrderCycleConfParam * cycleConfParam = [[HWMOrderCycleConfParam alloc] init];
    cycleConfParam.orderConfParam.confSubject = @"My Scheduled Meeting";
    cycleConfParam.orderConfParam.confType = OrderConfTypeVideo;
    cycleConfParam.orderConfParam.isNeedConfPwd = YES;
    cycleConfParam.orderConfParam.isAutoRecord = YES;
    cycleConfParam.orderConfParam.isRecordOn = YES;
    cycleConfParam.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.
    cycleConfParam.orderConfParam.duration = 30; // Meeting duration, in minutes
    cycleConfParam.orderConfParam.timeZone = 56;
    cycleConfParam.orderConfParam.callInRestrictionType = HWMJoinConfRestrictionAll;
    HWMAttendeeInfo * attendeeInfo = [[HWMAttendeeInfo alloc] init];
    attendeeInfo.name = @"Mike";
    attendeeInfo.number = @"+991116003543";
    attendeeInfo.isMute = YES;
    cycleConfParam.orderConfParam.attendee = @[attendeeInfo];
    
    HWMSDKCycleConfParamModel * cycleConfParamModel = [[HWMSDKCycleConfParamModel 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;
    cycleConfParam.cycleParam = cycleConfParamModel;
    
    [[HWMBizSdk getBizOpenApi] bookCycleConf:cycleConfParam callback:^(NSError * _Nullable error, id  _Nullable result) {
        if (!error) {
            NSLog(@"book cycle conf success");
            [UIUtil showMessage:@"Recurring meeting series scheduled."];
        }else{
            NSLog(@"book cycle conf fail errorCode : %zd",error.code);
            [UIUtil showMessage:[NSString stringWithFormat:@"Schedule recurring meeting series failed:%zd %@", error.code, error.localizedDescription]];
        }
    }];
}