jf-open-pro-local-record - 杰峰设备本地录像技能（开发版）

技能描述

支持杰峰设备本地录像管理功能，适用于搭载 TF 卡或硬盘存储的设备：

• 录像日历查询 - 查询指定月份哪些日期有录像
• 录像回放列表 - 获取指定时间段的录像文件列表
• 录像回放地址 - 获取 FLV/HLS/RTSP/MP4 回放地址
• 录像下载 - 获取 MP4 格式录像下载地址
• 本地报警图片 - 获取设备本地存储的报警图片
• 主辅码流切换 - 切换本地录像的主码流（高清）或辅码流（标清）

适用场景：

• 回看历史录像
• 下载重要录像片段
• 查看报警时的抓拍图片
• 调整录像存储质量（高清/标清）

触发词

• 查询录像日历 / 查询录像列表 / 录像回放
• 下载录像 / 获取报警图片 / 切换码流
• 本地录像 / 卡存录像 / TF 卡录像 / 硬盘录像

前置条件

硬件要求

1. 设备支持卡存录像 - 设备需有 TF 卡或硬盘存储
2. 录像已开启 - 设备已配置录像计划并正常录像

必需配置

1. 签名算法 - 使用杰峰官方移位加密算法生成 signature
2. 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
3. 设备绑定 - 设备需先绑定到开放平台账号

环境变量

API 接口

核心功能

1. 录像日历查询（CardPlaybackCalendar）

API: POST /gwp/v3/rtc/device/cardPlaybackCalendar/{deviceToken}

请求参数：

响应参数：

2. 录像回放列表（OPFileQuery）

API: POST /gwp/v3/rtc/device/opdev/{deviceToken}

请求参数：

录像类型说明：

响应参数：

3. 录像回放/下载地址（PlaybackUrl）

API: POST /gwp/v3/rtc/device/playbackUrl/{deviceToken}

请求参数：

协议说明：

响应参数：

⚠️ 注意：

• URL 有效期为 10 小时
• 同时只支持 一路回放或下载
• 本地录像回放和下载按照流量计费

4. 本地报警图片（GetDeviceLocalPic）

API: POST /gwp/v3/rtc/device/getDeviceLocalPic/{deviceToken}

请求参数：

响应参数：

5. 切换主辅码流（CardVideoSwitchStream）

API: POST /gwp/v3/rtc/device/cardVideoSwitchStream/{deviceToken}

请求参数：

说明：

• 切换后新录制的视频将使用新码流
• 不影响已存储的录像文件

使用示例

环境准备

# 设置环境变量
export JF_UUID="uuidxxxx"
export JF_APP_KEY="appkeyxxxx"
export JF_APP_SECRET="appsecretxxxx"
export JF_MOVE_CARD=0
export JF_DEVICE_SN="snxxx1"
export JF_DEVICE_TOKEN="NTQ0NzQ3YmE3MXwyYzFk..."
export JF_DEVICE_USERNAME="admin"
export JF_DEVICE_PASSWORD="xxxx"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 查询录像日历

cd ~/.openclaw/workspace/skills/developer/jf-open-pro-local-record/scripts

# 查询本月录像日历
python3 local_record.py --action get-calendar --year 2026 --month 5

# 查询指定月份
python3 local_record.py --action get-calendar --year 2026 --month 4

2. 查询录像列表

# 查询今天录像列表
python3 local_record.py --action get-record-list 
  --start "2026-05-07 00:00:00" 
  --end "2026-05-07 23:59:59"

# 查询报警录像
python3 local_record.py --action get-record-list 
  --start "2026-05-07 00:00:00" 
  --end "2026-05-07 23:59:59" 
  --event "AMRH"

3. 获取录像回放地址

# 获取 FLV 回放地址（Web 播放）
python3 local_record.py --action get-playback-url 
  --file-name "/idea0/2026-05-07/001/10.00.00-11.00.00[R][@12345][0].h264" 
  --start "2026-05-07 10:00:00" 
  --end "2026-05-07 11:00:00" 
  --protocol flv

# 获取 HLS 回放地址（移动端播放）
python3 local_record.py --action get-playback-url 
  --file-name "/idea0/2026-05-07/001/10.00.00-11.00.00[R][@12345][0].h264" 
  --start "2026-05-07 10:00:00" 
  --end "2026-05-07 11:00:00" 
  --protocol hls-ts

4. 下载录像

# 获取 MP4 下载地址
python3 local_record.py --action download-record 
  --file-name "/idea0/2026-05-07/001/10.00.00-11.00.00[R][@12345][0].h264" 
  --start "2026-05-07 10:00:00" 
  --end "2026-05-07 11:00:00"

5. 获取本地报警图片

# 获取报警图片地址
python3 local_record.py --action get-alarm-pic 
  --file-name "/idea1/2026-05-07/001/10.24.01-10.24.02[M][@48][0].jpg" 
  --start "2026-05-07 10:24:01" 
  --end "2026-05-07 10:24:02"

6. 切换主辅码流

# 切换到标清辅码流（节省存储空间）
python3 local_record.py --action switch-stream --stream 1

# 切换到高清主码流（更高画质）
python3 local_record.py --action switch-stream --stream 0

# 查询当前码流状态
python3 local_record.py --action get-stream-status

状态码

平台状态码

设备状态码（Ret）

注意事项

1. 设备要求 - 设备需支持卡存录像（TF 卡或硬盘）
2. deviceToken 有效期 - 24 小时，过期需重新获取
3. 设备在线要求 - 所有操作需要设备在线
4. 回放 URL 有效期 - 10 小时，请及时使用
5. 单路限制 - 同时只支持一路回放或下载
6. 流量计费 - 本地录像回放和下载按照流量计费
7. 时间格式 - 所有时间参数使用 yyyy-MM-dd HH:mm:ss 格式
8. 文件名获取 - 录像文件名需从回放列表接口获取

相关文件

参考文档

• 杰峰开放平台