服务端 HTTP

本地录像片段数量与列表查询接口见 录像查询 · 本地录像查询。

• queryLocalRecordBitmap：按月返回本地录像掩码（每日 0/1），先筛有录像的日期。
• queryLocalRecordNum：时间段内本地录像条数。
• queryLocalRecords：时间段内本地录像片段列表（正序）。子账号需 RecordReplay · cam:序列号:通道号。

云录像片段查询见 录像查询 · 云录像查询。

• queryCloudRecordBitmap：云录像按月掩码。
• queryCloudRecordNum：云录像条数。
• queryCloudRecords：云录像片段（正序）。
• getCloudRecords：云录像列表（倒序）。字段以各 API 页为准。
• queryCloudRecordByToken：凭告警 cloudToken 查片段。
• deleteCloudRecords：按云录像 ID 删除片段。

智见云存储或 AI 智见套餐生效期间，平台生成事件录像或图片集锦，见 录像查询 · 智见录像查询。片段查询最小权限同为 RecordReplay。下载字段见 录像下载与云转存。

推荐顺序：可选先用 Bitmap 接口确认有录像的日期 → query*Records / getCloudRecords 拉片段 → 再创建回放地址或交给播放器。掩码非强制，但可减少空查询。

回放地址常用两接口，时间跨度规则不同：

• createDeviceRecordHls：功能详情写根据设备号、通道号、时间段创建设备录像的 hls 地址。备注：地址存在有效期，获取之后请尽快使用，否则会失效；每次请求返回全新地址。参数说明里，回放录像类型为 localRecord（设备本地录像）或 cloudRecord（设备云录像）；起始、截止时间格式为 yyyy-MM-dd HH:mm:ss，不支持跨天。其余字段见该页。
• createDeviceFlvLive：功能详情写支持录像直播和实时直播。参数说明里，realTime 为实时视频直播，playback 为回放视频直播；beginTime 与 endTime 最大跨度 24 小时，可跨天；recordType 为 localRecord 或 cloudRecord。倍速说明：云录像直播可选 2/4/8/16 倍速，本地录像直播可选 2/4/8 倍速，只有 type 为 playback 时生效。删除、查询 flv 的标题写明只支持实时直播，见 创建设备直播地址。