更新时间:2025-07-03 GMT+08:00
分享

创建会议

createConf

接口描述

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

注意事项

  1. 该接口默认已将自己作为主持人加入会议,调用接口时,在与会者参数中不需要带上自己的信息。
  2. 若需要在创建会议的同时邀请其他与会者,需要传入其他与会者信息。若不需要,与会者信息和与会者个数可以为空。

方法定义

1
creatConf(createConfParam: HWMOpenCreateConfParamModel): Promise<HWMCreateConfResult>;

参数描述

参数

是否必须

类型

描述

createConfParam

HWMOpenCreateConfParamModel

创建会议参数。

表1 HWMOpenCreateConfParamModel参数说明

参数

是否必须

类型

描述

confCommonParam

HWMOpenConfCommonParamModel

参数解释:

会议基本信息。

device

HWMOpenConfDeviceConfigModel

参数解释:

设备配置信息。

openCustomPara

string

参数解释:

自定义扩展信息

约束限制

不涉及

取值范围

0-64个字符

默认取值

不涉及

表2 HWMOpenConfCommonParamModel参数说明

参数

是否必须

类型

描述

vmrId

string

参数解释:

云会议室唯一ID。

约束限制

预约随机会议时,设置为空字符串。

取值范围

1-128个字符

默认取值

不涉及

vmrIdType

VmrIdType

参数解释:

云会议室的会议ID类型

约束限制

不涉及

默认取值

HWM_FIXED_ID 固定类型

confMediaType

ConfMediaType

参数解释:

会议媒体类型。

约束限制

仅支持视频会议,填HWM_CONF_MEDIA_VIDEO

默认取值

不涉及

subject

string

参数解释:

会议主题。

约束限制

不涉及

取值范围

1-385个字符

默认取值

不涉及

attendees

Array<HWMOpenAttendeeBaseInfoModel>

参数解释:

与会者信息。

约束限制

若不需要带与会者,参数值可以为空数组。

默认取值

不涉及

promptLanguage

ConfPromptLanguageType

参数解释:

语言。

约束限制

不涉及

默认取值

HWM_CONF_PROMPT_LANGUAGE_ZH_CN 简体中文

recordMode

ConfRecordMode

参数解释:

会议录制模式。

约束限制

不涉及

默认取值

HWM_CONF_RECORD_DISABLE 禁止录制

isGuestJoinConfWithoutPwd

boolean

参数解释:

普通与会者是否可以无密码加入会议。

约束限制

仅对随机会议ID生效

默认取值

false 即需要密码

guestPwd

string

参数解释:

普通与会者密码。

约束限制

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

取值范围

0-64个字符

默认取值

不涉及

confAllowJoinUser

ConfAllowJoinUserType

参数解释:

允许入会范围限制。

约束限制

不涉及

默认取值

HWM_CONF_ALLOW_JOIN_ANYONE 所有用户。

isSendSms

boolean

参数解释:

发送短信通知开关。

约束限制

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

默认取值

false 不开启短信通知能力。

isSendEmail

boolean

参数解释:

发送邮件通知开关。

约束限制

  • 仅对预约会议、编辑会议生效。
  • 企业配置里面需要开启,否则不生效。

默认取值

false 不发送邮件通知。

concurrentParticipants

number

参数解释:

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

约束限制

不涉及

取值范围

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

默认取值

不限制

confResType

ConfResType

参数解释:

会议资源类型。

约束限制

不涉及

默认取值

HWM_CONF_RESTYPE_DEFAULT 默认枚举值

autoMuteMode

AutoMuteType

参数解释:

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

约束限制

不涉及

默认取值

HWM_AUTO_MUTE_TYPE_DEFAULT 默认配置

hardTerminalAutoMuteMode

AutoMuteType

参数解释:

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

约束限制

不涉及

默认取值

HWM_AUTO_MUTE_TYPE_DEFAULT 默认配置

supportWatermark

boolean

参数解释:

会议是否支持水印。

约束限制

不涉及

默认取值

false 不支持。

defaultSummaryState

SummaryState

参数解释:

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

约束限制

仅企业配置支持智能会议纪要时生效(corpEnableSummary),参考HWMOpenCorpConfigParamModel参数说明

默认取值

HWM_SUMMARY_STATE_CLOSE 会议纪要关闭

autoPublishSummary

bool

参数解释:

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

约束限制

不涉及

默认取值

不自动发布纪要

表3 枚举VmrIdType说明

枚举值

描述

HWM_FIXED_ID

VmrId是固定类型。

HWM_RANDOM_ID

VmrId是随机类型。

表4 枚举ConfMediaType说明

枚举值

描述

HWM_CONF_MEDIA_VIDEO

视频会议。

表5 HWMOpenAttendeeBaseInfoModel参数说明

参数

是否必须

类型

描述

name

string

参数解释:

与会者名称。

约束限制

不涉及

取值范围

0-256个字符

默认取值

不涉及

number

string

参数解释:

号码。

约束限制

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

取值范围

0-128个字符

默认取值

不涉及

thirdAccount

string

参数解释:

第三方用户ID。

约束限制

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

取值范围

0-128个字符

默认取值

不涉及

isSelf

boolean

参数解释:

是否是自己。

约束限制

不涉及

默认取值

false 不是自己。

isMute

boolean

参数解释:

是否静音。

约束限制

不涉及

默认取值

false 不静音。

accountId

string

参数解释:

用户登录账号。

约束限制

不涉及

取值范围

0-128个字符

默认取值

不涉及

email

string

参数解释:

邮箱地址。

约束限制

不涉及

取值范围

0-96个字符

默认取值

不涉及

sms

string

参数解释:

短信通知手机号码。

约束限制

不涉及

取值范围

0-128个字符

默认取值

不涉及

userUuid

string

参数解释:

用户UUID。

约束限制

不涉及

取值范围

0-128个字符

默认取值

不涉及

corpId

string

参数解释:

企业id。

约束限制

不涉及

取值范围

0-32个字符

默认取值

不涉及

表6 枚举ConfPromptLanguageType说明

枚举值

描述

HWM_CONF_PROMPT_LANGUAGE_ZH_CN

简体中文。

HWM_CONF_PROMPT_LANGUAGE_EN_US

美国英文。

表7 枚举ConfRecordMode说明

枚举值

描述

HWM_CONF_RECORD_DISABLE

禁止录制。

HWM_CONF_RECORD_LIVE

直播模式。

HWM_CONF_RECORD_RECORD

录播模式。

HWM_CONF_RECORD_LIVE_AND_RECORD

直播 + 录播模式。

表8 枚举ConfAllowJoinUserType说明

枚举值

描述

HWM_CONF_ALLOW_JOIN_ANYONE

任何人。

HWM_CONF_ALLOW_JOIN_LOGINED_USER

已登录用户。

HWM_CONF_ALLOW_JOIN_IN_COMPANY_USER

企业内用户。

HWM_CONF_ALLOW_JOIN_INVITED_USER

被邀请用户。

表9 枚举ConfResType说明

枚举值

描述

HWM_CONF_RESTYPE_DEFAULT

默认。

HWM_CONF_RESTYPE_SHARE_VMR

共享vmr。

表10 枚举AutoMuteType说明

枚举值

描述

HWM_AUTO_MUTE_TYPE_DEFAULT

与默认配置一致。

HWM_AUTO_MUTE_TYPE_MUTE

静音。

HWM_AUTO_MUTE_TYPE_UNMUTE

非静音。

表11 HWMOpenConfDeviceConfigModel参数说明

参数

是否必须

类型

描述

isMicOn

boolean

参数解释:

是否开启麦克风。

约束限制

不涉及

默认取值

false 不开启麦克风。

isSpeakerOff

boolean

参数解释:

移动端:true-打开听筒,false-打开扬声器;

PC端:true-关闭扬声器,false-打开扬声器。

约束限制

不涉及

默认取值

fals。

isCamOn

boolean

参数解释:

是否开启摄像头。

约束限制

不涉及

默认取值

false 不开启摄像头。

返回值

表12 HWMCreateConfResult参数说明

参数

类型

描述

result

SDKERR

接口调用结果,HWM_SDKERR_SUCCESS表示成功,详细请参考错误码参考

reasonDesc

string

错误描述。

createConfResult

HWMCreateConfResultModel

创建会议结果信息

表13 HWMCreateConfResultModel参数说明

参数

类型

描述

confId

string

会议ID。

vmrConfId

string

vmr会议ID。

hostPwd

string

主持人密码。

guestPwd

string

来宾密码。

guestJoinUri

string

来宾链接。

confRole

ConfRole

本人在会议中的角色。

confSubject

string

会议主题。

startTimeStamp

number

会议开始时间(时间戳,单位秒)。

endTimeStamp

number

会议结束时间(时间戳,单位秒)。

schedUserName

string

预约者名字。

isP2PConf

boolean

是否立即会议。

concurrentParticipants

number

会议方数,会议最大与会人数限制. 0: 无限制, 大于0: 会议最大与会人数。

表14 枚举ConfRole说明

枚举值

描述

HWM_ROLE_ATTENDEE

普通与会者。

HWM_ROLE_HOST

会议主持人。

HWM_ROLE_AUDIENCE

观众

HWM_ROLE_COHOST

联席主持人

HWM_ROLE_WAITING

等候室成员

表15 枚举SummaryState说明

枚举值

描述

HWM_SUMMARY_STATE_CLOSE

会议纪要关闭。

HWM_SUMMARY_STATE_OPEN

会议纪要开启。

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
/**
* 创建会议
*/
handleCreateConf() {
   const confCommonParam: HWMOpenConfCommonParamModel = {
      confMediaType: ConfMediaType.HWM_CONF_MEDIA_VIDEO,
      subject: this.subject,
      attendees: [],
      recordMode: this.getRecordMode,
      confAllowJoinUser: this.confAllowJoinUser,
      supportWatermark: this.isWatermarkOn,
      isGuestJoinConfWithoutPwd: this.isGuestJoinConfWithoutPwd,
      guestPwd: this.guestPwd
    }

    const confDeviceConfigModel: HWMConfDeviceConfigModel = {
      isMicOn: this.isMicOn,
      isSpkOn: this.isSpkOn,
      isCamOn: this.isCamOn
    }

    const createConfParam: HWMOpenCreateConfParamModel = {
      confCommonParam: confCommonParam,
      device: confDeviceConfigModel,
    }

    UISDK.getConfCtrlApi().creatConf(createConfParam).then((res: HWMCreateConfResult) => {
      const message: string = res.result === SDKERR.HWM_SDKERR_SUCCESS ? '创建会议成功' : '创建会议失败' + res.result;
      console.log(message);
    })
}

相关文档