文档手册

视频模板：点播、直播与媒体通道

从模板库插入视频模板，在 Template Edit 中选择播放类型和接入方式。媒体必须能够由运行端访问；播放地址与宿主媒体通道编码有不同用途。

视频文档修订：2026-10-21

视频: 视频模板：点播、直播与媒体通道

从模板库插入视频模板，在 Template Edit 中选择播放类型和接入方式。媒体必须能够由运行端访问；播放地址与宿主媒体通道编码有不同用途。

1. 选择播放类型

Video Type 选择 Video File / Recording (Seekable) 或 Camera / Live Video。点播提供时长、进度和播放速度；直播提供实时状态、返回实时位置和重连。HLS 与 DASH 均可能承载点播或直播，应按媒体服务的实际类型选择。

在 Position and Size 设置 X、Y、Width、Height。
点播可配置 Autoplay When Opened (Muted) 和 Loop Playback。
直播自动静音连接，不使用文件循环或倍速配置。
粘贴新地址不会自动更改已选播放类型。

2. 点播文件与部署位置

在 File or Playback URL 中填写运行端可访问的 HTTP / HTTPS 媒体直链，例如 https://media.example.com/training/pump-operation.mp4。网站播放页不是媒体直链。Browse… 选中的本地文件不会复制进画面包，并会阻止导出。导出前应将有权使用的媒体部署到运行端可访问的位置，再把此字段改为 HTTP(S) 媒体地址。

3. 使用 Mingcedar 媒体通道

选择 Camera / Live Video，再将 Playback Source 设为 Host Camera (Configure or Select)。点击 Configure / Select Camera… 配置、检查并选择摄像头，或将已有摄像头的 Code 填入 Channel Code。通道显示名称不能代替编码。

Channel code 示例：camera_line01。
也可填写 hqmedia://camera_line01，编辑器按同一通道引用保存。
模板无需填写宿主 IP；发布到其他宿主时，应配置相同编码的通道。
摄像头 RTSP / RTMP 地址和凭据在宿主配置，不写入公开模板示例。

4. 使用媒体直链

已有浏览器可播放的直播地址时，将 Playback Source 设为 Direct HTTP(S) Playback URL，在 HTTP(S) Playback URL 中填写实际媒体地址。支持范围包括 HLS、MPEG-DASH、HTTP-FLV、WHEP、MJPEG 及浏览器原生可播放媒体，实际可用性仍取决于服务、编码、浏览器和网络。

示例地址：https://media.example.com/line01/live.m3u8。
摄像头管理页、RTSP 和 RTMP 地址不能作为浏览器媒体直链填写。
HTTPS 运行页应使用 HTTPS 媒体地址，并满足跨域访问要求。
示例域名仅用于说明格式，请使用项目授权媒体服务的实际地址。

5. 发布后检查

在目标 Mingcedar 中检查初次播放、离开页面后返回、网络中断后恢复和画面显示。运行时在离开页面时释放播放器连接，返回时重新建立。出现失败时，记录播放器提示、通道状态和媒体请求结果，检查地址有效期、证书、网络和编码支持。

在插件中配置或选择摄像头

选择 Camera / Live Video，将接入方式设为 Host Camera (Configure or Select)，点击 Configure / Select Camera… 打开 Camera Configuration。已有通道可直接填写 Channel Code，也可以在此窗口选择。

填写 Host Address、Host Username、Host Password，以宿主管理员账号点击 Connect and Load Cameras。宿主地址、登录密码和会话只供本窗口使用，不写入 PPT 或导出文件。
选择已有摄像头只读取配置。New Camera 新建；Camera Code 为 1–64 个字母、数字、下划线或连字符，首字符须为字母或数字，保存后不能改编码。
Camera Source URL 填设备 RTSP、RTMP 或 HTTP(S) 媒体地址；这与模板的浏览器直链字段不同。Camera URL Assistant 可按预设、RTSP/RTSPS、地址、端口、设备通道与主/子码流拼接地址；仍须核对实际设备格式。
Enable Camera 控制启用；Connect Only While Viewing 控制按需连接。Save to Host 保存，Apply and Check 应用并检查，Preview in Browser 打开预览，Refresh 重新读取宿主状态。

摄像头凭据与保存边界

Camera Credentials 是摄像头登录凭据，与 Host Username / Password 分开。先保存摄像头，再保存 Camera Credentials，随后再次 Save to Host 才把凭据绑定到该摄像头。PPT 只记录通道引用。

宿主配置通过 Save to Host、Apply and Check、Delete Camera 等操作即时生效；取消模板编辑不会撤销已经提交的宿主更改。
Use Selected Camera 把当前编码带回模板；最后在模板编辑器点击 Save，才把引用写入 PPT。
Delete Camera 删除宿主配置，使用前先核对编码及影响范围。Back 返回，Sign Out 退出宿主会话。
Cancel Wait 只停止等待，不等于撤销请求。结果不确定时先 Refresh 并确认实际状态；窗口要求确认已复核结果后再继续修改，避免重复提交。