适用版本:≥ 1.68.110
d_lowLatencyClass=1(须参与签名)。appId、被监课堂 ID、监课人员 ID 与显示名,以及业务服务端的监课 URL / query 接口。🔒 appKey 只能保存在服务端,不能写入前端。window.open 或放入 iframe。完整 URL 格式、参数和有效期建议见 初始化与配置。info 方式插入了私有资源或预解析资源,需改用可选的 jssdk 嵌入,见 资料中心/Web 与 API 参考。appId、appType=liveclassSDK、userType=monitor、loginName、userName、meetingId、meetingType、mediaType、d_dimension、validBegin、validTime、signature。| 字段 | 说明 |
|---|---|
userType | 固定 monitor。Web SDK 不支持 speaker / assistant / listener 等其他角色。 |
appType | 固定 liveclassSDK。 |
loginName | 监课人员唯一 ID;不要与课堂成员重复(同一 loginName 重复进入会顶掉前一个)。 |
d_lowLatencyClass | 监课极速课堂时必填,固定传 1,且必须参与签名。 |
meetingId、meetingType、mediaType、d_dimension 须与上课端一致。建议签名有效期至少保持到课堂结束,详见 初始化与配置 §4。完整字段见《服务端接口与协议/query参数》。// 前端从业务后端获取完整监课 URL(业务接口,非 SDK API)
const { url } = await api.getMonitorUrl({ meetingId: 'class-001' });
window.open(url);
// 或嵌入:<iframe src="..." allow="autoplay; fullscreen" style="width:100%;height:100vh;border:0"></iframe>{ query }),没有额外的客户端配置对象。监课场景需要关注的字段如下;其余公共字段见 初始化与配置 §3。| 参数 | 类型 | 必填 | 默认值 | 说明 | 起始版本 |
|---|---|---|---|---|---|
userType | string | 是 | - | 固定 monitor | - |
appType | string | 是 | - | 固定 liveclassSDK | - |
d_lowLatencyClass | number | 监课极速课堂时必填 | - | 固定传 1,被监课堂为极速课堂时使用;须参与签名 | - |
userType=monitor、appType=liveclassSDK 并签名,打开监课 URL(或向 jssdk 传入该 query)即可。| 项 | 学生 | 监课 |
|---|---|---|
| 是否出现在成员列表 | 是 | 否 |
| 成员列表入口 | 受 d_switch 控制 | 固定显示 |
| 随堂测 / 新随堂测 | 可作答提交 | 仅查看题目 |
| 口语测评 | 录音评分 | 仅显示“测评中...” |
| 签到 | 必须签到 | 不签到,可关闭签到弹窗 |
| 新手引导 | 显示 | 不显示 |
onExit,SDK 自动 destroy()。url 方式插入的资源:URL 接入即可正常显示;info 方式插入的私有资源 / 预解析资源:必须改用 jssdk,并实现 getExtFileName / getPreParseFileName。userType=monitor、appType=liveclassSDK,签名通过。d_lowLatencyClass=1 且该字段已参与签名。info 方式插入的资源(私有 / 预解析资源),已改用 jssdk 并实现资源回调。