Help Center/ Meeting/ Client SDK Reference/ iOS SDK/ APIs/ Meeting Management/ Scheduling a Recurring Meeting Series

Updated on 2025-05-29 GMT+08:00

View PDF

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 information returned in the callback, see HWMConfDetail.

Method Definition

    
         - (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
startTimeStamp	Yes	NSUInteger	Start time. The value is a UTC timestamp, accurate to seconds.
endTimeStamp	Yes	NSUInteger	End time. The value is a UTC timestamp, accurate to seconds.
cycleType	Yes	HWMCycleType	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. - 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	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

    
     
       
       
         /// 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.startTimeStamp = 1633017600; // UTC timestamp, in seconds
    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.startTimeStamp = 1633017600; // UTC timestamp, in seconds
    cycleConfParamModel.endTimeStamp = 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]];
        }
    }];
}

        

      

    
   