jf-open-pro-video-masking - 杰峰设备视频遮挡技能（开发版）

技能描述

支持杰峰云台设备的一键遮蔽功能：

• 开启遮蔽 - 摄像头转至最下方然后转至最右侧，关闭视频预览和录像
• 关闭遮蔽 - 摄像头恢复到原监控位置，恢复正常预览和录像
• 状态查询 - 查询当前遮蔽状态

适用场景：

• 家庭隐私保护
• 会议室隐私模式
• 定时遮蔽计划

触发词

• 开启遮蔽 / 关闭遮蔽 / 一键遮蔽
• 视频遮挡 / 隐私模式 / 遮蔽模式

前置条件

硬件要求

1. 云台设备 - 设备需支持 PTZ 功能
2. 能力集验证 - SystemFunction.SupportOneKeyMaskVideo 为 true

必需配置

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

环境变量

API 接口

核心功能

一键遮蔽（OneKeyMaskVideo）

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

Name: OPPTZControl

请求参数：

响应参数：

功能说明

开启遮蔽

当开启"一键遮蔽"后：

1. 摄像头动作 - 往下转至最下方，然后转至最右侧
2. 视频状态 - 关闭视频预览（无法查看实时画面）
3. 录像状态 - 停止录像（不录制任何内容）

适用场景：

• 家庭成员在家时保护隐私
• 会议室敏感会议期间
• 夜间不需要监控时

关闭遮蔽

当关闭"一键遮蔽"后：

1. 摄像头动作 - 自动恢复到原来的监控位置
2. 视频状态 - 恢复正常视频预览
3. 录像状态 - 恢复正常录像

适用场景：

• 家庭成员外出后恢复监控
• 会议结束后恢复监控
• 定时恢复监控计划

使用示例

环境准备

# 设置环境变量（使用占位符，请替换为实际值）
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-video-masking/scripts

# 开启一键遮蔽
python3 video_masking.py --action enable

2. 关闭遮蔽

# 关闭一键遮蔽
python3 video_masking.py --action disable

3. 查询遮蔽状态

# 查询当前遮蔽状态
python3 video_masking.py --action status

4. 切换遮蔽状态

# 切换遮蔽状态（开→关 或 关→开）
python3 video_masking.py --action toggle

状态码

平台状态码

设备状态码（Ret）

注意事项

1. 设备要求 - 设备需支持一键遮蔽功能（检查能力集）
2. deviceToken 有效期 - 24 小时，过期需重新获取
3. 设备在线要求 - 操作需要设备在线
4. 遮蔽位置 - 遮蔽时摄像头转到最下方和最右侧
5. 恢复位置 - 关闭遮蔽后自动恢复到原监控位置
6. 视频录像 - 遮蔽期间无法预览也不录像
7. 隐私保护 - 适用于家庭、会议室等隐私场景

相关文件

参考文档

• 杰峰开放平台