RTSP 视频流播放器

播放网络 RTSP 视频流并支持实时画面查看、截图保存、录制片段。优先使用 python3 + opencv-python（通过 exec(action="acquire", package="opencv-python") 按需安装），备选 ffmpeg。

何时使用

• 用户要求播放 RTSP 网络视频流（例如 rtsp://192.168.1.100:554/stream1）。
• 用户要求查看 IP 摄像头/监控设备的实时画面。
• 用户要求从视频流中截取一帧保存为图片（降级场景）。
• 用户要求录制 RTSP 流的一段视频保存到本地。
• 用户要求检测 RTSP 流是否可用/在线。
• 用户要求定时/周期截图，例如「每5秒截一张图」「每30秒截图」「每5分钟截一张」。
• 用户要求将多张截图合成为 GIF 动图，例如「把截图做成动图」「转成 GIF」「输出 GIF」。

何时不用

• 播放本地视频文件（.mp4、.avi 等）→ 使用 media-processing 技能。
• 视频格式转换或编辑 → 使用 media-processing 技能（ffmpeg）。
• 网络摄像头 USB 设备本地调用 → 使用 desktop + 摄像头驱动。
• 图片/图像处理 → 使用 image-processing 技能。

可用能力

知识

RTSP URL 格式

rtsp://[username:password@]host[:port]/path

• 无鉴权： rtsp://192.168.1.100:554/stream1
• 带鉴权： rtsp://admin:password@192.168.1.100:554/h264/ch1/main/av_stream
• 默认端口为 554，可省略
• 常见摄像头路径后缀因品牌而异：/live、/stream1、/h264/ch1/main/av_stream

能力路径优先级

最佳路径（优先尝试）→ python3 + opencv-python：
- 先执行 exec(action="acquire", package="opencv-python") 安装
- 通过 cv2.VideoCapture(rtsp_url) 打开流
- 逐帧读取并处理（保存截图或逐帧显示）

备选路径 → ffmpeg：
- ffmpeg 可直接播放 RTSP 流
- ffmpeg -rtsp_transport tcp -i rtsp://...（TCP 传输更稳定）
- ffmpeg -i rtsp://... -vframes 1 output.jpg（截图一帧）

RTSP 传输协议

建议：跨网络环境始终使用 TCP 传输（-rtsp_transport tcp 参数）。

opencv-python 关键参数

cap = cv2.VideoCapture("rtsp://admin:pass@192.168.1.100:554/stream1")
cap.set(cv2.CAP_PROP_BUFFERSIZE, 1)       # 减小缓冲，降低延迟
cap.set(cv2.CAP_PROP_FPS, 30)             # 设置帧率
ret, frame = cap.read()                   # 读取一帧
if ret:
    cv2.imwrite("snapshot.jpg", frame)    # 保存截图

定时截图参数说明

用户可通过自然语言指定截图间隔，支持的单位：

核心代码模式：

import cv2, time, os
interval = 5  # 用户指定的间隔（秒）
total = 10    # 总截图次数（可选，不设则持续直到超时）
count = 0

cap = cv2.VideoCapture(url)
while True:
    ret, frame = cap.read()
    if ret:
        path = f"snapshot_{int(time.time())}.jpg"
        cv2.imwrite(path, frame)
        count += 1
        print(f"第{count}张: {path}")
    if total and count >= total:
        break
    time.sleep(interval)
cap.release()

截图合成 GIF 动图

Pillow（已预装）可将多张截图合成为 GIF 动图。支持参数：

核心代码模式：

from PIL import Image
import glob

frames = []
# 按文件名排序，确保 GIF 帧顺序正确
images = sorted(glob.glob("snapshot_*.jpg"))
for f in images:
    im = Image.open(f)
    frames.append(im.copy())
    im.close()

# 合成 GIF，duration 单位毫秒
frames[0].save(
    "rtsp_animation.gif",
    save_all=True,
    append_images=frames[1:],
    duration=500,     # 每帧 0.5 秒
    loop=0            # 无限循环
)

> 注意：GIF 文件全部由 Pillow 处理，与 ffmpeg 无关。Pillow 已预装，但若遇到 unknown file extension: .gif 错误，需重新安装带 GIF 编码支持的 Pillow：exec(action="acquire", package="Pillow")。若截图数量过多（>100张），建议提高 duration 或只取部分帧合成，避免 GIF 文件过大。

场景示例

场景 1：查看 RTSP 流并截图保存（推荐路径）

用户要求：「帮我查看摄像头 rtsp://192.168.1.100:554/stream1 的画面。」

# 安装 opencv-python
exec(action="acquire", package="opencv-python")

# 用 OpenCV 打开 RTSP 流并截图
exec(command="python3 -c \"
import cv2
cap = cv2.VideoCapture('rtsp://192.168.1.100:554/stream1')
cap.set(cv2.CAP_PROP_BUFFERSIZE, 1)
ret, frame = cap.read()
if ret:
    cv2.imwrite('rtsp_snapshot.jpg', frame)
    print('截图保存成功: rtsp_snapshot.jpg')
else:
    print('无法读取 RTSP 流')
cap.release()
\"")

场景 2：使用 ffmpeg 录制 RTSP 片段

用户要求：「录制摄像头 rtsp://admin:pass@camera.example.com:554/live 的 10 秒片段。」

exec(command="ffmpeg -rtsp_transport tcp -i 'rtsp://admin:pass@camera.example.com:554/live' -t 10 -c copy rtsp_clip.mp4")

输出：录制完成，文件为 rtsp_clip.mp4。

场景 3：检测 RTSP 流可用性

用户要求：「检查 rtsp://192.168.1.100:554/stream1 这个摄像头是否在线。」

exec(command="timeout 10 ffprobe -v quiet -print_format json -show_streams 'rtsp://192.168.1.100:554/stream1' 2>&1 || echo 'UNAVAILABLE'")

如果输出包含 codec_type 等流信息，说明摄像头在线；否则显示 UNAVAILABLE。

场景 4：降级 - 没有 opencv 和 ffmpeg 时，提示安装引导

用户要求：「播放这个 RTSP 流 rtsp://192.168.1.100:554/stream1。」

exec(action="acquire", package="opencv-python")

若 acquire 失败（如沙箱无网络），回复用户：
> 当前环境不支持实时播放 RTSP 视频流。建议：
> 1. 使用 VLC 播放器（vlc rtsp://...）在本地播放
> 2. 让管理员在数字员工平台上安装 ffmpeg 后重试

场景 6：定时截图并合成 GIF 动图

用户要求：「每3秒截一张摄像头画面，截5张，然后做成 GIF 动图。」

# 安装 opencv-python（如未安装）
exec(action="acquire", package="opencv-python")

# 定时截图：每3秒截一张，共5张
exec(command="python3 -c \"
import cv2, time, os

url = 'rtsp://admin:pass@192.168.1.100:554/stream1'
os.environ['OPENCV_FFMPEG_CAPTURE_OPTIONS'] = 'rtsp_transport;tcp'

cap = cv2.VideoCapture(url, cv2.CAP_FFMPEG)
cap.set(cv2.CAP_PROP_BUFFERSIZE, 1)

interval = 3
total = 5
count = 0

for i in range(total):
    ret, frame = cap.read()
    if ret:
        ts = int(time.time())
        path = f'snapshot_{ts}.jpg'
        cv2.imwrite(path, frame)
        count += 1
        print(f'第{count}张: {path}')
    else:
        print(f'第{i+1}次: 读取失败')
    time.sleep(interval)

cap.release()
print(f'截图完成: 共{count}张')
\"")

# 将截图合成 GIF 动图
exec(command="python3 -c \"
from PIL import Image
import glob

images = sorted(glob.glob('snapshot_*.jpg'))
if not images:
    print('没有找到截图文件')
else:
    frames = []
    for f in images:
        im = Image.open(f)
        frames.append(im.copy())
        im.close()

    gif_path = 'rtsp_animation.gif'
    frames[0].save(
        gif_path,
        save_all=True,
        append_images=frames[1:],
        duration=500,    # 每帧0.5秒
        loop=0
    )
    print(f'GIF 生成成功: {gif_path}')
    print(f'帧数: {len(frames)}, 文件大小: {__import__(\"os\").path.getsize(gif_path)//1024}KB')
\"")

用户要求参考：「截10张，每5秒一张，做成每帧0.2秒的 GIF」→ interval=5, total=10, duration=200

用户要求：「每隔5秒截一张摄像头画面，截10张。」

# 安装 opencv-python（如未安装）
exec(action="acquire", package="opencv-python")

# 定时截图：每5秒截一张，共10张
exec(command="python3 -c \"
import cv2, time, os

url = 'rtsp://admin:pass@192.168.1.100:554/stream1'
os.environ['OPENCV_FFMPEG_CAPTURE_OPTIONS'] = 'rtsp_transport;tcp'

cap = cv2.VideoCapture(url, cv2.CAP_FFMPEG)
cap.set(cv2.CAP_PROP_BUFFERSIZE, 1)

interval = 5   # 间隔秒数
total = 10     # 截图张数
count = 0

for i in range(total):
    ret, frame = cap.read()
    if ret:
        ts = int(time.time())
        path = f'snapshot_{ts}.jpg'
        cv2.imwrite(path, frame)
        count += 1
        print(f'第{count}张: {path} ({frame.shape[1]}x{frame.shape[0]})')
    else:
        print(f'第{i+1}次: 读取失败')
    time.sleep(interval)

cap.release()
print(f'完成: 共截图{count}张，间隔{interval}秒')
\"")

用户要求参考：「帮我每30秒截一次摄像头画面」→ 将 interval 改为 30
用户要求参考：「每5分钟截一张，截1小时」→ interval=300, total=12

约束

• 不存储或输出用户提供的 RTSP 鉴权凭据。 密码部分应保持安全处理。
• 不通过 browser 或 read 工具访问 RTSP URL（它们是应用层协议，不支持 RTSP）。
• 优先使用 TCP 传输模式（-rtsp_transport tcp）提高稳定性。
• 截图的图片文件保存在当前工作目录并告知用户路径。
• 长时录制需设置合理的超时时间（默认 -t 30 限制30秒），避免无限阻塞。
• 不猜测 RTSP 地址。格式存疑时要求用户提供完整 URL（包括端口和路径）。

异常场景

降级策略

验证闭环