跳到主要内容
POSTsdk.createMeeting去调试

创建会议接口 (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);

入参字段详细说明

参数名称字段类型是否必填默认值详细说明
namestring-会议主题名称(支持中英文,如 "应急指挥联合会商")
mediaTypestring"video"会议媒体类型:"video"(音视频会商)或 "audio"(纯音频会议)
membersobject[][]初始参会成员配置数组(含 tel, level, autoAnswer
businessIdstring""业务流水号/工单ID,用于业务系统关联追溯
meetAccessstring随机8位会议访问密码/入会验证码
isSavebooleanfalse是否永久保存为模板会议

回参说明 (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会议创建信令响应超时检查网络连接与调度后台服务状态