jf-open-pro-capture - 杰峰设备批量抓图技能（开发版）

技能描述

支持杰峰设备云抓图功能，适用于单设备或多设备批量抓图：

• 批量抓图 - 支持多设备同时抓图
• 自动 Token 管理 - 自动获取和管理 deviceToken
• 本地下载 - 可选下载图片到本地存储
• 多通道支持 - 支持多通道设备抓图
• 图片类型 - 实时图/缩略图

计费说明： 按调用次数计费，详见 杰峰官网 - 云抓拍定价

触发词

• 设备抓图 / 批量抓图 / 云抓图
• 获取设备图片 / 抓图下载 / 实时抓图

前置条件

设备要求

1. 设备在线 - 设备需在线且可访问
2. 设备绑定 - 设备需先绑定到开放平台账号
3. 辅码流 - 默认抓取辅码流（标清）
4. 主码流 - 需联系销售定制固件

必需配置

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

环境变量

API 接口

核心功能

1. 设备抓图（Capture）

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

Name: OPSNAP

请求参数：

响应参数：

2. 获取设备 Token（批量抓图必需）

API: POST /gwp/v3/rtc/device/token

请求参数：

响应参数：

使用示例

环境准备

# 设置环境变量（请替换为您的实际配置）
export JF_UUID="your-uuid"
export JF_APP_KEY="your-app-key"
export JF_APP_SECRET="your-app-secret"
export JF_MOVE_CARD="2"
export JF_DEVICE_SN="your-device-sn"
export JF_DEVICE_TOKEN="your-device-token"
export JF_DEVICE_USERNAME="admin"
export JF_DEVICE_PASSWORD="your-device-password"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 单设备抓图（已有 Token）

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

# 抓取实时图（辅码流）
python3 capture.py --action capture \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

# 抓取缩略图
python3 capture.py --action capture --pic-type 1 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

# 抓取第二通道
python3 capture.py --action capture --channel 1 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

2. 单设备抓图（自动获取 Token）

# 自动获取 Token 并抓图
python3 capture.py --action capture-auto \
  --device-sn "your-device-sn" \
  --password "your-device-password"

3. 批量设备抓图

# 批量抓图（从文件读取设备列表）
python3 capture.py --action batch-capture \
  --devices-file "devices.txt" \
  --password "your-device-password"

# 批量抓图并下载
python3 capture.py --action batch-capture \
  --devices-file "devices.txt" \
  --password "your-device-password" \
  --download --output-dir "./captures"

4. 抓图并下载

# 抓图并下载到当前目录
python3 capture.py --action capture \
  --device-sn "your-device-sn" \
  --device-token "your-device-token" \
  --download

# 抓图并下载到指定目录
python3 capture.py --action capture \
  --device-sn "your-device-sn" \
  --device-token "your-device-token" \
  --download --output-dir "./captures"

5. 多通道设备抓图

# 抓取第一通道
python3 capture.py --action capture --channel 0 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

# 抓取第二通道
python3 capture.py --action capture --channel 1 \
  --device-sn "your-device-sn" \
  --device-token "your-device-token"

6. JSON 格式输出（适合程序调用）

# 单设备抓图 - JSON 格式
python3 capture.py --action capture-auto \
  --device-sn "your-device-sn" \
  --password "your-device-password" \
  --json

# 输出：{"url": "https://..."}

# 批量抓图 - JSON 格式
python3 capture.py --action batch-capture \
  --devices-file "devices.txt" \
  --password "your-device-password" \
  --json

# 输出：{"total":3,"success":3,"failed":0,"results":[...]}

设备列表文件格式

# devices.txt - 设备列表文件
# 格式：设备序列号，设备名称（可选）
your-device-sn-01，大门摄像头
your-device-sn-02，后院摄像头
your-device-sn-03，客厅摄像头

请求参数说明

图片类型（PicType）

通道号（Channel）

状态码

平台状态码

设备状态码（Ret）

注意事项

1. 图片有效期 - 抓图 URL 有效期24 小时，过期自动清除
2. 及时下载 - 建议及时下载到本地存储
3. 计费说明 - 按调用次数计费，详见官网定价
4. 默认辅码流 - 默认抓取辅码流（标清）
5. 主码流 - 需联系销售定制固件
6. Token 有效期 - deviceToken 有效期 24 小时
7. 批量限制 - 单次最多 500 个设备
8. 设备在线 - 设备需在线才能抓图成功

相关文件

参考文档

• 杰峰开放平台
• 设备云抓图
• 获取设备接口访问令牌
• 杰峰云抓拍定价
• 签名算法
• 时间戳算法