JF Open Pro Capture Livestream

面向开发者杰峰设备 API 工具 (Python)

支持批量获取杰峰设备实时画面，可多设备多通道抓图和直播地址获取。

🔒 安全说明

仅支持环境变量存储凭据

🚀 快速开始

设置环境变量

export JF_UUID="your-uuid"              # 开放平台用户唯一标识
export JF_APPKEY="your-appkey"          # 开放平台应用 Key
export JF_APPSECRET="your-appsecret"    # 开放平台应用密钥
export JF_MOVECARD=5                    # 签名算法偏移量 (0-9)
export JF_SN="your-device-sn"           # 设备序列号

使用技能

# 查询设备状态
python scripts/jf_open_pro_capture_livestream.py status

# 设备登录
python scripts/jf_open_pro_capture_livestream.py login

# 云抓图
python scripts/jf_open_pro_capture_livestream.py capture

# 获取直播地址
python scripts/jf_open_pro_capture_livestream.py livestream

# 获取 Token
python scripts/jf_open_pro_capture_livestream.py token

📋 环境变量

🛠️ 功能

1. 获取设备 Token - 通过设备序列号获取 24 小时有效的访问令牌
2. 设备登录认证 - 使用设备用户名/密码完成登录，获取 SessionID
3. 查询设备状态 - 获取设备在线状态、休眠状态、认证状态、IP 信息等
4. 设备云抓图 - 抓取设备实时图片（辅码流），图片地址有效期 24 小时
5. 获取直播地址 - 获取设备直播流地址（HLS/RTMP/FLV/WebRTC 等），默认有效期 10 小时

📖 详细文档

1. 获取设备 Token

接口: POST /gwp/v3/rtc/device/token

响应:

{
  "code": 2000,
  "data": [{
    "sn": "YOUR_DEVICE_SN",
    "token": "ZTA3NTRiODMzNHw0OGRlOGMxYzFjMjBhNGEzfHwx..."
  }]
}

注意: Token 有效期 24 小时，可缓存复用。

2. 查询设备状态

接口: POST /gwp/v3/rtc/device/status

状态判定表:

3. 设备云抓图

接口: POST /gwp/v3/rtc/device/capture/{deviceToken}

注意:

• ⚠️ 按调用次数计费 - 详见官网定价
• ⚠️ 图片有效期 24 小时 - 过期自动清除，需及时下载

4. 获取直播地址

接口: POST /gwp/v3/rtc/device/livestream/{deviceToken}

支持协议:

注意:

• ⚠️ 直播地址默认有效期 10 小时
• ⚠️ 低功耗设备 - 获取后 3 秒内必须播放

⚠️ 错误处理

📚 官方参考资料

• 杰峰开放平台: https://open.jftech.com/
• API 文档: https://docs.jftech.com/
• API 端点: api.jftechws.com (国际) / api-cn.jftech.com (中国大陆)