预约会议
bookConf
接口描述
该接口用于预约会议。
注意事项
- 会议开始时间晚于当前时间。
- 个人会议或者云会议室的时候要传入vmrId。
- 携带与会者入会的时候需要传入attendee。
- 开启自动录制会议时必须开启录制会议。
- callback中的result返回会议详情信息 (HWMConfDetail)。
方法定义
1 | - (void)bookConf:(HWMOrderConfParam *_Nonnull)param callback:(_Nonnull HWMSDKCompleteHandler)callback; |
参数描述
参数 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
confSubject | 是 | NSString * | 参数解释: 会议主题。 约束限制: 不涉及。 取值范围: 0-128个字符。 默认取值: 不涉及。 |
startTimeStamp | 是 | NSTimeInterval | 参数解释: 会议开始时间,UTC时间戳,精度秒。 约束限制: 时间戳不能早于系统当前时间。 取值范围: 不涉及。 默认取值: 不涉及。 |
duration | 否 | NSUInteger | 参数解释: 会议持续时长,单位分钟。 约束限制: 不涉及。 取值范围: 最小值15分钟,最大值1440分钟。 默认取值: 不填时由服务端取默认会议时长30分钟。 |
isAutoRecord | 否 | BOOL | 参数解释: 是否开启自动录制会议。 约束限制: 仅对云录制生效,客户端本地录制不生效。开启自动录制会议时必须开启录制会议。 默认取值: NO 关闭。 |
isRecordOn | 否 | BOOL | 参数解释: 是否开启录制会议。 约束限制: 仅对云录制生效,客户端本地录制不生效。 默认取值: NO 关闭。 |
timeZone | 是 | NSUInteger | 参数解释: 时区。 约束限制: 不涉及。 取值范围: 详情参考时区表,参数值1-73可用。 默认取值: 当前时区(中国默认时区56-东八区)。 |
vmrId | 否 | NSString * | 参数解释: 个人会议或者云会议室Id。 约束限制: 创建个人会议或云会议室的时候传入,其它时候传入空。 取值范围: 0-128个字符。 默认取值: 不涉及。 |
callInRestrictionType | 否 | 参数解释: 允许入会范围限制。 约束限制: 不涉及。 默认取值: HWMJoinConfRestrictionAll 所有用户。 | |
attendee | 否 | NSArray<HWMAttendeeInfo *> * | 参数解释: 成员列表,可选。 约束限制: 不涉及。 默认取值: 不涉及。 |
isSmsOn | 否 | BOOL | 参数解释: 发送短信通知开关。 约束限制: 保留字段,暂不提供短信通知能力。 默认取值: NO 不发送短信通知。 |
isMailOn | 否 | BOOL | 参数解释: 发送邮件通知开关,可选参数。 约束限制: 企业配置里面需要开启,否则不生效。 默认取值: NO 不发送邮件通知。 |
isEmailCalenderOn | 否 | BOOL | 参数解释: 发送邮件日历开关。 约束限制: 企业配置里面需要开启,否则不生效。 默认取值: NO 不发送邮件日历。 |
noPassword | 否 | BOOL | 参数解释: 会议是否无密码。 约束限制: 仅对随机会议ID生效。 默认取值: NO 有密码。 |
guestPwd | 否 | NSString | 参数解释: 来宾密码。 约束限制: 如果空则服务器随机生成。仅对随机会议ID生效。 取值范围: 0-64个字符。 默认取值: 不涉及。 |
isVideo | 否 | BOOL | 参数解释: 是否预约视频会议。 约束限制: 不涉及。 默认取值: YES 视频会议。 |
vmrConfIdType | 否 | 参数解释: 云会议室的会议ID类型。 约束限制: 不涉及。 默认取值: HWMVmrConfIdTypeFixed 固定类型。 | |
allowGuestStartConf | 否 | BOOL | 参数解释: 是否允许来宾提前启动会议。 约束限制:
默认取值: YES 允许来宾提前启动会议。 |
allowGuestStartConfTime | 否 | NSUInteger | 参数解释: 允许来宾提前入会时间范围(单位:分钟)。 约束限制:
取值范围:
默认取值: 0 随时。 |
isOpenWaitingRoom | 否 | BOOL | 参数解释: 是否开启等候室。 约束限制: 需要等候室功能开通后才能生效。 默认取值: NO 不开启等候室。 |
customInfo | 否 | NSString * | 参数解释: 自定信息(会议详情、会中消息推送可以查看)。 约束限制: 不涉及。 取值范围: 0-64个字符。 默认取值: 不涉及。 |
concurrentParticipants | 否 | NSUInteger | 参数解释: 会议方数,会议最大与会人数限制。 约束限制: 不涉及。 取值范围:
默认取值: 不填则不限制。 |
confResType | 否 | 参数解释: 会议资源类型。 约束限制: 不涉及。 默认取值: HWMSDKConfRestypeDefault 默认。 | |
autoMuteMode | 否 | 参数解释: 来宾入会,软终端是否自动静音。 约束限制: 不涉及。 默认取值: HWMSDKAutoMuteTypeDefault 与默认配置一致。 | |
hardTerminalAutoMuteMode | 否 | 参数解释: 来宾入会,硬终端是否自动静音。 约束限制: 不涉及。 默认取值: HWMSDKAutoMuteTypeDefault 与默认配置一致。 | |
defaultSummaryState | 否 | 参数解释: 会议云录制是否包含纪要,初始值。 约束限制: 仅支持会议纪要时生效。 默认取值: HWMSDKSummaryStateClose 会议纪要关闭。 | |
autoPublishSummary | 否 | BOOL | 参数解释: 是否自动发布纪要(免人工审核)。 约束限制: 不涉及。 默认取值: NO 不自动发布纪要。 |
attendeesExcludeSelf | 否 | BOOL | 参数解释: 预约会议是否去掉预定者。 约束限制: 不涉及。 默认取值: NO 携带预定者。 |
参数 | 值 | 说明 |
|---|---|---|
HWMJoinConfRestrictionAll | 0 | 所有用户 |
HWMJoinConfRestrictionCompany | 2 | 企业内用户 |
HWMJoinConfRestrictionInvited | 3 | 被邀请用户 |
参数 | 是否必传 | 类型 | 描述 |
|---|---|---|---|
number | 否 | NSString * | 参数解释: 号码。 约束限制: 如果填分配给账号的sip号码(如+99111244216210249)则呼叫该账号的App;如果填PSTN号码(如18700000000),则通过VoIP网关呼叫该号码,前提是该企业已开通PSTN呼叫权限。与thirdUserId二选一,账号密码鉴权时使用。 取值范围: 0-128个字符。 默认取值: 不涉及。 |
thirdUserId | 否 | NSString * | 参数解释: 第三方用户ID。 约束限制: 与number二选一,App ID鉴权时使用。 取值范围: 0-128个字符。 默认取值: 不涉及。 |
name | 否 | NSString * | 参数解释: 与会者名称。 约束限制: 不涉及。 取值范围: 0-256个字符。 默认取值: 不涉及。 |
否 | NSString * | 参数解释: 电子邮箱地址,用于发送邮件通知。 约束限制: 不涉及。 取值范围: 0-256个字符。 默认取值: 不涉及。 | |
sms | 否 | NSString * | 参数解释: 短信通知手机号码,用于发送短信通知。 约束限制: 不涉及。 取值范围: 0-128个字符。 默认取值: 不涉及。 |
role | 否 | 参数解释: 会议角色。 约束限制: 不涉及。 默认取值: HWMConfRoleTypeAttendee 普通与会者。 | |
accountId | 否 | NSString * | 参数解释: 用户UUID。 约束限制: 不涉及。 取值范围: 0-128个字符。 默认取值: 不涉及。 |
mute | 否 | BOOL | 参数解释: 是否闭音。 约束限制: 不涉及。 默认取值: NO 不静音。 |
isAnonymous | 否 | BOOL | 参数解释: 是否是匿名入会(仅用于获取与会者列表使用)。 |
state | 否 | 参数解释: 与会者状态(仅用于获取与会者列表使用)。 | |
orgId | 否 | NSString * | 参数解释: 用于识别是否是本企业账号(仅用于获取与会者列表使用)。 |
枚举值 | 描述 |
|---|---|
HWMVmrConfIdTypeFixed | 云会议室的会议ID类型是固定类型。 |
HWMVmrConfIdTypeRandom | 云会议室的会议ID类型是随机类型。 |
示例代码
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | /// 预约会议 - (void)bookConf { HWMOrderConfParam * param = [[HWMOrderConfParam alloc] init]; param.confSubject = @"会议名称"; param.startTime = 1598759580; param.duration = 15; param.isAutoRecord = NO; param.timeZone = 56; param.vmrId = @""; param.attendee = self.attenteeArr; param.callInRestrictionType = HWMCallRestrictionAll; [[HWMBizSdk getBizOpenApi] bookConf:param callback:^(NSError *_Nullable error, id _Nullable result) { if (error) { NSLog(@"预约会议失败:%@", error.localizedDescription); } else { NSLog(@"预约会议成功"); } }]; } |

