通道怎么同步、停用和删除

通道就是用户最终看到和操作的一路视频。播放、录像、权限和第三方系统都通过稳定的通道 ID 找到它，所以不要把“改名”“离线”“停用”“删除”当成一回事。

先看这张状态图

stateDiagram-v2
    direction LR
    [*] --> 已启用: 新增或同步
    已启用 --> 离线: 设备或网络异常
    离线 --> 已启用: 设备恢复
    已启用 --> 已停用: 人工停用
    已停用 --> 已启用: 重新启用
    已停用 --> 已删除: 确认无依赖

• 在线/离线是平台观察到的运行状态，不能靠手工伪造。
• 启用/停用决定能否发起新播放、录像或控制，历史数据仍保留。
• 改名只改变页面文字，不应改变通道 ID。
• 删除会影响关联业务，通常最后才做。

第一次同步通道

1. 在设备列表找到刚接入的设备，执行“同步通道”或“刷新目录”。
2. 等待任务完成，再打开该设备的通道列表。
3. 核对数量、名称、主辅码流以及协议标识，例如 ONVIF Profile token 或 GB28181 DeviceID。
4. 随机打开一路预览，确认同步出来的不是只有名称的空记录。

NVR 多通道和 GB28181 大目录应先拿一台设备试通，再批量同步。后续同步必须按协议稳定标识匹配旧通道，设备改名或排序变化不应产生重复记录。

开启或关闭云台控制

进入 资产详情 → 通道配置 → 云台控制，查看“设备能力”，再修改“允许 PTZ 控制”，点击 保存 PTZ 设置。这个按钮只保存云台开关，不需要重启，也不会改变视频播放、音频或录像。

• GB28181 根据注册后同步的 Catalog 目录项判断能力，支持读取 Info/PTZType；不能仅因注册成功或采用 GB28181 就认为有云台。固定类型、缺失或未知类型不默认提供 PTZ。
• ONVIF 根据 Profile 中的 PTZConfigurationToken 判断云台能力，不把普通视频 Profile 当成云台 Profile。
• “设备能力”和“允许使用”分开保存。设备有能力时可以人工关闭；设备没有能力时，勾选允许也不会创造能力。目录、Profile 刷新和设备重新上线不会自动恢复人工关闭的开关。
• 关闭后播放器隐藏 PTZ，统一控制 API 和已登记的协议 PTZ 控制入口拒绝新控制动作。停止命令仍可用于安全结束已开始的移动；保存前已下发的动作不会因此撤回。
• 保存失败时保留本次选择，先重新读取设置核对是否已生效。云台开关需要 channels.manage 权限，执行控制仍需要 devices.control。

API 对应 GET /api/v2/channels/{channelId}/ptz/settings 和 PUT /api/v2/channels/{channelId}/ptz/settings。写入内容为 {"enabled": false} 或 {"enabled": true}；响应分别返回设备能力 reported、人工许可 enabled 和最终许可 canControl。旧版配置的有效能力以接口返回值为准。

周期截图的开关、查询和下载见独立的通道周期截图指南。

需要暂时下线时

选择“停用”，不要直接删除。停用后应无法再建立新流，但仍能查到已有录像和审计记录。需要恢复时重新启用即可。

启用通道会占用授权额度。额度已满时，新增或重新启用会被拒绝；停用、停止流和清理仍然允许，以便释放资源。不要直接改数据库绕过额度。

改名时先决定谁说了算

改名后打开旧录像和第三方业务，确认关系没有丢失。

删除前做 5 项检查

1. 是否还有在线流、录像会话或未完成控制命令。
2. 是否关联录像文件、计划、告警、收藏或外部映射。
3. 设备是否只是暂时离线，恢复后还会重新上报。
4. 当前操作是可恢复的软删除，还是不可恢复的硬删除。
5. 是否已经保留必要的审计和业务记录。

批量操作必须查看逐项结果，只重试失败项。不要因为总进度显示失败，就再次操作已经成功的通道。

做完后这样验收

• 同一物理通道只有一个平台通道 ID。
• 设备重启、改名和多次同步后，不会多出重复通道。
• 停用会阻止新业务，但历史录像仍可查询。
• 删除结果符合录像、审计和第三方映射的保留要求。