摄像头与设备
本页内容
摄像头在设备管理中管理，每个摄像头都嵌套显示在处理其画面的 Edge Processor 之下。本页介绍添加摄像头、视频流测试、每个摄像头的配置以及移除。
图 1：设备管理：Edge Processor 及其网络摄像头，显示每个摄像头的分辨率、帧率、AI 状态和视频流延迟
两种摄像头类型
要添加您现有的 IP 摄像头，请在设备管理中点击 Add Network Camera；请参阅添加网络摄像头。云摄像头通过添加设备添加：点击 Or choose the device type manually，然后点击 Add a Cloud Camera v1（标记为 Legacy）。摄像头有两种类型：
图 2：摄像头类型选择
| 类型 | 说明 | 适用情况 |
|---|---|---|
| Cloud Native CCTV Camera | "CCTV camera with native Performance Hub integration." 通过 Performance Hub 购买；自动关联到 Edge Processor，没有 Edge Processor 也能工作，并支持通过兼容的网络控制器进行远程电源控制 | 新装修项目 |
| Third Party Network Camera | "Added via stream URL (Hikvision, Dahua, TP-Link, etc.)." 您现有的 IP 摄像头，通过其视频流地址连接 | 现有装修项目和较大规模的部署 |
第三方网络摄像头需要一台在线的 Edge Processor："Network Cameras require an Edge Processor to be online. The Edge Processor will handle AI processing for cameras added via stream URL."
添加网络摄像头
图 3：添加对话框：处理器、视频流 URL、测试、名称、位置、录像
| 字段 | 详细信息 |
|---|---|
| Edge Processor（必填） | 由哪台设备处理该画面。离线的处理器会显示，但无法选择 |
| Stream URL（必填） | 摄像头的网络视频流地址。支持安全（rtsps://）和标准（rtsp://）视频流，也支持基于 HTTP 的视频流 URL |
| Camera Name（必填） | 在所有位置显示，请选择大家能认出的名称（Front Entrance、Gym Floor） |
| Location（必填） | 在整个模块中对摄像头进行分组（仪表板筛选器、Recordings 筛选器） |
| Recording | 默认开启。"When enabled, video from this camera will be recorded and stored" |
添加后，对话框会提醒您哪些内容可以稍后配置："Motion exclusion zones"、"Recording mode (continuous or motion-based)" 和 "AI inference settings"。
查找摄像头的视频流 URL
每个摄像头品牌提供视频流的方式略有不同，但格式始终是 rtsp://username:password@camera-ip:554/path：
- 从摄像头数据库开始：搜索您的摄像头型号或制造商，填入您的凭据和 IP，然后复制可直接粘贴的 URL。
- 否则，确切的
path可以在摄像头的使用手册或 Web 管理页面中找到（常见示例：/stream1、/live1.sdp、/Streaming/Channels/101）。 - 使用摄像头的主码流（最高画质）：Edge Processor 会为观看自动调整画质，因此没有理由录制子码流。
- 为摄像头设置静态 IP 地址（或 DHCP 保留地址），以免视频流 URL 失效。
- 对话框链接到更多指南："Refer to the documentation for common camera configuration and setup guides"。
视频流测试
添加之前，请点击 Test Stream：Edge Processor 本身会连接到该 URL，并验证能否读取视频（超时时间为 30 秒）。这样可以立即发现错误的凭据、错误的路径和无法访问的地址，而且是从真正起作用的设备上进行检测，而不是从您的浏览器。如果您跳过此步骤，点击 Add 时会自动运行测试。
视频流中断警告
添加摄像头会更新 Edge Processor 的配置。如果该处理器已有摄像头，对话框会发出警告："Adding a new camera will update the Edge Processor configuration. Other network cameras on the same Edge Processor may briefly reload their streams during this process (typically 5-10 seconds)." 重新加载后，录像会自动恢复。
摄像头设备对话框
在设备管理中点击任意摄像头行，即可打开其设备对话框，其中包含 Details、Configuration、Connectivity Diagnosis 和 Advanced 选项卡。
Details 选项卡
图 4：Details 选项卡：标识、视频流和实时处理统计
| 字段 | 含义 |
|---|---|
| Device UUID | 摄像头的唯一标识符 |
| Edge Processor | 由哪台设备处理此画面 |
| Public IP / Local/LAN IP | 设施的公网地址和摄像头的局域网地址 |
| Stream URL | 已配置的视频流（凭据已隐藏） |
| Video Codec | 例如 H264，按原样录制，不重新编码 |
| Stream Last Verified | 上次确认视频流正常的时间 |
| Activity Down/Up | 此摄像头传输的数据量 |
| Stream Uptime / Ping | 视频流连续运行的时长，以及摄像头延迟 |
| Processing Stats | 实时 AI 处理流程计数器（已发送的人脸、活动跟踪、空闲时间），在启用 AI 处理时填充；详细内容属于 AI Insights & People |
Configuration 选项卡
图 5：Configuration 选项卡：位置、录像、移动侦测区域和 AI 处理
| 设置 | 详细信息 |
|---|---|
| Location | 更改摄像头的位置分组 |
| Recording | 启用或禁用录像，并选择模式：Motion Triggered 或连续录像，请参阅录像 |
| Motion Threshold | 适用于 Motion Triggered 摄像头：多大的像素变化会触发录像，提供 Subtle / Default / Energetic / Intense 预设（移动侦测与灵敏度） |
| Adjust Motion Zone | 打开移动侦测区域编辑器，绘制应触发录像的移动区域（移动侦测区域） |
| 人员追踪 | 为此画面启用设备端 AI 人员检测（属于 AI Insights & People 功能） |
| Transcription | 为带麦克风的摄像头启用音频转录，优先级为 Low (0) / Medium (3) / High (5)（AI Insights & People） |
| Target AI Framerate | AI 处理流程每秒分析的帧数（1–30）。界面指南："Use faster framerates (15-30 FPS) for high-traffic areas like doors and entrances. Use lower framerates (1-8 FPS) for general room monitoring." 帧率越高，占用设备的 AI 容量越多 |
点击保存更改即可应用：配置更改会推送到 Edge Processor，受影响的视频流会短暂重新加载。
Connectivity Diagnosis 选项卡
Edge Processor 与摄像头之间的实时诊断：当视频流出现异常时，请先使用它，而不要直接认定摄像头已损坏。请参阅故障排除。
重命名、移动和移除
- 您可以随时在 Configuration 选项卡中重命名摄像头或更改其 Location：录像会继续正常进行；新名称在所有位置生效。
- 移除摄像头会停止其录像，并将其从所有视图中移除。已上传的视频会保留在 Recordings 中，直到保留期到期（已保留的项目会继续保留）。
- 更换摄像头（相同位置，新硬件）：将现有摄像头的 Stream URL 更新为新摄像头的地址，而不是删除后重新添加，这样历史记录可以保持连续。
多台 Edge Processor
摄像头数量超过一台设备处理能力（容量指南）的设施会运行多台 Edge Processor。每个摄像头只属于一台处理器，在添加时选择。所有下游功能（实时显示、时间轴、Recordings）都会将所有摄像头一并呈现，无论它们属于哪台处理器。