文档首页/华为云会议 Meeting/客户端SDK参考/Mac SDK/接口参考/会议控制/创建会议
更新时间：2025-10-13 GMT+08:00
查看PDF
分享

创建会议

createConf

接口描述

该接口用于创建即时会议。

注意事项

  1. 该接口默认已将自己作为主持人加入会议，调用接口时，在与会者参数中不需要带上自己的信息。
  2. 若需要在创建会议的同时邀请其他与会者，需要传入其他与会者信息。
  3. 创会结果在callback中返回。

方法定义

1
- (void)createConf:(HWMCreateConfParam * _Nonnull)param callback:( _Nonnull HWMSDKCreateConfCompleteHandler)callback;

参数描述

表1 HWMCreateConfParam参数说明

参数

是否必须

类型

描述

subject

是

NSString *

参数解释：

会议主题。

约束限制：

不涉及。

取值范围：

0-128个字符。

默认取值：

不涉及。

members

否

NSArray <HWMAttendeeInfo*> *

参数解释：

成员列表，可选。

约束限制：

不涉及。

默认取值：

不涉及。

isCameraOn

否

BOOL

参数解释：

是否打开摄像头。

约束限制：

不涉及。

默认取值：

NO 关闭。

isMicOn

否

BOOL

参数解释：

是否打开麦克风。

约束限制：

不涉及。

默认取值：

YES 打开。

isAutoRecord

否

BOOL

参数解释：

是否开启自动录制会议。

约束限制：

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

默认取值：

NO 关闭。

isRecordOn

否

BOOL

参数解释：

是否开启录制会议。

约束限制：

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

默认取值：

NO 关闭。

vmrId

否

NSString *

参数解释：

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

约束限制：

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

取值范围：

0-128个字符。

默认取值：

不涉及。

callInRestrictionType

否

HWMJoinConfRestrictionType

参数解释：

允许入会范围限制。

约束限制：

不涉及。

默认取值：

HWMJoinConfRestrictionAll 所有用户。

noPassword

否

BOOL

参数解释：

会议是否无密码。

约束限制：

仅对随机会议ID生效。

默认取值：

NO 有密码。

guestPwd

否

NSString

参数解释：

来宾密码。

约束限制：

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

取值范围：

0-64个字符。

默认取值：

不涉及。

isVideo

否

BOOL

参数解释：

是否创建视频会议。

约束限制：

不涉及。

默认取值：

YES 视频会议。

vmrConfIdType

否

HWMVmrConfIdType

参数解释：

云会议室的会议ID类型。

约束限制：

不涉及。

默认取值：

HWMVmrConfIdTypeFixed 默认固定类型。

isOpenWaitingRoom

否

BOOL

参数解释：

是否开启等候室。

约束限制：

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

默认取值：

NO 不开启等候室。

customInfo

否

NSString *

参数解释：

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

约束限制：

不涉及。

取值范围：

0-64个字符。

默认取值：

不涉及。

concurrentParticipants

否

NSUInteger

参数解释：

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

约束限制：

不涉及。

取值范围：

  • 0：无限制。
  • 大于0：会议最大与会人数。

默认取值：

不填则不限制。

confResType

否

HWMConfResType

参数解释：

会议资源类型。

约束限制：

不涉及。

默认取值：

HWMSDKConfRestypeDefault 默认。

autoMuteMode

否

HWMAutoMuteType

参数解释：

来宾入会，软终端是否自动静音。

约束限制：

不涉及。

默认取值：

HWMSDKAutoMuteTypeDefault 与默认配置一致。

hardTerminalAutoMuteMode

否

HWMAutoMuteType

参数解释：

来宾入会，硬终端是否自动静音。

约束限制：

不涉及。

默认取值：

HWMSDKAutoMuteTypeDefault 与默认配置一致。

defaultSummaryState

否

HWMSummaryState

参数解释：

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

约束限制：

仅企业配置支持智能会议纪要时生效（corpEnableSummary），参考企业配置信息。

默认取值：

HWMSDKSummaryStateClose 会议纪要关闭。

autoPublishSummary

否

BOOL

参数解释：

是否自动发布纪要（免人工审核）。

约束限制：

不涉及。

默认取值：

NO 不自动发布纪要。

表2 HWMAttendeeInfo 参数说明

参数

是否必须

类型

描述

name

是

NSString

参数解释：

与会者名称。

约束限制：

不涉及。

取值范围：

0-256个字符。

默认取值：

不涉及。

number

否

NSString

参数解释：

号码。

约束限制：

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

取值范围：

0-128个字符。

默认取值：

不涉及。

thirdUserId

否

NSString

参数解释：

第三方用户ID。

约束限制：

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

取值范围：

0-128个字符。

默认取值：

不涉及。

accountId

否

NSString

参数解释：

用户登录账号。

约束限制：

若为用户名/密码登录场景 必填。

取值范围：

0-128个字符。

默认取值：

不涉及。

email

否

NSString

参数解释：

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

约束限制：

不涉及。

取值范围：

0-256个字符。

默认取值：

不涉及。

sms

否

NSString

参数解释：

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

约束限制：

不涉及。

取值范围：

0-128个字符。

默认取值：

不涉及。

mute

否

BOOL

参数解释：

是否闭音。

约束限制：

不涉及。

默认取值：

NO 不静音。

role

否

HWMConfRoleType

参数解释：

会议角色。

约束限制：

不涉及。

默认取值：

HWMConfRoleTypeAttendee 普通与会者。

orgId

否

NSString

参数解释：

用于识别是否是本企业账号（仅用于获取与会者列表使用）。

isAutoInvite

否

BOOL

参数解释：

是否自动外邀。

约束限制：

不涉及。

默认取值：

YES 自动外邀。

表3 枚举HWMConfResType说明

枚举值

描述

HWMSDKConfRestypeDefault

默认。

HWMSDKConfRestypeShareVmr

共享vmr。

表4 枚举HWMAutoMuteType说明

枚举值

描述

HWMSDKAutoMuteTypeDefault

默认。

HWMSDKAutoMuteTypeMute

静音。

HWMSDKAutoMuteTypeUnmute

非静音。

表5 枚举HWMSummaryState说明

枚举值

描述

HWMSDKSummaryStateClose

会议纪要关闭。

HWMSDKSummaryStateOpen

会议纪要开启。

返回值

无

示例代码
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
/// 创建会议
- (void)creatMeeting {
    HWMCreateConfParam *param = [[HWMCreateConfParam alloc] init];
    param.subject = @"会议标题";
    param.isCameraOn = YES;// 是否打开摄像头, 默认关闭
    param.isMicOn = YES;// 是否打开麦克风， 默认打开
    param.isAutoRecord = NO;// 是否打开会议自动录制， 默认关闭
    param.joinConfRestrictionType = HWMJoinConfRestrictionAll;// 允许入会范围

    [[HWMSdk getOpenApi] createConf:param callback:^(NSError * _Nullable error, HWMCreateConfResult * _Nullable result) {
        [self hideLoading];
        if (error) {
            NSLog(@"创会失败%@", error.localizedDescription);
        }else{
            NSLog(@"创会成功");
        }
    }];
}
父主题：会议控制

相关文档