更新时间:2025-06-30 GMT+08:00
分享

预约会议

bookConf

接口描述

该接口用于预约会议。

注意事项

  1. 会议开始时间晚于当前时间。
  2. 个人会议或者云会议室的时候要传入vmrId。
  3. 携带与会者入会的时候需要传入attendee。
  4. 开启自动录制会议时必须开启录制会议。
  5. callback中的result返回会议详情信息(HWMConfDetail)。

方法定义

1
- (void)bookConf:(HWMOrderConfParam *_Nonnull)param callback:(_Nonnull HWMSDKCompleteHandler)callback;

参数描述

表1 HWMOrderConfParam参数说明

参数

是否必须

类型

描述

confSubject

NSString *

参数解释:

会议主题。

约束限制:

不涉及。

取值范围:

0-385个字符。

默认取值:

不涉及。

startTimeStamp

NSTimeInterval

参数解释:

会议开始时间,UTC时间戳,精度秒。

约束限制:

时间戳不能早于系统当前时间。

默认取值:

不涉及。

duration

NSUInteger

参数解释:

会议持续时长,单位分钟。

约束限制:

不涉及。

取值范围:

15-1440分钟。

默认取值:

不填时由服务端取默认会议时长30分钟。

confType

HWMOrderConfType

参数解释:

会议类型。

约束限制:

不涉及。

默认取值:

OrderConfTypeAudio 音频会议。

isNeedConfPwd

BOOL

参数解释:

是否需要来宾密码。

约束限制:

仅对随机会议ID生效。

默认取值:

NO 不需要来宾密码。

guestPwd

NSSting *

参数解释:

来宾密码。

约束限制:

如果空则服务器随机生成。仅对随机会议ID生效。

取值范围

0-64个字符。

默认取值

不涉及。

isRecordOn

BOOL

参数解释:

录制会议开关,字段即将废弃,不建议使用。

约束限制:

仅对云录制生效,客户端本地录制不生效。

默认取值:

NO 不开启录制。

isAutoRecord

BOOL

参数解释:

是否开启自动录制会议。

约束限制:

仅对云录制生效,客户端本地录制不生效。开启自动录制会议时必须开启录制会议。

默认取值:

NO 不开启自动录制会议。

timeZone

NSUInteger

参数解释:

时区。

约束限制:

不涉及。

取值范围:

详情参考时区表

默认取值:

56-东八区。

vmrId

NSString *

参数解释:

个人会议或者云会议室Id。

约束限制:

创建个人会议或云会议室的时候传入,其它时候传入空。

取值范围:

0-128个字符。

默认取值:

不涉及。

vmrIdType

HWMVmrIdType

参数解释:

VMR ID类型(固定/随机)。

约束限制:

不涉及。

默认取值:

HWMVmrIdType 固定类型。

callInRestrictionType

HWMJoinConfRestrictionType

参数解释:

允许入会范围限制。

约束限制:

不涉及。

默认取值:

HWMJoinConfRestrictionAll 所有用户。

attendee

NSArray<HWMAttendeeInfo *> *

参数解释:

成员列表,可选。

约束限制:

不涉及。

默认取值

不涉及。

isSmsOn

BOOL

参数解释:

发送短信通知开关。

约束限制:

保留字段,暂不提供短信通知能力。

默认取值:

NO 不发送短信通知。

isMailOn

BOOL

参数解释:

发送邮件通知开关,可选参数。

约束限制:

企业配置里面需要开启,否则不生效。

默认取值:

NO 不发送邮件通知。

isEmailCalenderOn

BOOL

参数解释:

发送邮件日历开关。

约束限制:

企业配置里面需要开启,否则不生效。

默认取值:

NO 不发送邮件日历。

allowGuestStartConf

BOOL

参数解释:

是否允许来宾提前启动会议。

约束限制:

默认取值:

YES 允许来宾提前启动会议。

allowGuestStartConfTime

NSInteger

参数解释:

允许来宾提前入会时间范围(单位:分钟)。

约束限制

  • 仅针对随机会议ID的会议生效。
  • 固定会议ID的会议,不支持设置提前入会时间。

取值范围:

  • 0 - 随时。
  • x - 提前x分钟启动会议。

默认取值:

0 随时。

isOpenWaitingRoom

BOOL

参数解释:

等候室开启开关。

约束限制:

需要等候室功能开通后才能生效。

默认取值:

NO 不开启等候室。

customInfo

NSString *

参数解释:

自定信息(会议详情、会中消息推送可以查看)。

约束限制:

不涉及。

取值范围:

0-64个字符。

默认取值:

不涉及。

concurrentParticipants

NSUInteger

参数解释:

会议方数,会议最大与会人数限制。

约束限制

不涉及

取值范围

不涉及

默认取值

不填则不限制

autoMuteMode

HWMAutoMuteType

参数解释:

个人客户端入会是否自动静音。

约束限制:

不涉及。

默认取值:

HWMAutoMuteTypeDefault 与默认配置一致。

hardTerminalAutoMuteMode

HWMAutoMuteType

参数解释:

会议室设备入会是否自动静音。

约束限制:

不涉及。

默认取值:

HWMAutoMuteTypeDefault 与默认配置一致。

confResType

HWMConfResType

参数解释:

会议资源类型。

约束限制:

不涉及。

默认取值:

HWMSDKConfRestypeDefault 默认。

defaultSummaryState

HWMSummaryState

参数解释:

会议云录制是否包含纪要,初始值。

约束限制:

仅企业配置支持智能会议纪要时生效(corpEnableSummary),参考企业配置信息通知

默认取值:

HWMSDKSummaryStateClose 会议纪要关闭。

autoPublishSummary

BOOL

参数解释:

是否自动发布纪要(免人工审核)。

约束限制

不涉及。

默认取值

NO 不自动发布纪要。

attendeesExcludeSelf

BOOL

参数解释:

SDK预约会议是否去掉预定者。

约束限制

不涉及。

默认取值

NO 携带预定者。

表2 枚举HWMOrderConfType说明

参数

描述

OrderConfTypeAudio

音频会议

OrderConfTypeVideo

视频会议

表3 枚举HWMJoinConfRestrictionType说明

参数

说明

HWMJoinConfRestrictionAll

0

所有用户

HWMJoinConfRestrictionCompany

2

企业内用户

HWMJoinConfRestrictionInvited

3

被邀请用户

表4 HWMAttendeeInfo 参数说明

参数

是否必传

类型

描述

number

NSString *

参数解释:

号码。

约束限制

如果填分配给账号的sip号码(如+99111244216210249)则呼叫该账号的App;如果填PSTN号码(如18700000000),则通过VoIP网关呼叫该号码,前提是该企业已开通PSTN呼叫权限。与thirdUserId二选一,账号密码鉴权时使用。

取值范围

0-128个字符。

默认取值

不涉及。

thirdUserId

NSString *

参数解释:

第三方用户ID。

约束限制

与number二选一,App ID鉴权时使用。

取值范围

0-128个字符。

默认取值

不涉及。

name

NSString *

参数解释:

与会者名称。

约束限制

不涉及。

取值范围

0-256个字符。

默认取值

不涉及。

email

NSString *

参数解释:

电子邮箱地址,用于发送邮件通知。

约束限制

不涉及。

取值范围

0-256个字符。

默认取值

不涉及。

sms

NSString *

参数解释:

短信通知手机号码,用于发送短信通知。

约束限制

不涉及。

取值范围

0-128个字符。

默认取值

不涉及。

role

ConfRoleType

参数解释:

会议角色。

约束限制

不涉及。

默认取值

ConfRoleTypeAttendee 普通与会者。

accountId

NSString *

参数解释:

用户UUID。

约束限制

不涉及。

取值范围

0-128个字符。

默认取值:

不涉及。

userUuid

NSString *

参数解释:

在编辑会议时这个值由会议详情上报,默认是空字符串。

isAnonymous

BOOL

参数解释:

是否是匿名入会(仅用于获取与会者列表使用)。

state

HWMConfAttendeeState

参数解释:

与会者状态(仅用于获取与会者列表使用)。

orgId

NSString *

参数解释:

企业id。

约束限制

不涉及。

取值范围

0-32个字符。

默认取值

不涉及。

表5 枚举ConfRoleType说明

参数

说明

ConfRoleTypeAttendee

普通与会者

ConfRoleTypeChairman

主持人

ConfRoleTypeAudience

观众

ConfRoleTypeCohost

联席主持人

表6 枚举HWMVmrIdType说明

参数

说明

HWMVmrIdTypeFixed

固定类型

HWMVmrIdTypeRandom

随机类型

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
/// 预约会议
- (void)bookConf {
    HWMOrderConfParam * param = [[HWMOrderConfParam alloc] init];
    param.confSubject = @"会议名称";
    param.startTimeStamp = 1598759580;
    param.duration = 15;
    param.confType = HWMConfTypeVideo;
    param.isNeedConfPwd = YES;
    param.isRecordOn = NO;
    param.timeZone = 56;
    param.vmrId = @"";
    param.callInRestrictionType = HWMCallRestrictionAll;
    [[HWMBizSdk getBizOpenApi] bookConf:param callback:^(NSError *_Nullable error, id _Nullable result) {
        if (error) {
            NSLog(@"预约会议失败:%@", error.localizedDescription);
        } else {
            NSLog(@"预约会议成功");
        }
    }];
}

相关文档