全局错误码速查手册 (SDKError)

所有 SDK 方法在入参校验失败或网络异常时，均统一 reject ScooperMeetingSDK.SDKError 实例。

---

错误捕获标准范式

try {
  await sdk.createMeeting({ name: "" });
} catch (err) {
  if (err instanceof ScooperMeetingSDK.SDKError) {
    console.error("错误码:", err.code);
    console.error("错误原因:", err.message);
  } else {
    console.error("系统未知异常:", err);
  }
}

---

核心错误码速查对照表

错误码 Code	中文含义说明	常见原因及排查指南
DISPATCH_NOT_FOUND	调度核心未找到	会议/呼叫模式需要先加载 scooper.dispatch，并成功调用 await sdk.init()
VIDEO_CONTAINER_NOT_FOUND	视频挂载容器不存在	检查 video.container 传入的 DOM 选择器在页面中是否存在
SOFT_HANDLER_REGISTER_FAILED	软手柄注册失败	检查当前分机号 SIP 端口、鉴权密码，排查 408/401 报错
MEET_ID_REQUIRED	缺少会议 ID	调用会中接口时必须传入有效的 meetId
TELS_REQUIRED	缺少号码参数	呼叫或通知接口中必须传入非空的号码列表
REQUEST_TIMEOUT	调度信令响应超时	检查网络连通性及调度后台服务运行状态
FINAL_RESULT_TIMEOUT	业务终态等待超时	点名或组呼通知已收到请求响应，但在 finalResultTimeout 内未收到匹配的 dispatch:responseData 终态包

alreadyInMeeting: true 是成功返回字段，不是错误码：成员已经在会中时，joinMeeting/playMeetingVideo 会返回成功结果并派发 meeting:alreadyInMeeting。

SDK 还会使用 TOKEN_REQUIRED、LOGIN_FAILED、REQUEST_FAILED、JOIN_NOTIFY_TIMEOUT、VIDEO_CTOR_NOT_FOUND、SOFT_HANDLER_FACTORY_NOT_FOUND 等错误码。完整错误分类和同步/异步抛错边界见 SDK 完整 API 参考。