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
startDate	Yes	NSUInteger	Start date timestamp, in seconds (GMT).
endDate	Yes	NSUInteger	End date timestamp, in seconds (GMT).
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

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

        

      

    
   