Install
openclaw skills install jf-open-pro-livestreamjf-open-pro-livestream
🔑API key required杰峰设备直播预览技能（开发版）。支持多端集成实时视频播放，兼容 HLS、RTSP、RTMP、FLV、MP4、WebRTC 等主流协议，适配 H.264/H.265 设备。
jf-open-pro-livestream - 杰峰设备直播预览技能（开发版）
技能描述
支持杰峰设备实时直播地址获取，适用于多端集成播放：
- 多协议支持 - HLS、RTSP、RTMP、FLV、MP4、WebRTC
- 多端适配 - Web、微信小程序、H5、第三方播放器
- 编码兼容 - H.264、H.265 视频编码
- 低时延 - WebRTC 低时延预览（仅 H.264）
适用场景：
- Web 页面嵌入实时监控
- 微信小程序视频播放
- 第三方播放器集成
- 移动端 APP 视频预览
触发词
- 获取直播地址 / 直播预览 / 实时播放
- 视频流地址 / 获取播放 URL / 直播流
前置条件
设备要求
- 设备在线 - 设备需在线且可访问
- 低功耗设备 - 获取 URL 后必须在 3 秒内播放
- 编码配置 - H.265 设备建议使用特定协议
必需配置
- 签名算法 - 使用杰峰官方移位加密算法生成 signature
- 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
- 设备绑定 - 设备需先绑定到开放平台账号
环境变量
| 变量名 | 说明 | 默认值 | 必需 |
|---|---|---|---|
JF_UUID | 开放平台用户 uuid | - | ✅ |
JF_APP_KEY | 开放平台应用 appKey | - | ✅ |
JF_APP_SECRET | 开放平台应用密钥 | - | ✅ |
JF_MOVE_CARD | 移动卡标识（用于签名） | 2 | ✅ |
JF_DEVICE_SN | 设备序列号 | - | ✅ |
JF_DEVICE_TOKEN | 设备接口访问令牌 | - | ✅ |
JF_DEVICE_USERNAME | 设备用户名 | admin | ❌ |
JF_DEVICE_PASSWORD | 设备密码 | - | ❌ |
JF_ENDPOINT | API 接入地址 | api-cn.jftechws.com | ❌ |
API 接口
| 功能 | 地址 | 方法 | 需要 Token | 需要在线 |
|---|---|---|---|---|
| 获取直播地址 | POST /gwp/v3/rtc/device/livestream/{token} | POST | ✅ | ✅ |
支持的协议
FLV 协议族
| 协议 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| FLV | flv | 标准 FLV 封装 | Web 端（H.264/H.265） |
| FLV 增强 | flv-enhanced | FLV-enhanced 封装 | VLC 4.0+、ffmpeg 6.1+ |
| WS-FLV | ws-flv | WebSocket FLV | Web 端低时延 |
| WS-FLV 增强 | ws-flv-enhanced | WebSocket FLV-enhanced | Web 端低时延 |
| WS 私有 | ws-pri | 杰峰私有协议 | 杰峰 WEB 播放器 |
HLS 协议族
| 协议 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| HLS-TS | hls-ts | HLS+TS 切片 | iOS、Safari |
| HLS-FMP4 | hls-fmp4 | HLS+fMP4 切片 | iOS、Safari |
RTMP 协议族
| 协议 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| RTMP-FLV | rtmp-flv | RTMP+FLV | 微信小程序 |
| RTMP 增强 | rtmp-enhanced | RTMP+FLV-enhanced | 微信小程序 |
RTSP 协议族
| 协议 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| RTSP-SDP | rtsp-sdp | RTSP 标准协议 | VLC、FFmpeg |
| RTSP 私有 | rtsp-pri | RTSP 私有协议 | 杰峰客户端 |
MP4 协议
| 协议 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| MP4 | mp4 | HTTP+MP4 | Chrome 23+ |
WebRTC 协议
| 协议 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| WebRTC | webrtc | WebRTC 协议 | 仅 H.264，低时延 |
使用场景推荐
微信小程序
| 组件 | 支持协议 |
|---|---|
| live-player | http-flv、rtmp、hls |
H5 页面/Web 端
| 播放方式 | 支持协议 | 说明 |
|---|---|---|
<video> 标签 | hls、mp4 | 仅 H.264 |
| flv.js | http-flv | 需要 H.264 |
| WebRTC API | webrtc | 仅 H.264，低时延 |
| 杰峰 WEB 播放器 | 全部 | 支持 H.264/H.265 |
第三方播放器
| 播放器 | 推荐协议 |
|---|---|
| VLC 4.0+ | flv-enhanced、rtsp |
| FFmpeg 6.1+ | flv-enhanced、rtsp |
| PotPlayer | rtsp、rtmp |
使用示例
环境准备
# 设置环境变量
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. 获取 FLV 直播地址（Web 端推荐）
cd ~/.openclaw/workspace/skills/developer/jf-open-pro-livestream/scripts
# 获取 FLV 地址（标清辅码流）
python3 livestream.py --action get-url --protocol flv
# 获取 FLV 地址（高清主码流）
python3 livestream.py --action get-url --protocol flv --stream 0
2. 获取 HLS 地址（iOS/小程序推荐）
# 获取 HLS-TS 地址
python3 livestream.py --action get-url --protocol hls-ts
# 获取 HLS-FMP4 地址
python3 livestream.py --action get-url --protocol hls-fmp4
3. 获取 RTMP 地址（微信小程序）
# 获取 RTMP-FLV 地址
python3 livestream.py --action get-url --protocol rtmp-flv
4. 获取 WebRTC 地址（低时延，仅 H.264）
# 获取 WebRTC 地址（仅支持 H.264 设备）
python3 livestream.py --action get-url --protocol webrtc
5. 获取 RTSP 地址（VLC/FFmpeg）
# 获取 RTSP 地址
python3 livestream.py --action get-url --protocol rtsp-sdp
6. 设置 URL 有效期
# 设置 24 小时有效期
python3 livestream.py --action get-url --protocol flv --expire-hours 24
# 设置 7 天有效期
python3 livestream.py --action get-url --protocol flv --expire-days 7
请求参数
| 参数 | 类型 | 必需 | 默认值 | 说明 |
|---|---|---|---|---|
| channel | string | ✅ | 0 | 通道号（0=第一通道） |
| stream | string | ✅ | 1 | 码流（0=高清主码流，1=标清辅码流） |
| protocol | string | ✅ | - | 播放协议 |
| username | string | ✅ | admin | 设备登录用户名 |
| password | string | ❌ | `` | 设备登录密码 |
| expireTime | string | ❌ | 10 小时 | URL 有效期（毫秒时间戳） |
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 平台状态码（2000=成功） |
| msg | string | 响应消息 |
| data | object | 响应数据 |
| ├─ Ret | int | 设备状态码（100=成功） |
| ├─ url | string | 播放地址 URL |
| └─ retMsg | string | 设备错误信息（失败时） |
状态码
平台状态码
| code | 说明 | 处理建议 |
|---|---|---|
| 2000 | 成功 | - |
| 28007 | Header 参数错误 | 检查 uuid、appKey、timeMillis、signature |
| 40103 | 无效 Token | deviceToken 过期，重新获取 |
| 50000 | 服务器内部错误 | 联系杰峰技术支持 |
设备状态码（Ret）
| Ret | 说明 | 处理建议 |
|---|---|---|
| 100 | 成功 | - |
| 101 | 登录连接超时 | 检查设备是否在线 |
| 106 | 用户名或密码错误 | 检查设备凭证 |
注意事项
- URL 有效期 - 默认 10 小时，可自定义 30 秒 -720 天
- 低功耗设备 - 获取 URL 后必须在 3 秒内播放
- 设备休眠 - 低功耗设备需先唤醒再获取 URL
- 编码格式 - WebRTC 仅支持 H.264 设备
- H.265 设备 - 建议使用 flv-enhanced 或 ws-flv-enhanced
- 重复使用 - 有效期内 URL 可重复使用，减少起播时长
- 单路限制 - 部分设备同时只支持一路直播流
相关文件
| 文件 | 说明 |
|---|---|
SKILL.md | 技能文档 |
scripts/livestream.py | Python 执行脚本 |
scripts/crypto.py | 签名/时间戳加密工具（复用） |