更新时间:2024-09-13 GMT+08:00

预约周期会议

接口功能

该接口用于预约周期会议。注意事项:1、该接口在已登录状态下才能调用。2、该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。 3、会议开始时间必须晚于当前时间,会议时长应大于15分钟。4、携带与会者入会的时候需要传入attendees。5、周期会议最大跨度一年,会议数量不超过50,超过则只预约前50个会议。 6、回调函数中会返回预约成功后的会议详情,详见HwmConfDetail结构体表。如果参数内只有会议id有值则获取会议详情失败。

函数原型

bookCycleConf(bookCycleConfParam: BookCycleConfParam, onBookCycleConfResult?: (ret: SDKERR, reason: string, confDetail: ConfDetail) => void): void

请求参数

表1 入参说明
参数名称 是否必选 参数类型 参数说明
bookCycleConfParam Y BookCycleConfParam 预约周期会议的参数体
onBookCycleConfResult Y (ret: SDKERR, reason: string, confDetail: ConfDetail) => void 创建周期会议的结果回调
表2 BookCycleConfParam
参数名称 是否必选 参数类型 参数说明
bookConfParam N BookConfParam 预约会议参数
cycleParam Y CycleConfParam 子会议参数
表3 BookConfParam
参数名称 是否必选 参数类型 参数说明
startTime Y number 会议开始时间时间戳(utc时间),单位是秒。
duration Y number 会议时长,单位分钟,最小值15分钟,最大值1440分钟。
confCommonParam Y ConfCommonParam 会议公用参数
isSendCalendar N boolean 发送邮件日历开关。
表4 ConfCommonParam
参数名称 是否必选 参数类型 参数说明
subject Y string 会议主题。
mediaType N MediaType 会议类型。默认音频会议。
needPassword N boolean 是否需要来宾密码。默认不需要来宾密码(仅对随机会议ID生效)。
isAutoRecord N boolean 会议自动录制开关。默认不开启。 开启会议自动录制开关,内部会默认支持录制会议,录制会议开关的打开与关闭并不影响。 说明:仅对云录制生效,客户端本地录制不生效。
allowRecord N boolean 是否支持录制会议。(仅对win平台生效) 说明:仅对云录制生效,客户端本地录制不生效。
allowLive N boolean 保留。编辑会议时透传会议详情此字段
timezone Y Timezone 时区码。用于发送会议通知。
vmrId N string 云会议室唯一ID。预约并发会议时,设置为空字符串。编辑会议时不可修改,填入会议详情返回值。
confAllowJoinUser N ConfAllowJoinUserType 允许入会范围限制。默认所有用户。
isSendSms N boolean 发送短信通知开关。企业配置里面需要开启,否则不生效。
isSendEmail N boolean 发送邮件通知开关。
vmrConfIdType N VmrConfIdType 云会议室的会议ID类型。编辑会议时不可修改会议详情中vmrConfId非空,填入HWM_VMR_CONF_ID_TYPE_FIXED; 会议详情中vmrConfId为空,填入HWM_VMR_CONF_ID_TYPE_RANDOM
guestPwd N string 来宾密码,如果空则服务器随机生成(仅对随机会议ID生效)。
isOpenWaitingRoom N boolean 等候室开启开关。 说明:需要等候室功能开通后才能生效
numOfAttendee Y number 与会者列表长度。
attendees Y AttendeeBaseInfo 与会者列表。
allowGuestStartConf N boolean 允许来宾启动会议
allowGuestStartConfTime N number 允许来宾提前入会时间范围(单位:分钟) 0-随时,n-提前n分钟启动会议
concurrentParticipants Y number 会议方数,会议最大与会人数限制. 0: 无限制, 大于0: 会议最大与会人数
customInfo N string 用户自定义信息。
confResType N ConfResType 会议资源类型
defaultSummaryState N SummaryState 会议云录制是否包含纪要,初始值(周期会议暂不支持)(仅对win平台生效)
autoMuteMode N AutoMuteType 来宾入会,软终端是否自动静音
hardTerminalAutoMuteMode N AutoMuteType 来宾入会,硬终端是否自动静音
表5 MediaType枚举说明
枚举名称 枚举值 枚举说明
HWM_MEDIA_TYPE_AUDIO 0 音频类型
HWM_MEDIA_TYPE_VIDEO 1 视频类型
表6 Timezone枚举说明
枚举名称 枚举值 枚举说明
HWM_TIMEZONE_DEFAULT 0 Mediax默认时区值
HWM_TIMEZONE_INTERDATE_LINE 1 日界线西
HWM_TIMEZONE_MIDWAY_ISLAND 2 中途岛,萨摩亚群岛
HWM_TIMEZONE_HAWAII 3 夏威夷
HWM_TIMEZONE_ALASKA 4 阿拉斯加
HWM_TIMEZONE_PACIFIC_TIME 5 太平洋时间(美国和加拿大);蒂华纳
HWM_TIMEZONE_ARIZONA 6 亚利桑那
HWM_TIMEZONE_MOUNTAIN_TIME 7 山地时间(美国和加拿大)
HWM_TIMEZONE_CENTRAL_AMERICA 8 中美洲
HWM_TIMEZONE_CENTRAL_TIME 9 中间时间(美国和加拿大)
HWM_TIMEZONE_MEXICO_CITY 10 墨西哥城
HWM_TIMEZONE_SASKATCHEWAN 11 萨斯喀彻温
HWM_TIMEZONE_BOGOTA 12 波哥大,利马,基多
HWM_TIMEZONE_EASTERN_TIME 13 东部时间(美国和加拿大)
HWM_TIMEZONE_INDIANA 14 印第安纳(东部)
HWM_TIMEZONE_ATLANTIC_TIME 15 大西洋时间(加拿大)
HWM_TIMEZONE_CARACAS 16 加拉加斯,拉巴斯
HWM_TIMEZONE_SANTIAGO 17 圣地亚哥
HWM_TIMEZONE_NEWFOUNDLAND 18 纽芬兰
HWM_TIMEZONE_BRASILIA 19 巴西利亚
HWM_TIMEZONE_BUENOS_AIRES 20 布宜诺斯艾利斯,乔治敦
HWM_TIMEZONE_GREENLAND 21 格陵兰
HWM_TIMEZONE_MID_ATLANTIC 22 中大西洋
HWM_TIMEZONE_AZORES 23 亚速尔群岛
HWM_TIMEZONE_CAPEVERDE 24 佛得角群岛
HWM_TIMEZONE_MONROVIA 25 蒙罗维亚
HWM_TIMEZONE_GREENWICH_MEANTIME 26 格林威治标准时:都柏林,爱丁堡,里斯本,伦敦
HWM_TIMEZONE_AMSTERDAM 27 阿姆斯特丹,柏林,伯尔尼,罗马,斯德哥尔摩,维也纳
HWM_TIMEZONE_BELGRADE 28 贝尔格莱德,布拉迪斯拉发,布达佩斯,卢布尔亚纳,布拉格
HWM_TIMEZONE_BRUSSELS 29 布鲁塞尔,哥本哈根,马德里,巴黎
HWM_TIMEZONE_SARAJEVO 30 萨拉热窝,斯科普里,维尔纽斯,索非亚,华沙,萨格勒布
HWM_TIMEZONE_WESTCENTRAL_AFRICA 31 中非西部
HWM_TIMEZONE_ATHENS 32 雅典,伊斯坦布尔,明斯克
HWM_TIMEZONE_BUCHAREST 33 布加勒斯特
HWM_TIMEZONE_CAIRO 34 开罗
HWM_TIMEZONE_HARARE 35 哈拉雷,比勒陀利亚
HWM_TIMEZONE_HELSINKI 36 赫尔辛基,里加,塔林
HWM_TIMEZONE_JERUSALEM 37 耶路撒冷
HWM_TIMEZONE_BAGHDAD 38 巴格达
HWM_TIMEZONE_KUWAIT 39 科威特,利雅得
HWM_TIMEZONE_MOSCOW 40 莫斯科,圣彼得堡,喀山,伏尔加格勒
HWM_TIMEZONE_NAIROBI 41 内罗毕
HWM_TIMEZONE_TEHRAN 42 德黑兰
HWM_TIMEZONE_ABU_DHABI 43 阿布扎比,马斯喀特
HWM_TIMEZONE_TBILISI 44 第比利斯,埃里温
HWM_TIMEZONE_KABUL 45 喀布尔
HWM_TIMEZONE_EKATERINBURG 46 叶卡捷琳堡
HWM_TIMEZONE_ISLAMABAD 47 伊斯兰堡,卡拉奇,塔什干
HWM_TIMEZONE_CALCUTTA 48 加尔各答,马德拉斯,孟买,新德里
HWM_TIMEZONE_KATHMANDU 49 加德满都
HWM_TIMEZONE_ALMATY 50 阿拉木图
HWM_TIMEZONE_ASTANA 51 阿斯塔纳,达卡
HWM_TIMEZONE_SRIJAYA 52 斯里哈亚华登尼普拉
HWM_TIMEZONE_RANGOON 53 仰光
HWM_TIMEZONE_BANGKOK 54 曼谷,雅加达,河内
HWM_TIMEZONE_NOVOSIBIRSK 55 新西伯利亚
HWM_TIMEZONE_BEIJING 56 北京,重庆,香港,乌鲁木齐,台北
HWM_TIMEZONE_KRASNOYARSK 57 克拉斯诺亚尔斯克,乌兰巴托
HWM_TIMEZONE_KUALA_LUMPUR 58 吉隆坡,新加坡
HWM_TIMEZONE_PERTH 59 珀斯
HWM_TIMEZONE_OSAKA 60 东京,大阪,札幌
HWM_TIMEZONE_SEOUL 61 汉城
HWM_TIMEZONE_YAKUTSK 62 雅库茨克
HWM_TIMEZONE_ADELAIDE 63 阿德莱德
HWM_TIMEZONE_DARWIN 64 达尔文
HWM_TIMEZONE_BRISBANE 65 布里斯班
HWM_TIMEZONE_CANBERRA 66 堪培拉,墨尔本,悉尼
HWM_TIMEZONE_GUAM 67 关岛,莫尔兹比港
HWM_TIMEZONE_HOBART 68 霍巴特
HWM_TIMEZONE_VLADIVOSTOK 69 符拉迪沃斯托克
HWM_TIMEZONE_SOLOMON 70 所罗门群岛,新喀里多尼亚
HWM_TIMEZONE_AUCKLAND 71 奥克兰,惠灵顿
HWM_TIMEZONE_FIJI 72 富士,堪察加半岛,马绍尔群岛
HWM_TIMEZONE_NUKUALOFA 73 努库阿洛法
HWM_TIMEZONE_IRKUTSK 74 伊尔库茨克
HWM_TIMEZONE_CASABLANCA 75 卡萨布兰卡
HWM_TIMEZONE_BAKU 76 巴库
HWM_TIMEZONE_MAGADAN 77 马加丹
表7 ConfAllowJoinUserType枚举说明
枚举名称 枚举值 枚举说明
CONF_ALLOW_JOIN_ANYONE 0 所有用户。
CONF_ALLOW_JOIN_LOGINED_USER 1 已登录用户。
CONF_ALLOW_JOIN_IN_COMPANY_USER 2 企业内用户。
CONF_ALLOW_JOIN_INVITED_USER 3 被邀请用户。
表8 VmrConfIdType枚举说明
枚举名称 枚举值 枚举说明
HWM_VMR_CONF_ID_TYPE_FIXED 0 云会议室的会议ID类型是固定类型。
HWM_VMR_CONF_ID_TYPE_RANDOM 1 云会议室的会议ID类型是随机类型。
表9 AttendeeBaseInfo
参数名称 是否必选 参数类型 参数说明
nickName Y string 与会者名称。
number Y string 号码。如果填分配给账号的sip号码(如+99111244216210249)则呼叫该账号的App; 如果填PSTN号码(如18700000000),则通过VoIP网关呼叫该号码,前提是该企业已开通PSTN呼叫权限。 与thirdUserId二选一,账号密码鉴权时使用。
thirdUserId Y string 第三方用户ID。与number二选一,App ID鉴权时使用。
accountId N string 华为云会议账号
email N string 电子邮箱地址,用于发送邮件通知。
sms N string 短信通知手机号码,用于发送短信通知。
isAutoInvite N boolean 是否自动外邀。
isMute N boolean 是否闭音。
role N ConfRole 会议角色。
type N AttendeeType 成员类型
userUuid N string 与会者uuid
表10 ConfRole枚举说明
枚举名称 枚举值 枚举说明
HWM_CONF_ROLE_ATTENDEE 0 普通与会者
HWM_CONF_ROLE_HOST 1 主持人
HWM_CONF_ROLE_AUDIENCE 2 观众
HWM_CONF_ROLE_COHOST 3 联席主持人
HWM_CONF_ROLE_WAITING 4 等候室成员
表11 AttendeeType枚举说明
枚举名称 枚举值 枚举说明
ATTENDEE_TYPE_NORMAL 0 语音、高清、标清与会者地址
ATTENDEE_TYPE_TELEPRESENCE 1 智真与会者地址类型,单屏、三屏智真均属此类
ATTENDEE_TYPE_TERMINAL 2 会议室或硬终端
ATTENDEE_TYPE_OUTSIDE 3 外部与会人
ATTENDEE_TYPE_CUSTOMNUMBER 4 custom number
ATTENDEE_TYPE_MOBILE 5 软终端用户手机
ATTENDEE_TYPE_ANONYMOUS 6 匿名用户
ATTENDEE_TYPE_TELEPHONE 7 电话用户
ATTENDEE_TYPE_BOARD 8 白板用户
ATTENDEE_TYPE_IDEAHUB 9 海思芯片的大屏设备
ATTENDEE_TYPE_HWVISION 10 智慧屏
ATTENDEE_TYPE_WELINKC 11 welink大众版
表12 ConfResType枚举说明
枚举名称 枚举值 枚举说明
HWM_CONF_RESTYPE_DEFAULT 0 默认
HWM_CONF_RESTYPE_SHARE_VMR 3 共享vmr
表13 SummaryState枚举说明
枚举名称 枚举值 枚举说明
SUMMARY_STATE_CLOSE 0 会议纪要关闭
SUMMARY_STATE_OPEN 1 会议纪要开启
表14 AutoMuteType枚举说明
枚举名称 枚举值 枚举说明
AUTO_MUTE_TYPE_DEFAULT 0 默认
AUTO_MUTE_TYPE_MUTE 1 静音
AUTO_MUTE_TYPE_UNMUTE 2 非静音
表15 CycleConfParam
参数名称 是否必选 参数类型 参数说明
startDate Y number 开始日期-时间戳,精度秒(0时区)
endDate Y number 结束日期-时间戳,精度秒(0时区)
cycleType Y CycleType 周期类型
interval Y number 周期区间 1、周期类型选择了按天,表示每几天召开一次,取值范围[1,15];2、周期类型选择了Week,表示每几周召开一次,取值范围[1,5];3、周期类型选择了Month,interval表示隔几月,取值范围[1,3]
listPoints Y string 周期内的会议召开点。仅当按周和月时有效。数据格式(中间用逗号隔开):1,3,5,7
preRemindDays Y number 周期子会议提前通知天数。
表16 CycleType枚举说明
枚举名称 枚举值 枚举说明
CYCLE_TYPE_DAY 0 以天为周期
CYCLE_TYPE_WEEK 1 以周为周期
CYCLE_TYPE_MONTH 2 以月为周期

返回值

void

回调方法参数说明:

(ret: SDKERR, reason: string, confDetail: ConfDetail) => void

表17 入参说明
参数名称 参数类型 参数说明
ret SDKERR 请参考错误码参考 错误码
reason string 错误描述
confDetail ConfDetail 会议详情
表18 ConfDetail
参数名称 参数类型 参数说明
confListInfo ConfListItem 会议基本信息
vmrId string 云会议室唯一ID。
vmrFlag boolean 是否是vmr会议。
isAutoRecord boolean 是否开启自动录制会议。
allowRecord boolean 是否支持录制会议
allowLive boolean 保留。编辑会议时透传会议详情此字段
needPassword boolean 是否需要密码。
isSendSms boolean 是否发送短信通知。
isSendEmail boolean 是否发送邮件通知。
isSendCalendar boolean 是否发送日历通知。
confAllowJoinUser ConfAllowJoinUserType 会议准入设置。
numOfAttendee number 与会者列表长度。
attendees AttendeeBaseInfo 与会者列表。
isOpenWaitingRoom boolean 是否开启等候室
allowGuestStartConf boolean 允许来宾启动会议
allowGuestStartConfTime number 允许来宾提前入会时间范围(单位:分钟) 0-随时,n-提前n分钟启动会议
vmrConfIdType VmrConfIdType 云会议室的会议ID类型
concurrentParticipants number 会议方数,会议最大与会人数限制. 0: 无限制, 大于0: 会议最大与会人数
defaultSummaryState SummaryState 会议云录制是否包含纪要,初始值(周期会议暂不支持)(仅对win平台生效)
autoMuteMode AutoMuteType 软终端是否自动静音
hardTerminalAutoMuteMode AutoMuteType 硬终端是否自动静音
表19 ConfListItem
参数名称 参数类型 参数说明
confId string 会议ID。
subject string 会议主题。
hostPwd string 主持人密码。
guestPwd string 来宾密码。
audiencePwd string 观众密码。(仅对win平台生效)
startTime number 会议开始时间(utc时间),单位秒。
endTime number 会议结束时间(utc时间),单位秒。
timezone Timezone 时区码(仅对win平台生效)
mediaType MediaType 媒体类型
schedulerName string 会议预定者名称。
vmrConfId string 用于云会议显示的ID。
hostJoinUri string 主持人加入会议uri链接
guestJoinUri string 来宾加入会议uri链接
audienceJoinUri string 观众加入会议的链接(仅对win平台生效)
confStateType ConfState 会议状态(仅对win平台生效)
isWebinar boolean 是否是网络研讨会(仅对win平台生效)
selfConfRole ConfRole 本人在会议中的角色
conferenceType ConferenceType 会议类型
cycleParam CycleConfParam 周期会议的参数
subConfSize number 周期子会议数量
subConfParam SubCycleConfParam 周期子会议参数
customInfo string 用户自定义信息。
表20 ConfState枚举说明
枚举名称 枚举值 枚举说明
HWM_CONF_STATE_SCHEDULE 0 预定状态。
HWM_CONF_STATE_CREATING 1 正在创建状态。
HWM_CONF_STATE_GOING 2 会议已经开始。
HWM_CONF_STATE_DESTROYED 3 会议已经关闭。
表21 ConferenceType枚举说明
枚举名称 枚举值 枚举说明
HWM_CONF_TYPE_COMMON 0 普通会议
HWM_CONF_TYPE_CYCLE 1 周期会议
表22 CycleConfParam
参数名称 参数类型 参数说明
startDate number 开始日期-时间戳,精度秒(0时区)
endDate number 结束日期-时间戳,精度秒(0时区)
cycleType CycleType 周期类型
interval number 周期区间 1、周期类型选择了按天,表示每几天召开一次,取值范围[1,15];2、周期类型选择了Week,表示每几周召开一次,取值范围[1,5];3、周期类型选择了Month,interval表示隔几月,取值范围[1,3]
listPoints string 周期内的会议召开点。仅当按周和月时有效。数据格式(中间用逗号隔开):1,3,5,7
preRemindDays number 周期子会议提前通知天数。
表23 SubCycleConfParam
参数名称 参数类型 参数说明
subConfID string 子会议唯一标识UUID
mediaType MediaType 媒体类型
startTime number 会议起始时间
endTime number 会议结束时间
isAutoRecord boolean 会议开始后是否自动开启录制
recordAuthType RecordAuthType 录播鉴权方式
confAllowJoinUser ConfAllowJoinUserType 允许入会范围限制。默认所有用户。
allowGuestStartConf boolean 允许来宾启动会议
allowGuestStartConfTime number 允许来宾提前入会时间范围(单位:分钟) 0-随时,n-提前n分钟启动会议
表24 RecordAuthType枚举说明
枚举名称 枚举值 枚举说明
REOCRD_AUTH_TYPE_ANYONE 0 可通过连接观看/下载(不拼接nonce)
REOCRD_AUTH_TYPE_IN_COMPANY_USER 1 企业用户可观看/下载
REOCRD_AUTH_TYPE_ATTENDEE 2 与会者可观看/下载
表25 AttendeeBaseInfo
参数名称 参数类型 参数说明
nickName string 与会者名称。
number string 号码。如果填分配给账号的sip号码(如+99111244216210249)则呼叫该账号的App; 如果填PSTN号码(如18700000000),则通过VoIP网关呼叫该号码,前提是该企业已开通PSTN呼叫权限。 与thirdUserId二选一,账号密码鉴权时使用。
thirdUserId string 第三方用户ID。与number二选一,App ID鉴权时使用。
accountId string 华为云会议账号
email string 电子邮箱地址,用于发送邮件通知。
sms string 短信通知手机号码,用于发送短信通知。
isAutoInvite boolean 是否自动外邀。
isMute boolean 是否闭音。
role ConfRole 会议角色。
type AttendeeType 成员类型
userUuid string 与会者uuid