| 项 | 说明 |
|---|---|
| 回放本质 | App 用 Web 组件打开业务 H5,H5 内接入播放器 SDK |
| 播放器版本 | ≥ 1.72.402,见《历史课堂回放/播放器/00-概述》《历史课堂回放/播放器/03-移动端WebView嵌入》 |
| 接入性质 | 按需能力 |
| 层级 | 负责内容 |
|---|---|
| Harmony App | 创建并配置 Web;向业务服务端取 recordId 对应的播放器 query;加载业务播放页 URL;约定 JS Bridge(加载成功 / 失败 / 退出);尺寸变化时通知 H5 调 player.resize();销毁时释放 Web |
| 业务 H5 | 按《历史课堂回放/播放器》做 URL 或 jssdk 接入;实现 getExtFileName / getPreParseFileName;调用 play / destroy |
| 业务服务端 | 签发 appType=player 的 query;按 info / info+suffix 签发短时资源 URL |
recordId(通常来自历史课堂数据回调);info 插入的私有/预解析资源:H5 必须用 jssdk,并接好资源 URL 接口;ohos.permission.INTERNET。| 课堂内容 | H5 接入 |
|---|---|
无插入资源,或插入资源均为可直达的 url | 可用 URL 接入 |
含以 info 插入的普通私有资源 | 必须 jssdk + getExtFileName |
| 含预解析资源 | 必须 jssdk + getPreParseFileName |
Web 组件加载业务播放页 HTTPS 地址;按需开启 JavaScript、允许媒体相关能力;javaScriptProxy / runJavaScript 等与 H5 约定 ready / error / exit;player.resize();destroy(),再释放 Web 控制器;// 伪代码:先向业务服务端换取 appType=player 的签名 query,再加载业务播放页
const pageUrl = `https://your-business.com/player?${playerQuery}`;
Web({ src: pageUrl, controller: this.webController })
.javaScriptAccess(true)
.domStorageAccess(true)
.onPageEnd(() => {
// 可选:向 H5 注册 bridge,或确认播放器已初始化
})
.width('100%')
.height('100%');
// aboutToDisappear / 返回时:通知 H5 destroy,再释放 controllerrecordId 生成包含 appType=player、validBegin、validTime、signature 等字段的播放器 query;info 资源、预解析 info + suffix 按权限签发短时 URL;info 插入资源(或仅有 url 资源)的历史课堂可播放。getExtFileName。getPreParseFileName。resize)。recordId 与资源 ID。