jf-open-pro-cloud-record - 杰峰设备云存储技能（开发版）

技能描述

支持杰峰设备云存储视频管理功能：

• 云存视频列表 - 查询指定时间段的云存视频列表
• 云存视频回放 - 获取云存视频回放地址（HLS 在线播放）
• 云存视频下载 - 获取云存视频下载地址（MP4 文件）
• 云存报警消息 - 查询云存报警消息列表

⚠️ 前提条件： 设备需开通云存储套餐

触发词

• 查询云存视频 / 云存回放 / 云录像下载
• 云存报警 / 云存消息列表 / 云存视频列表

前置条件

必需配置

1. 签名算法 - 使用杰峰官方移位加密算法生成 signature
2. 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
3. 云存储套餐 - 设备需开通云存储服务

环境变量

API 接口

核心功能

1. 云存视频列表（Video List）

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

请求参数：

响应参数：

2. 云存视频回放/下载（Video URL）

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

请求参数：

响应参数：

3. 云存报警消息（Alarm List）

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

请求参数：

使用示例

环境准备

# 设置环境变量（使用占位符，请替换为实际值）
export JF_UUID="uuidxxxx"
export JF_APP_KEY="appkeyxxxx"
export JF_APP_SECRET="appsecretxxxx"
export JF_MOVE_CARD="2"
export JF_DEVICE_SN="devicesnxxxx"
export JF_DEVICE_TOKEN="devicetokenxxxx"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 查询云存视频列表

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

# 查询今天云存视频
python3 cloud_record.py --action get-video-list \
  --start "2026-05-07 00:00:00" \
  --stop "2026-05-07 23:59:59"

# 查询报警视频（人体检测）
python3 cloud_record.py --action get-video-list \
  --start "2026-05-07 00:00:00" \
  --stop "2026-05-07 23:59:59" \
  --event "HumanDetect"

2. 获取云存回放地址

# 获取回放地址（在线播放）
python3 cloud_record.py --action get-video-url \
  --video-id "videoIdxxxx" \
  --format m3u8

# 获取下载地址（MP4）
python3 cloud_record.py --action get-video-url \
  --video-id "videoIdxxxx" \
  --format MP4

3. 查询云存报警消息

# 查询今天报警消息
python3 cloud_record.py --action get-alarm-list \
  --start "2026-05-07 00:00:00" \
  --end "2026-05-07 23:59:59"

# 查询人体检测报警
python3 cloud_record.py --action get-alarm-list \
  --start "2026-05-07 00:00:00" \
  --end "2026-05-07 23:59:59" \
  --event "appEventHumanDetectAlarm"

报警类型参考

状态码

平台状态码

注意事项

1. 云存储套餐 - 设备需开通云存储服务才能使用
2. URL 有效期 - 回放/下载地址有效期24 小时
3. 流量计费 - MP4 下载按文件大小消耗流量计费
4. 分页限制 - 视频列表每页最大 200 条
5. 时间格式 - 所有时间参数使用 yyyy-MM-dd HH:mm:ss 格式

相关文件

参考文档

• 杰峰开放平台