国标设备
概念说明
国标设备页用于集中管理接入视频中心的 GB28181 摄像机、NVR、IPC 等前端设备。页面以卡片列表展示每台设备的编号、在线状态、厂商型号、网络地址、通道数与最近心跳。在这里可以手动登记设备（用于「手动注册」白名单）、进入设备详情做精细配置、查看通道、远程播放视频，并对设备执行同步目录、校时、重启等运维操作。
一、摄像头接入配置
摄像头接入本平台前，需在设备端 GB28181 配置中填入平台参数，与平台侧「国标平台 / 平台信息」逐字对应；参数一致且鉴权通过后，设备即按下方接入方式进入列表。
| 平台侧（平台信息） | 摄像头侧填入 |
|---|---|
| SIP 服务器 ID（平台编号） | 上级 SIP 服务器编号 |
| SIP 域 | 上级 SIP 域 |
| 服务器地址 / 端口 | SIP 服务器地址 / 端口 |
| 注册密码 | 注册密码 |
设备侧另需自定义 SIP 用户名 / 认证 ID（本设备 20 位国标编号）与视频通道编码 ID（通道 20 位国标编号，类型码 132），须在本平台内唯一；完整编码规则见 国标平台。
提示
海康 / 大华等不同品牌配置项名称略有差异，含义一致；只要与平台侧参数逐字对齐即可注册。
二、设备接入方式
设备进入列表有两种途径：
- 自动接入：设备按 GB28181 向平台发起 SIP 注册后，平台自动识别并加入列表，无需在本页操作。
- 手动注册：当平台【设备注册模式】为【手动注册】时，须先在本页用【注册设备】预先登记设备编号，注册才会被放行（白名单机制）。
提示
列表为空说明暂无设备接入。可在「手动注册」模式下预先登记，或等待设备自动注册；空列表页提供【前往国标平台配置】快捷入口。
三、注册设备
仅当平台【设备注册模式】为【手动注册】时需要本步骤——点列表左上角【注册设备】，在抽屉中填写后保存即登记进白名单。
注意
【注册设备】按钮仅在【手动注册】模式下可用；自动注册模式下按钮禁用，悬停提示「仅当国标平台『设备注册模式』为『手动注册』时，才能登记设备」。
表单字段：
- 设备编号（必填）：20 位 GB28181 国标编号，须与设备端一致。
- 设备名称（必填）：设备的友好标识名。
- 鉴权密码（选填）：留空则该设备注册时回退使用平台统一密码；填写则设备端须配置一致的密码。
- 设备图标（选填）：jpg/png，不超过 500kb，留空用默认图标。
提示
厂商、型号、网络地址、在线状态等由注册链路自动维护，无需手填，故不出现在表单中。
四、设备卡片信息
每台设备一张卡片，底色随在线状态变化，展示：设备编号（可点击进入详情）、设备名称、在线状态、厂商、型号、网络地址（IP:端口）、通道数、最近心跳。其中厂商、型号由注册链路上报。
五、卡片操作
每张卡片底部提供一行操作：
- 配置（或点设备编号标签）：进入设备详情页，查看与配置设备信息、通道、视频、录像等（详见第七节起）。
- 编辑：修改设备名称、鉴权密码、图标；设备编号创建后不可改。
- 通道：进入详情页并定位到通道 Tab。
- 播放：弹出视频播放弹框实时点播（见第六节）。
- 删除：二次确认后删除设备（不可恢复，请先确认设备及其通道不再需要）。
- 更多：展开运维命令——同步（拉取刷新通道列表）、校时（下发平台时间对齐设备）、重启（远程重启，设备短暂断线约 30s）。
提示
同步 / 校时 / 重启均为异步指令，接口返回仅代表指令已下发，实际结果以设备后续上报为准，页面会提示流水号（SN）。
六、视频播放弹框
在设备卡片点【播放】弹出，用于实时点播该设备下通道的画面，打开时自动加载通道并起播首个通道。它与【视频监控】的多格视频墙是不同组件——这里是单通道弹框。顶部左侧的通道下拉（支持关键字筛选）切通道、右侧在主码流 / 子码流间切换，切换任一项都会重新建流起播；设备无可播通道时提示「该设备暂无可播放通道」，可先【同步】。
6.1 云台控制
点顶部【云台】（选中通道后可用）在画面右侧展开云台面板——固定枪机等无云台能力的通道不显示该按钮。能力涵盖：八方向（含四斜向，按住转动、松开停止）、变倍、聚焦、光圈、速度（1~255）、雨刷，以及展开后的巡航 / 扫描 / 看守位与预置位（同步 / 新增 / 调用 / 删除）；中心键随时下发停止报文。
提示
预置位【同步】会向设备查询，回送需数秒后自动刷新列表；新增预置位若编号已存在，保存前会提示是否覆盖。
6.2 播放地址
弹框底部展示当前播放地址并可切换格式，点【复制】取地址用于外部播放器或分享：
| 格式 | 说明 |
|---|---|
| WS-FLV | 基于 WebSocket 的 FLV，网页内直接播放（默认） |
| HTTP-FLV | 基于 HTTP 的 FLV，网页内直接播放 |
| WebRTC | 超低延迟，需 https / localhost 环境且通道编码为 H.264 |
| RTMP | 网页不可直接播放，仅供复制地址后用 VLC 等外部播放器打开 |
注意
切换格式只更换地址与渲染方式、不重新拉流；只有切换通道或码流才重建媒体流。
6.3 监控录像
弹框底部提供两种录像，用途不同：
- 平台录像：录制当前通道的实时流并归档到平台录像档案，可在【视频回放】查看与下载。点击开始、再次点击结束。
- 设备录像：命令设备把录像录到自身存储（NVR / IPC 本地），与平台是否拉流无关。弹框内的【设备录像】按钮需在该通道起播后方可点击；若想在不起播的情况下下发，可在详情页【通道列表】Tab 的【控制】下拉中操作「设备录像开始 / 停止」。录制段可在【视频回放】查询回放。
提示
切换通道或关闭弹框时，平台录像会自动停止并归档；设备录像是设备自身行为，切换通道仅复位本地按钮状态，不会向设备下发停录命令。
七、设备详情页
从设备卡片点【配置】进入设备详情页——单台设备的「一站式管理中心」。页头含【返回】（回列表并关闭当前标签）与设备摘要（设备名称、设备编号、厂商型号、网络地址，名称与编号右侧均有【复制】）。详情页与所选设备绑定，刷新或分享链接后仍停留在该设备；切换 Tab 时地址栏同步记录，刷新后回到上次查看的 Tab。
详情页共 9 个标签页：
| # | 标签页 | 作用 |
|---|---|---|
| 1 | 设备信息 | 设备静态信息、实时状态、基本参数 |
| 2 | 通道列表 | 按本设备聚合的通道清单与播放、控制 |
| 3 | 视频监控 | 本设备通道树 + 实时预览 / 录像回放视频墙 |
| 4 | 录像计划 | 本设备各通道的录像计划配置 |
| 5 | 录像档案 | 本设备已存录像段检索与回放 |
| 6 | 录像下载 | 本设备录像段的下载任务管理 |
| 7 | 订阅管理 | 目录 / 位置 / 报警三类订阅（受权限控制） |
| 8 | 设备日志 | 本设备的报警记录查询 |
| 9 | 设备地图 | 设备定位打点与移动轨迹回放 |
其中【通道列表】【视频监控】【录像计划】【录像档案】【录像下载】为「按本设备聚合」的视图，只展示并操作本设备数据、功能与对应独立菜单一致，仅省去「选择设备」一步；以下按标签页顺序逐一说明。
7.1 设备信息
详情页的默认标签页，分三个区域：设备信息区为平台已记录的静态属性（编号、名称、在线状态、厂商型号、固件版本、网络地址、传输协议、编码格式、字符集、通道数、注册时间、最近心跳、位置能力等）；实时状态区与基本参数区在进入时各向设备下发一次查询、异步等待应答，右上角【刷新】可重查。设备 30s 内未应答时提示查询超时，此时以「设备信息区」的静态信息为准。
7.2 通道列表
按本设备聚合的通道清单（通道编号 / 名称 / 行政区划 / 厂商型号 / 云台类型 / 在线状态），顶部可按通道编号筛选。每行可【播放】实时点播；【控制】下拉可下发布防 / 撤防、报警复位、强制关键帧、设备录像开始 / 停止等设备指令。通道概念、全局检索与分组挂载见 设备通道。
提示
在通道行点【播放】会自动切到【视频监控】Tab 并起播该通道，便于「看清楚再操作」。
7.3 视频监控
左侧为本设备通道树（支持搜索、云台标识与在线状态点），右侧在实时预览与录像回放两种模式间切换：实时预览为多格视频墙（1 / 4 / 9 / 16 布局、全屏、一键停止全部），回放按所选通道与时段拉取录像。完整操作见 视频监控。
7.4 录像计划
为本设备各通道配置定时录像计划：选通道、设 Cron 时间表达式、命名并启用 / 禁用，列表可查看各计划的最近执行状态。计划说明详见 视频回放。
7.5 录像档案
检索本设备已归档的录像段（可按通道筛选），区分计划 / 手动来源并展示时长、大小、状态。已完成的档案可播放 / 下载，支持批量下载与批量删除（删除会一并移除存储文件），录制中的档案列表自动刷新。详见 视频回放。
7.6 录像下载
把设备端（NVR / IPC 本地）某通道某时段的录像下载归档为平台文件：选通道与时间范围创建下载任务，任务完成后可预览 / 下载，进行中的任务列表自动刷新。详见 视频回放。
7.7 订阅管理
向设备发起「主动推送」订阅，成功后设备在事件发生时主动通知平台，三类相互独立、各有【订阅】/【取消订阅】：目录订阅（通道增删改时推送，平台自动同步通道）、位置订阅（移动设备周期上报 GPS，供设备地图轨迹）、报警订阅（布防 / 移动侦测等报警推送，记入设备日志）。本页受订阅权限控制，无权限时不显示该 Tab。
注意
订阅能否生效取决于设备能力，部分设备不支持位置或报警订阅；位置订阅是「设备地图」轨迹回放有数据的前提。
7.8 设备日志
本设备的报警记录列表，按报警时间倒序，支持按报警方式、报警类型（随方式联动）、报警级别、时间区间筛选。表格含报警时间、方式、类型、级别（彩色标签）、优先级、报警源（通常为通道编号）与报文内容（点击弹出格式化的原始 JSON）。报警方式与类型的国标语义见 通信协议 §7.1。
7.9 设备地图
给固定设备打点定位，并对支持移动定位的设备做轨迹回放：左侧地图、右侧「位置信息」表单与轨迹查询区。在地图选点后经纬度自动回填，填地址后【保存】、【重置】清除定位（二次确认）；【立即定位】向设备下发一次性位置查询并在应答入库后刷新当前点；选通道与时间段【查询轨迹】后可逐点回放（显示上报时刻与速度）。
注意
轨迹数据来源于设备的移动位置上报，需设备具备定位能力并已开启「位置订阅」，否则查询不到轨迹。