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

Updated on 2024-07-30 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:(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	Parameters of recurring meetings.

**Table 2** HWMCycleConfParam parameter description
Parameter	Mandatory	Type	Description
startDate	Yes	NSTimeInterval	Start date and timestamp, in seconds (GMT).
endDate	Yes	NSTimeInterval	End date and timestamp, in seconds (GMT).
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 ranges from 1 to 15. 2. If cycleType is set to weekly, there is a meeting every several weeks. The value ranges from 1 to 5. 3. If cycleType is set to monthly, there is a meeting every several 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. Separate values by colons (,), 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

     
      
        
        
          /// 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);
        }
    }];
}

         

       

     
    