jf-open-pro-device-osd - 杰峰设备 OSD 水印设置技能（开发版）

技能描述

支持杰峰设备 OSD（On-Screen Display）水印配置功能：

• 单行 OSD 配置 - 获取/设置单行 OSD 叠加配置
• 多行 OSD 配置 - 获取/设置多行 OSD 叠加配置
• 通道标题 - 设置通道名称显示
• 时间标题 - 设置时间戳显示属性和位置
• 隐私区域 - 设置画面隐私遮挡区域

触发词

• 设置 OSD 水印 / 查询 OSD 配置
• 通道标题设置 / 时间标题设置
• 隐私区域 / 视频水印

前置条件

必需配置

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

环境变量

API 接口

核心功能

1. 单行 OSD 配置（AVEnc.VideoWidget）

API: POST /gwp/v3/rtc/device/getconfig/{token} / setconfig/{token}

Name: AVEnc.VideoWidget

配置项：

2. 多行 OSD 配置

API: POST /gwp/v3/rtc/device/getconfig/{token} / setconfig/{token}

Name: AVEnc.VideoOSD

配置项： 支持多行文本叠加配置

使用示例

环境准备

# 设置环境变量（使用占位符，请替换为实际值）
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. 查询单行 OSD 配置

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

# 查询当前 OSD 配置
python3 osd_config.py --action get-single

2. 设置通道标题

# 设置通道标题
python3 osd_config.py --action set-channel-title \
  --title "大门摄像头" \
  --enable

# 关闭通道标题
python3 osd_config.py --action set-channel-title \
  --title "大门摄像头" \
  --disable

3. 设置时间标题

# 启用时间标题显示
python3 osd_config.py --action set-time-title --enable

# 设置时间标题位置
python3 osd_config.py --action set-time-title \
  --pos-x 100 --pos-y 50 \
  --enable

4. 设置隐私区域

# 添加隐私遮挡区域
python3 osd_config.py --action add-cover \
  --pos-x 1000 --pos-y 1000 \
  --width 500 --height 500

5. 查询多行 OSD 配置

# 查询多行 OSD 配置
python3 osd_config.py --action get-multi

坐标说明

相对位置坐标（RelativePos）

坐标值按比例转换为 0-8192 范围：

实际像素值
转换公式：坐标值 = (像素值 / 总像素) × 8192

示例：
- 画面宽度 1920 像素
- 标题左上角 X 坐标 100 像素
- 转换后：(100 / 1920) × 8192 ≈ 427

坐标格式： [x1, y1, x2, y2]

• x1, y1: 左上角坐标（有效）
• x2, y2: 右下角坐标（仅设置左上角时有效）

颜色格式

RGBA 颜色字符串

格式："0xRRGGBBAA"

• RR: 红色分量（00-FF）
• GG: 绿色分量（00-FF）
• BB: 蓝色分量（00-FF）
• AA: 透明度分量（00-FF，00=完全透明，FF=完全不透明）

示例：

• "0x000000FF" - 黑色，不透明
• "0xFFFFFFFF" - 白色，不透明
• "0x00000080" - 黑色，半透明

状态码

平台状态码

设备状态码（Ret）

注意事项

1. 坐标范围 - 坐标值必须在 0-8192 范围内
2. 颜色格式 - 使用 0xRRGGBBAA 格式
3. 叠加使能 - EncodeBlend 控制录像叠加，PreviewBlend 控制预览叠加
4. 隐私区域 - 设置后画面相应区域会被遮挡

相关文件

参考文档

• 杰峰开放平台