本页目录
概述
实时监测主要用于查看任务执行过程中的位置变化、状态变化、直播画面和遥测更新。
实时监测页重点包括：
- 连接与状态监控：WebSocket 连接状态、执行状态迁移、预检结果、任务进度。
- 实时指标卡片：速度、高度、电量、返航距离。
- 无人机直播 / 机巢直播 / 地图航线：飞行器画面、机巢视角、航线与当前位置的空间关系。
- 实时点位与实时事件：遥测点位流与事件流。
- 直播控制页面：人工接管、急停、返航等应急控制与多相机切换。
提示
💡 与历史回放的分工：实时监测用于查看当前执行状态（执行中）；历史回放用于任务结束后的复盘（已完成/失败）。二者时机互斥、互补。
一、 实时直播页签的显示条件
当前详情页不会在所有状态下都显示实时直播页签。在现有实现里，只有执行状态满足实时监控场景时，才会显示这个页签。
| 条件 | 页签表现 |
|---|---|
| 执行已进入实时阶段 且 机巢信息就绪 | 显示实时直播页签，内容正常刷新。 |
| 页面未进入实时阶段 | 实时页签不显示。 |
| 机巢信息暂未就绪 | 实时页签不显示或显示为空状态。 |
二、 直播监控卡片（连接与状态）
进入实时页后，先看顶部的 直播监控 卡片，它集中显示监测链路与执行态势：
| 监控项 | 业务含义 |
|---|---|
| 连接状态 | 当前 WebSocket 是否还在正常接收消息。 |
| 执行状态迁移 | 显示执行状态从什么阶段变到什么阶段。 |
| 预检结果 | 显示预检是否通过，以及是否存在厂商侧原因。 |
| 任务进度 | 显示当前执行进度、阶段和步骤。 |
| 最后消息时间 | 用于判断页面是否持续收到新数据。 |
提示
⚠️ 连接状态异常时的联动排查：连接状态异常时，需要同时检查点位、事件和视频画面，以判断是链路中断还是单一数据源缺失。
三、 实时指标卡片
监控卡片下方显示一组实时遥测指标：
| 指标 | 业务含义 |
|---|---|
| 速度 | 飞行器当前飞行速度。 |
| 高度 | 飞行器当前高度。 |
| 电量 | 飞行器当前剩余电量。 |
| 返航距离 | 飞行器当前位置到返航点的距离。 |
四、 直播与地图联动
实时页中间区域由三块内容组成，作用各不相同：
| 视图 | 业务作用 |
|---|---|
| 无人机直播 | 看飞行器当前画面（主视角）。 |
| 机巢直播 | 看机巢视角或辅助画面（起降监控）。 |
| 地图航线 | 看航线和当前位置的空间关系（轨迹叠加）。 |
五、 实时点位与实时事件
页面底部还有两张列表卡片，提供流式遥测与事件：
| 列表 | 关键字段 | 业务作用 |
|---|---|---|
| 实时点位 | 时间、坐标、高度、速度、电量 | 追踪飞行器位置与遥测的连续变化。 |
| 实时事件 | 事件时间、事件类型、摘要 | 追踪执行过程中的状态/进度/告警事件流。 |
六、 直播控制页面（人工介入与应急控制）
入口：在执行详情页右上角点击 "直播控制" 按钮，进入全屏实时操控视图。
与实时直播页签的分工：
- 实时直播页签（执行详情内嵌）：侧重看实时内容（监控卡片/指标/直播/地图/点位/事件）。
- 直播控制页面（全屏）：在"看"的基础上强化控（人工接管/急停/返航）与多相机切换，是应急干预的主战场。
页面由顶部状态栏、左侧信息栏、主视频区三部分构成。
1. 页面布局
| 区域 | 核心内容 |
|---|---|
| 顶部状态栏 | 平台标识 + 航线进行中状态与已执行时长计时；右侧设备状态指示：** 电量 / 信号 / GPS / 链路**。 |
| 左侧信息栏 | 任务详情（任务名称、当前状态、进度条）；相机列表（可切换多相机）；小地图（无人机位置与高度，缺航线 DSL 时提示"暂无可绘制的航线 DSL 数据"）。 |
| 主视频区 | 实时视频流（无流时显示空态"暂无无人机视频流"）；右上应急控制按钮；右侧快捷工具栏；底部实时遥测条。 |
提示
💡 设备状态占位语义：顶部设备状态中，横线（-） 与 "待同步" 均表示该项数据尚未就绪/未回传（如电量-、信号-、GPS 待同步、链路 待同步）。数据就绪后会显示实时数值。
2. 三大应急控制按钮（核心安全能力）
| 按钮 | 颜色 | 业务作用 |
|---|---|---|
| 人工接管 | 蓝 | 接管无人机控制权，切换为云端人工打杆飞行。 |
| 急停 | 红 | 紧急停止/悬停，立即中止当前飞行动作。 |
| 返航 | 橙 | 一键返航，终止当前任务并返回起飞点。 |
提示
⚠️ 应急使用原则：当实时画面或遥测出现异常（逼近障碍物、姿态失稳、电量骤降、链路告警）时，优先评估并按需触发急停（立即止损）或返航（安全撤离）；需精细人工飞行时使用人工接管。
3. 相机列表切换（多通道直播）
左侧相机列表展示飞行器搭载的多个相机通道，点击可切换主视频区画面：
| 相机 | 能力标签 | 状态 |
|---|---|---|
| 广角相机 | 4K | 直播中（默认主视角） |
| 变焦相机 | 30x | 可切换 |
| 热成像相机 | IR | 可切换 |
- 列表右上角提供相机画面切换策略下拉（当前显示"自动"），用于配置多相机画面的切换策略。
- 当前直播中的相机高亮显示；其余相机标记为可切换。
4. 设备状态与实时遥测
- 顶部设备状态：电量、信号、GPS、链路的实时指示；占位（- / 待同步）表示未就绪。
- 底部遥测条：主视频区下方实时显示 高度 / 距离 / 水平速度 / 垂直速度；数据未就绪时显示占位横线。
5. 主视频区快捷工具与空态
- 右侧工具栏：缩放滑杆（画面/变焦缩放）、拍照（抓拍当前帧）、指点/对准、重置（重置视角）等快捷工具（具体语义以界面图标为准）。
- 空态：视频流未就绪时，主视频区显示"暂无无人机视频流"，但左侧任务详情、相机列表与小地图仍可能正常刷新。
提示
💡 看+控协同：实时直播页签负责呈现实时态势（视频/遥测/点位/事件），直播控制页面负责干预飞行行为（人工接管/急停/返航）与切换观测通道（多相机）。二者结合构成实时监测的完整应急闭环。
七、 排查实时内容未显示
如果实时页没有正常显示内容，按以下顺序排查：
- 当前执行是否真的已经进入实时阶段（未进入则页签不显示）。
- 机巢信息是否已经就绪（未就绪则页签不显示或空态）。
- 页面是否仍在接收最后消息时间更新（不更新则链路可能中断）。
- 当前是否返回了可播放的实时流地址（无流地址则视频无法播放）。
提示
💡 分流排查技巧：直播画面未显示但点位和事件仍在刷新时，说明监测链路未完全中断，应优先排查直播流地址和播放状态，而非整体链路。
八、 使用建议
- 先看连接与进度，再看视频和点位：进入实时页先确认连接状态和任务进度，再关注视频画面与点位流。
- 实时看当前、回放看历史：实时监测用于查看当前执行状态；历史回放用于任务结束后的复盘，二者时机互斥。
- 点位/事件刷新 = 链路未断：如果点位和事件还在更新，说明监测链路不一定完全中断，问题可能仅在视频流。
- 异常立即应急控制：实时态势异常时，不要只看不控，立即在直播控制页面使用急停/返航/人工接管干预。
- 按需切换相机通道：可见光细节用变焦相机，夜间/温度异常排查用热成像相机，全局视野用广角相机。
- 结束后转历史回放：需要复盘整次任务时，执行结束后优先去看历史回放，而非停留在实时页。