cockpit-video-panel-design-b.md 3.5 KB

监控面板方案 B:结构与验证边界

设计落地

  • 色板:深蓝底 #062b3f / #0a3a52,青蓝强调 #35d6e8;画面内部不加发光、蒙版或装饰动画。
  • 设备信息:标题与六项业务字段在顶栏;长编码、位置自动换行,主键不充当业务编码。
  • 桌面:220px 左侧云台面板 + 右侧 16:9 画面。八向圆形控制盘、中心停止、STEP 预设速度、变倍 ±、聚焦 ± 常驻。
  • 工具条:与画面放在同一个 surface,模式、当前模式状态、静音、音量、全屏在画面下方。历史暂停/继续/五种倍速/跳转也在 surface 内。
  • 历史:查询区与最多 180px 高的录像清单在右侧工具条下方,清单内部滚动,不无限推走画面。UTC+8 文本查询,选择片段才建流。
  • 跳转滑杆表示用户选择的秒偏移,不冒充来自设备的实时播放进度;输入与滑杆共同受所选录像时长限制,最终仍通过既有会话层校验。
  • 小屏:640px 以下改为纵向,云台布局压缩但不隐藏;900px 以下收紧两栏间距。模态整体可滚动。
  • 可访问性:控件语义名称、禁用原因、可见焦点、包含输入/结果区的焦点循环,Escape 关闭;减少动画偏好下关闭圆盘呼吸光。

入口与指标分区

“监控面板入口”放在既有最新指标卡片内部,使用相同色板与摄像机标识,状态“可查看”只描述视频入口能力,不假装设备在线。

摄像机类型由当前设备档案 type=20 或同业务编码的已加载 typeCode=20 确认;采集记录失败/不可用不再显示为摄像机的指标错误,改中性说明。视频能力查询本身失败、未绑定或实时能力未开放仍显示真实原因。非摄像机的错误、记录和值照旧。

呈现控制与安全

沿用捆绑 Jessibuca 3.3.27,不更换 SDK。FLV 启用音频解码但默认静音,静音/音量只调用 mute、audioResume、setVolume,不重新建会话或重播;真实声音仍取决于流包含音轨及浏览器音频许可。全屏目标为整个 surface(画面及工具条),关闭 SDK 自带重复控制栏;不支持/拒绝全屏仅报呈现错误。

SDK 每代独占一个内部 div;异步销毁及过期事件不得破坏后续容器。原生分支清理后恢复当前 src,仍默认静音,不提供原生暂停/seek/下载入口。

父规格明确本期云台仅 UI,所有物理动作保持禁用,包括能力标记为 true 但没有完整命令与停止接缝时。不能以布尔开关把无动作按钮伪装成真实控制;后续物控另行实施与确证。

验证边界

本轮运行的是既有视频旅程、三宿主与会话/传输/重连/回放离线回归,不是实际媒体解码或浏览器版式验收。Vue SFC 由离线测试接缝解析;未安装独立 vue-tsc/typecheck 命令,不声称完整类型检查通过。

遵照 AGENTS.md,本轮不运行应用 build/dev/server,也不执行浏览器调试或截图。以下实景核对尚待明确授权或票 13 验收:

  • 在既有 localhost:8000 检查桌面/窄屏版式,长设备名、编码和 17+ 条录像清单。
  • 真实实时与已有录像出画,画面不变形,工具条全屏后仍可操作。
  • 有音轨的流取消静音与音量实际生效;无音轨或权限限制不伪称可听见。
  • 无云台设备圆盘与镜头组全部禁用、无物理命令。
  • 监控入口文案与摄像机中性指标提示,非摄像机真实错误不被隐藏。