第 1 章 概述
1.1 编写目的
本手册用于指导平台使用人员完成日常视频接入、实时观看、录像管理与系统管理工作。手册按「菜单—页面—区域—按钮」四级层次组织，对每一个可点击控件说明其位置、作用、执行结果与前置条件，可作为操作培训教材、现场作业指导书与验收依据。
1.2 读者对象
| 角色 | 建议阅读章节 | 说明 |
|---|---|---|
| 系统管理员 | 全部章节 | 负责账号、角色、权限、服务配置、节点与升级 |
| 设备运维人员 | 第 4、13、14、15、17、18、19 章 | 负责设备接入、目录维护、级联对接、节点巡检 |
| 值班监控人员 | 第 3、5、6、10、11、12 章 | 负责实时观看、录像回放、告警处置 |
| 录像管理人员 | 第 7、8、9、10 章 | 负责录像计划、云端录像、录像缓存 |
| 集成开发人员 | 第 20 章及附录 A | 负责 OpenAPI 对接与能力申请 |
| 只读访客 | 第 2、3、5、7、10 章 | 仅具备查看与播放权限 |
1.3 术语与缩略语
| 术语 | 全称／含义 | 说明 |
|---|---|---|
| GB28181 | GB/T 28181《公共安全视频监控联网系统信息传输、交换、控制技术要求》 | 本平台遵循的国家标准，支持 2016 与 2022 两个版本 |
| SIP | Session Initiation Protocol，会话初始协议 | 设备与平台之间的信令通道，默认端口 5061 |
| 国标 ID / 设备编码 | 20 位数字编码 | 设备唯一标识，由中心编码（8 位）、行业编码（2 位）、类型编码（3 位）、网络标识（1 位）、序号（6 位）组成 |
| 域 / SIP 域 | 10 位数字 | 通常取国标 ID 前 10 位 |
| 通道 | Channel | 一台设备下的一个视频通道；一台 NVR 通常上报多个通道 |
| 目录 / Catalog | 设备上报的通道清单 | 平台通过 Catalog 查询获取设备下有哪些通道 |
| 心跳 / Keepalive | 设备周期性发送的保活报文 | 平台据此判断设备在线状态 |
| 注册 / REGISTER | 设备向平台登记身份的过程 | 注册失败时设备无法被点播 |
| ZLM / ZLMediaKit | 流媒体服务器 | 负责收流、转协议、分发；平台可管理多个节点 |
| 节点 | Media Node | 一个 ZLMediaKit 实例，具备独立的地址、端口和容量 |
| 点播 / INVITE | 平台向设备请求实时视频 | 国标术语为「实时视音频点播」 |
| 流传输模式 | UDP / TCP 主动 / TCP 被动 | 设备向平台送流的方式，影响首帧速度与丢包表现 |
| 按需直播 | On-demand | 有人观看才向设备拉流，无人观看时释放 |
| 云端录像 | Cloud Recording | 平台把设备视频录制并落盘到媒体节点 |
| 录像缓存 | Record Cache | 把设备存储卡上的历史录像「拉回」并保存到平台服务器 |
| 倍速回放 | Playback Speed | 回放时以 0.25x～4x 速率播放 |
| 预置位 | Preset | 云台的固定机位，可保存与一键调用 |
| 巡航 | Cruise | 云台按预设顺序依次巡视多个预置位 |
| 看守位 | Home Position | 云台长时间无操作后自动归位的位置 |
| PTZ | Pan / Tilt / Zoom | 云台的水平、俯仰、变倍控制 |
| OSD | On-Screen Display | 画面上的时间、文字叠加 |
| 抓拍 | Snapshot | 设备按平台指令拍摄一张 JPEG 并上传 |
| 级联 | Cascade | 本平台作为下级，向上级平台注册并共享通道 |
| 业务分组 / 虚拟组织 | Business Group | 级联目录发布用的组织节点，类型码 215 / 216 |
| OpenAPI 客户端 | AK/SK 客户端 | 第三方系统调用平台接口的凭证 |
| AK / SK | Access Key / Secret Key | 客户端标识与密钥，SK 仅展示一次 |
| 设备归属 | Device Assignment | 设备属于哪个部门，决定谁能在数据权限内看到它 |
| 数据权限 | Data Scope | 账号能查看的数据范围：全部、自定义、本部门、本部门及子级 |
1.4 系统简介
本平台是一套面向 GB/T 28181 标准的视频接入与流转发系统。整体自下而上分四层：接入层对接摄像机、NVR 与下级平台；媒体层由一台或多台 ZLMediaKit 节点负责收流与转协议；平台层承载设备、录像、告警、级联等业务能力；应用层面向 Web 工作台与 OpenAPI 客户端提供服务。平台整体结构如图 1-1 所示。
图 1-1 系统功能架构
核心能力包括：
- 设备接入：支持设备主动注册、平台目录查询、设备状态订阅、位置订阅、报警订阅。
- 实时观看：支持 WS-FLV、HTTP-FLV、HLS、WebRTC、RTMP、RTSP、fMP4、TS 共 20 种播放地址，浏览器内可直接播放前 12 种。
- 云台控制：基础方向控制、精准角度定位、预置位、巡航、看守位、自动扫描、雨刷、3D 拖拽放大、目标跟踪。
- 画面治理：视频编码参数读写、OSD 叠加、画面遮挡、镜像、码流对照。
- 录像体系：云端录像（平台录制）、录像计划（按周时段录制）、设备录像回放（读设备存储卡）、录像缓存（把设备录像转存到服务器）。
- 多屏与轮巡：1/4/6/8/9/16 分屏，收藏组，自动轮询，视频墙全屏。
- 国标级联：作为下级平台向上级注册，按通道或按目录共享资源。
- 安全防护：SIP 接入黑白名单、攻击识别、自动封禁、主机防火墙联动。
- 运维管理：媒体节点纳管、调度策略、流与会话巡检、四类日志、服务在线升级。
- 开放能力：OpenAPI 客户端与能力授权，供第三方系统集成。
1.5 运行环境
| 项目 | 要求 |
|---|---|
| 浏览器 | Chrome 100+、Edge 100+、Firefox 100+；不支持 IE |
| 推荐分辨率 | 1920×1080 及以上；多屏播放与视频墙建议 2560×1440 |
| 网络 | 访问平台页面需可达平台 HTTP/HTTPS 端口；观看 WebRTC 需 UDP 端口可达 |
| 安全上下文 | 语音对讲、本地截图等功能要求 HTTPS 或 localhost 环境；通过 http:// + 局域网 IP 访问时，浏览器会禁用麦克风，表现为点击对讲无反应 |
| 浏览器权限 | 首次使用对讲需允许「使用麦克风」；截图需允许下载 |
注意 - 使用 http:// 加内网 IP 访问时，浏览器将其判定为非安全上下文，语音对讲、剪贴板、部分截图能力会被浏览器静默拒绝。此类场景请由管理员启用 HTTPS 后再使用。 - 平台页面长时间停留会自动刷新令牌；若提示「登录已失效」，请重新登录，未提交的表单内容会丢失。
1.6 手册约定
| 约定 | 含义 |
|---|---|
| 「按钮名」 | 界面上可点击的按钮或链接，逐字对应 |
| 字段名 | 表单中的输入项名称 |
| 图标按钮 | 以图标呈现、无文字的按钮，手册中写作「图标：🖥（悬停提示”查看详情”）」的形式 |
| → | 表示「然后点击」或「进入」 |
| 注意 | 强制约束或高风险提示 |
| 权限码 | 等宽字体，用于向管理员申请授权 |
手册的标记方式如图 1-2 所示：左侧是界面上实际呈现的控件，右侧是对应的写法。
图 1-2 手册标记法示例
阅读时请注意两点：按钮名逐字一致，写成「保存」而界面是「保存配置」，现场就找不到；权限码不要改写，冒号与大小写都要与手册完全相同，否则管理员按码授权会失败。