jf-open-pro-device-image-flip - 杰峰设备画面翻转技能（开发版）

技能描述

支持杰峰设备的画面翻转功能，基于杰峰开放平台 OpenAPI 实现：

• 画面左右翻转（镜像） - 水平翻转画面，类似镜子效果
• 画面上下翻转（倒置） - 垂直翻转画面，上下颠倒
• 翻转状态查询 - 查询当前画面翻转配置

适用场景：

• 摄像头倒装时需要上下翻转画面
• 摄像头镜像安装时需要左右翻转画面
• 特殊安装角度需要调整画面方向

触发词

• 查询画面翻转配置 / 设置画面翻转
• 开启左右翻转 / 关闭左右翻转
• 开启上下翻转 / 关闭上下翻转
• 画面镜像 / 画面倒置 / 摄像头翻转

前置条件

必需配置

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

环境变量

API 接口

配置名称： Camera.Param

核心功能

画面翻转参数（Camera.Param）

⚠️ 走廊模式影响

当开启走廊模式（CorridorMode）时，翻转效果会互换：

走廊模式取值：

• 0: 普通模式
• 1: 走廊模式，画面逆时针转 90 度
• 2: 画面逆时针旋转 180 度
• 3: 走廊模式，画面逆时针旋转 270 度

使用示例

环境准备

# 设置环境变量
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_ENDPOINT="api-cn.jftechws.com"

1. 查询画面翻转配置

cd ~/.openclaw/workspace/skills/developer/jf-open-pro-device-image-flip/scripts

python3 image_flip.py --action get-flip-config

2. 设置左右翻转（镜像）

# 开启左右翻转
python3 image_flip.py --action set-mirror --enable true

# 关闭左右翻转
python3 image_flip.py --action set-mirror --enable false

3. 设置上下翻转

# 开启上下翻转
python3 image_flip.py --action set-flip --enable true

# 关闭上下翻转
python3 image_flip.py --action set-flip --enable false

4. 同时设置左右和上下翻转

# 同时开启左右和上下翻转（相当于旋转 180 度）
python3 image_flip.py --action set-both --mirror true --flip true

# 同时关闭
python3 image_flip.py --action set-both --mirror false --flip false

5. 重置画面方向

# 重置为默认（不翻转）
python3 image_flip.py --action reset

翻转效果说明

左右翻转（PictureMirror / 镜像）

原始画面：        左右翻转后：
┌─────────┐      ┌─────────┐
│  ABCD   │      │   DCBA  │
│  1234   │  →   │   4321  │
│  EFGH   │      │   HGFE  │
└─────────┘      └─────────┘

适用场景：

• 摄像头镜像安装
• 画面需要水平对称

上下翻转（PictureFlip / 倒置）

原始画面：        上下翻转后：
┌─────────┐      ┌─────────┐
│  ABCD   │      │  EFGH   │
│  1234   │  →   │  1234   │
│  EFGH   │      │  ABCD   │
└─────────┘      └─────────┘

适用场景：

• 摄像头倒装（天花板安装）
• 画面需要垂直对称

组合效果

状态码

平台状态码

设备状态码（Ret）

注意事项

1. deviceToken 有效期 - 24 小时，过期需重新获取
2. 设备在线要求 - 配置类操作需要设备在线
3. 走廊模式影响 - 开启走廊模式时，翻转效果会互换
4. 立即生效 - 设置后画面会立即翻转，可能需要重新加载视频流
5. 配置保存 - 设置会保存到设备，重启后仍然生效
6. 通道号 - NVR 设备需要指定通道号（0-N）

相关文件

参考文档

• 杰峰开放平台