创建会议接口 (createMeeting)
用于发起一场多方音视频会商。支持传入会议主题、访问密码及初始参会成员配置。创建成功后,SDK 会自动将入会成员的视频流渲染上屏。
SDK 方法调用说明
SDK 调用方法签名:
const result = await sdk.createMeeting(options);
对应后台接口端点:
POST /dispatch-web/api/meet/createMeet
SDK 调用代码示例 (JavaScript Demo)
// 发起并创建多方视频会商
const res = await sdk.createMeeting({
// 会议主题名称
name: "防汛应急调度视频会商",
// 会议媒体类型:"video" (音视频) | "audio" (纯音频)
mediaType: "video",
// 业务流水号/工单ID(可选)
businessId: "biz-case-20260828",
// 会议访问密码(可选,不填由系统随机生成)
meetAccess: "20268888",
// 初始参会成员列表
members: [
{
tel: "142001", // 成员号码
level: "chairman", // 席位权限:主席
autoAnswer: true // 自动接通入会
},
{
tel: "1000021",
level: "speak", // 发言人
autoAnswer: true
},
{
tel: "1000022",
level: "audience", // 听众
autoAnswer: true
}
]
});
console.log("创建会议成功,会议 ID:", res.meetId);
入参字段详细说明
| 参数名称 | 字段类型 | 是否必填 | 默认值 | 详细说明 |
|---|---|---|---|---|
name | string | 是 | - | 会议主题名称(支持中英文,如 "应急指挥联合会商") |
mediaType | string | 否 | "video" | 会议媒体类型:"video"(音视频会商)或 "audio"(纯音频会议) |
members | object[] | 否 | [] | 初始参会成员配置数组(含 tel, level, autoAnswer) |
businessId | string | 否 | "" | 业务流水号/工单ID,用于业务系统关联追溯 |
meetAccess | string | 否 | 随机8位 | 会议访问密码/入会验证码 |
isSave | boolean | 否 | false | 是否永久保存为模板会议 |
回参说明 (Response Demo)
{
"code": 0,
"message": "success",
"meetId": "1057",
"meetName": "防汛应急调度视频会商",
"mediaType": "video",
"meetAccess": "20268888",
"members": [
{ "tel": "142001", "level": "chairman", "state": "joined" },
{ "tel": "1000021", "level": "speak", "state": "joining" },
{ "tel": "1000022", "level": "audience", "state": "joining" }
]
}
常见错误码
| 错误码 Code | 错误描述 | 解决方案 |
|---|---|---|
DISPATCH_NOT_FOUND | 调度核心未找到 | 请先加载 scooper.dispatch 并成功调用 await sdk.init() |
NAME_REQUIRED | 会议主题不能为空 | 检查 name 字段是否传入了有效字符串 |
REQUEST_TIMEOUT | 会议创建信令响应超时 | 检查网络连接与调度后台服务状态 |