跳到主要内容

3分钟快速上手

只需简单三步，即可在第三方 Web 应用中快速调起视频会商与调度能力。

第一步：安装或引入 SDK​

方式 A：现代 NPM 工程 (推荐)​

npm install @scooper/meeting-sdk
import ScooperMeetingSDK from "@scooper/meeting-sdk";

方式 B：由 SDK 动态自动加载依赖 (静态 HTML 页面推荐)​

await ScooperMeetingSDK.loadDependencies({
  dispatchBaseUrl: "/dispatch-web/",
  videoScript: "/scooper-video-player/scooper.video.min.js",
  softHandler: true,
  softHandlerScript: "/vendor/sc-soft-handler/index.umd.js"
});

第二步：初始化并连接​

// 1. 创建 SDK 实例（会商、点呼、软手柄全功能一体化）
const sdk = ScooperMeetingSDK.create({
  dispatch: {
    remoteBaseUrl: "/dispatch-web/",                    // 调度后台服务地址
    token: () => sessionStorage.getItem("Sc-Token")    // 鉴权 Token
  },
  video: {
    container: "#video-grid-host",                     // 视频多路网格挂载节点
    windowsNum: 4                                      // 初始四分屏
  },
  softHandler: {
    enabled: true                                      // 开启软手柄双向通话
  },
  callbacks: {
    onMeetingStatus: (meet) => console.log("会商状态变动:", meet),
    onMeetingMember: (mem) => console.log("成员变动通知:", mem),
    onError: (err) => console.error("SDK 异常:", err)
  }
});

// 2. 异步执行初始化连接
await sdk.init();

第三步：发起多方视频会商或呼叫​

// 创建并邀请成员入会（SDK 会自动分配空闲视窗并拉流上屏）
const result = await sdk.createMeeting({
  name: "应急指挥联合会商",
  mediaType: "video",
  members: [
    { tel: "142001", level: "chairman", autoAnswer: true }, // 主席
    { tel: "1000021", level: "speak", autoAnswer: true }    // 发言人
  ]
});

console.log("会议创建成功，会议号:", result.meetId);