伯索开放平台
首页API文档SDK文档
伯索官网
首页API文档SDK文档
伯索官网
  1. 播放器
  • 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. 播放器

播放器 SDK 初始化与配置

适用版本:≥ 1.72.402

1. 接入前准备#

项说明
recordId历史课堂 ID
播放器 query服务端按 appType=player 生成签名 query(🔒 签名在服务端完成)
播放容器jssdk 接入时挂载的 DOM,创建播放器时必须传入
资源 URL 接口播放含以 info 方式插入的资源(私有资源 / 预解析资源)时需要

2. 资源地址#

资源地址
URL 接入https://wwwr.plaso.cn/static/sdk/styleupime/{version}/?{query}
jssdk JShttps://wwwr.plaso.cn/static/sdk/js/plaso_upime_player-{version}.js
jssdk CSShttps://wwwr.plaso.cn/static/sdk/js/plaso_upime_player-{version}.css

3. query 参数(播放器相关)#

参数类型必填默认值说明起始版本
appIdstring是-机构 appId-
appTypestring是-固定 player-
recordIdstring是-历史课堂 ID-
validBegin / validTimenumber是-签名有效期(Unix 秒)-
signaturestring是-签名-
showTypenumber否-1 仅头像,2 仅白板,40 头像+白板1.60.131
avatarHeightnumber否-showType=40 时生效,最小 90;大于播放器高度按播放器高度1.60.131
展示参数同样需参与签名。完整字段见《服务端接口与协议/query参数》。

4. 构造与 setSrc#

const player = new PlasoUpimePlayer(dom: HTMLElement);   // dom 必填:播放器挂载的容器元素
await player.setSrc(query: string, option?: SetSrcOption);
⚠️ 每个实例只能调用一次 setSrc,重复调用抛出 DOMException('already set src');切换课堂请 destroy() 后新建实例。

SetSrcOption#

参数类型必填默认值说明起始版本
getFileName(fileName: string, isPublic: boolean) => Promise<string>否-历史课堂存储于客户自有 OSS 时使用;isPublic=true 表示期望无签名公开地址-
pathstring否-与 getFileName 配合,作为相对路径前缀-
getExtFileName(info: any[]) => Promise<string>否-含以 info 方式插入的普通资源时必填-
getPreParseFileName(info: any[], option: { suffix: string }) => Promise<string>否-含预解析资源时必填1.60.116
修改于 2026-11-18 03:45:46
上一页
播放器 SDK 快速开始
下一页
播放器 SDK 历史课堂回放
Built with