用途:管理 VIOS 与 NvStreamer 的 VSS 视频输入输出和存储工作流,涵盖传感器/摄像头、RTSP 流、上传、快照、视频切片、时间线与录制状态。通过 curl 直接调用 REST API,而非操作 UI。
主要能力:传感器列表/详情/状态/增删,流列表与状态,时间线查询,切片下载,快照获取,文件上传与删除,活流/回放,以及 NvStreamer 的文件转 RTSP 重发布(上传、取回生成的 RTSP URL、文件系统扫描、帧快照)。
必要用法:基础地址为 http://<VST_ENDPOINT>/vst/api/v1。调用前先做可用性探测:curl -sf --connect-timeout 5 http://<VST_ENDPOINT>/vst/api/v1/sensor/version。若用户未给 sensorId/streamId,用 GET /sensor/list、GET /sensor/{sensorId}/streams 等自动查。需要 startTime/endTime 时,若用户未提供,先查时间线取有效区间,不得编造时间戳。上传本地 MP4 作为 file-backed sensor 时用 PUT /vst/api/v1/storage/file/{filename};仅当明确需要实时/合成 RTSP 流或取 RTSP URL 时才用 NvStreamer。建议优先使用二进制直连端点而非 /url JSON 变体。
适用场景:列出传感器与流状态、上传样例视频、按时间线下载切片、获取快照、用 NvStreamer 上传并取回 RTSP URL。
限制:需要可达的 VST 后端,探测失败时应部署或停止;多数部署无鉴权,但可加外部鉴权层,401 时需用户提供 token。上传报 Failed to get media information 属 libav 缺失,需 VST_INSTALL_ADDITIONAL_PACKAGES=true 后重新部署。/url 变体返回双 http:// 前缀,需客户端剥离或改用二进制端点。sensor/list 等可能因遗留容器出现 502,需重跑部署清理。不要在日志或回复中打印 API 密钥或令牌。本技能不负责部署 VIOS 本身。具体端点字段与更多细节见随附参考文件,其余信息暂未提供。