IP Camera 技能

通过 RTSP（快照、录制）和 ONVIF（云台控制、预置位、发现）控制IP摄像头。

已在TP-Link Tapo/Vigi上测试。兼容海康威视、大华、Reolink、Amcrest、Axis及其他支持ONVIF Profile S/T的摄像头。

安装

bash
bash skills/ipcam/install.sh

然后可自动发现摄像头或手动配置：

bash

自动发现并添加

或编辑配置

配置格式

json
{
default: front-door,
cameras: {
front-door: {
ip: 192.168.1.100,
username: admin,
password: secret,
rtsp_port: 554,
onvif_port: 2020,
rtspmainpath: stream1,
rtspsubpath: stream2
}
}
}

• - onvifport：2020（TP-Link）、80（海康威视/大华）、8000、8080
• rtspmainpath / rtspsubpath：使用 ptz.py stream-uri --save 自动检测
• 环境变量覆盖：CAMIP、CAMUSER、CAMPASS、CAMRTSPPORT、CAMONVIFPORT

使用方法

RTSP（camera.sh）

bash
camera.sh snapshot # 捕获帧
camera.sh --cam cam2 snapshot /tmp/cam.jpg # 指定摄像头
camera.sh record 15 # 录制15秒片段
camera.sh stream-url sub # 打印子流URL
camera.sh info # 测试连接
camera.sh list-cameras # 列出已配置摄像头

PTZ（ptz.py）

bash
ptz.py status # 当前位置
ptz.py move left # 向左平移（速度0.5，持续0.5秒）
ptz.py move zoomin 0.8 1.0 # 放大，速度0.8，持续1秒
ptz.py goto 0.5 -0.2 0.0 # 绝对平移/倾斜/变焦
ptz.py home # 归位
ptz.py stop # 停止移动
ptz.py preset list # 列出预置位
ptz.py preset goto 1 # 转到预置位1
ptz.py preset set 2 Door # 将当前位置保存为预置位

发现与流URI

bash
ptz.py discover # 扫描网络中的ONVIF摄像头
ptz.py discover --add # 扫描并添加到配置
ptz.py stream-uri # 从ONVIF查询RTSP路径
ptz.py stream-uri --save # 将路径保存到配置

多摄像头：在任何命令中使用 --cam <名称>。

方向

left、right、up、down、zoomin、zoomout、upleft、upright、downleft、downright

故障排除

• - RTSP失败：检查IP/端口/防火墙。使用 ptz.py stream-uri 验证路径。摄像头可能限制并发RTSP连接（尝试关闭其他查看器）。
• ONVIF失败：验证ONVIF端口以及摄像头网页界面中是否启用了ONVIF。尝试常用端口：2020、80、8000、8080。
• 未发现摄像头：确保在同一子网、ONVIF已启用、UDP多播未被阻止。
• PTZ不工作：并非所有摄像头都支持PTZ。检查ONVIF Profile S支持情况。
• 认证错误：检查用户名/密码。特殊字符会自动进行URL编码。