伯索开放平台
首页API文档SDK文档
伯索官网
首页API文档SDK文档
伯索官网
  1. Web
  • SDK 接入总览
  • 实时课堂
    • Android 实时课堂接入
    • Harmony 实时课堂接入
    • iOS 实时课堂接入
    • Electron 实时课堂接入
    • Web 实时课堂监课接入
  • 极速课堂
    • Android 极速课堂接入
    • Harmony 极速课堂接入
    • iOS 极速课堂接入
    • Electron 极速课堂接入
  • 微课
    • Android 微课接入
    • Harmony 微课接入
    • iOS 微课接入
    • Electron 微课接入
  • 资料中心
    • Android 资料中心接入
    • Harmony 资料中心接入
    • iOS 资料中心接入
    • Electron 资料中心接入
    • Web 资料中心接入
  • 文件预解析
    • Android 文件预解析接入
    • Harmony 文件预解析
    • iOS 文件预解析接入
    • Electron 文件预解析接入
  • 历史课堂回放
    • Android 历史课堂回放
    • Harmony 历史课堂回放
    • iOS 历史课堂回放
    • Electron 历史课堂回放
    • 播放器
      • 播放器 SDK 概述
      • 播放器 SDK 快速开始
      • 播放器 SDK 初始化与配置
      • 播放器 SDK 历史课堂回放
      • 播放器 SDK 移动端 WebView 嵌入
      • 播放器 SDK API 参考
      • 播放器 SDK 事件
      • 播放器 SDK 错误码
      • 播放器 SDK 常见问题
  • 云学堂模块化SDK
    • 云学堂模块化 SDK 概述
    • 云学堂模块化 SDK · Android 接入
    • 云学堂模块化 SDK · iOS 接入
    • 云学堂模块化 SDK · Harmony 接入
    • 云学堂模块化 SDK · PC 接入
    • 伯索云学堂跳转接入
  • 接入基础(Electron & Web)
    • Web
      • Web 概述
      • Web 快速开始:URL 接入监课
      • Web 初始化与配置(监课)
      • Web API 参考(监课)
      • Web 事件与回调(监课)
      • Web 错误码(监课)
      • Web 常见问题(监课)
    • Electron
      • Electron 概述
      • Electron 快速开始
      • Electron 初始化与配置
      • Electron API 参考
      • Electron 事件与回调
      • Electron 错误码
      • Electron 常见问题
  • 服务端接口与协议
    • 服务端接口与协议阅读顺序
    • 签名与鉴权
    • 签名示例
    • query 参数
    • 资料中心与文件 URL
    • 文档预解析
    • 课堂进行中数据回调
    • 课堂结束数据回调
    • 历史课堂转视频与下载
  1. Web

Web 快速开始:URL 接入监课

适用版本:≥ 1.68.110
本文用最少步骤完成公共的 URL 接入监课。完整参数见 初始化与配置。监课身份差异、极速课堂监课所需的 d_lowLatencyClass=1,以及可选的 jssdk 嵌入,见对应功能模块:
实时课堂/Web
资料中心/Web(仅当课堂含以 info 方式插入的资源时)
三步完成监课:服务端签名 → 拼 URL → 浏览器打开。
请使用 PC 端 Chrome 100 及以上版本(推荐最新版);手机端不支持监课。

1. 服务端生成监课 query 并签名#

按《服务端接口与协议/签名与鉴权》生成签名:去掉 signature 后,参数名按 UTF-8 字节序升序,用未编码的原值拼成 key=value,以 & 连接,再用 appKey 做 HMAC-SHA1,输出 40 位大写 Hex。可核对的进房示例见《签名示例》。
签名原文示例(已排序,使用未编码的原值,如 userName=督导A):
appId=your-app-id&appType=liveclassSDK&d_dimension=1280x720&loginName=monitor_001&mediaType=video&meetingId=class-001&meetingType=public&userName=督导A&userType=monitor&validBegin=1760331600&validTime=10800
💡 建议监课签名有效期至少保持到课堂结束:validBegin + validTime 不早于课堂结束时间。签名过期后需重新获取监课 URL。
🔒 appKey 只保存在服务端,签名必须在服务端完成。

2. 拼接监课 URL#

https://wwwr.plaso.cn/static/sdk/styleupime/{version}/?{已签名 query}
示例(version 取 1.68.110):
https://wwwr.plaso.cn/static/sdk/styleupime/1.68.110/?appId=your-app-id&appType=liveclassSDK&d_dimension=1280x720&loginName=monitor_001&mediaType=video&meetingId=class-001&meetingType=public&userName=%E7%9D%A3%E5%AF%BCA&userType=monitor&validBegin=1760331600&validTime=10800&signature=XXXXXXXX
签名基于参数编码前的原值计算;签名完成后,拼接 URL 时再对每个参数值(含 signature)做 URL 编码(如中文 userName=督导A → userName=%E7%9D%A3%E5%AF%BCA)。
URL 中出现的所有参数都必须参与签名,不能在签名后追加参数。

3. 打开#

// 前端从业务后端获取完整监课 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>

4. 验证#

进入后能看到老师板书与音视频;
课堂成员列表中看不到监课人员;
签名过期后无法进入(validBegin + validTime 之外)。

5. 下一步#

完整 query 参数:初始化与配置
监课身份、与学生的差异、极速课堂监课:实时课堂/Web
课堂中以 info 方式插入的资源显示不出来时:资料中心/Web
修改于 2026-11-18 03:45:46
上一页
Web 概述
下一页
Web 初始化与配置(监课)
Built with