跳转至

Webcam 摄像头实时采集与快照捕获节点

节点核心功能 (What is it?)

Webcam 节点允许创作者直接从物理计算机或外部连接的摄像机设备中捕获实时图像快照。它是搭建实时视觉处理流程、开发交互式 AI 应用以及将现实世界的即时相机画面引入图像处理与分析管线的理想输入算子。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 直接从笔记本内置摄像头或外置 USB 摄像头拍摄静态照片；
  • 搭建近乎实时的计算机视觉与图像识别处理工作流；
  • 开发基于活体视频流或人像快照的交互式生成原型；
  • 即拍即修，捕获当前物理环境的照片供即时下游增强处理；
  • 搭建基于摄像头的自动化视觉巡检或定时监控抓拍管线。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 Webcam 节点。
  2. 在节点属性面板中点击 "Capture"（拍照捕获）按钮拍摄一张照片。
  3. 捕获的图像将立即可在 output 输出引脚处供下游消费。

参数输入插槽 (Parameters)

硬件与设备配置 (Camera Settings)

  • camera_index（0–10，默认 0）：目标摄像头的硬件物理索引标识（在挂载多个 USB/虚拟摄像头时用于切换设备）。
  • resolution：快照采集画质分辨率预设：
    • 640x480：标清标准分辨率（低开销、低延迟）；
    • 1280x720：720p HD 高清分辨率；
    • 1920x1080：1080p Full HD 全高清规格；
    • Custom：自定义物理像素宽高。
  • custom_width（像素）：当选用 "Custom" 规格时指定的自定义宽度。
  • custom_height（像素）：当选用 "Custom" 规格时指定的自定义高度。

抓拍模式配置 (Capture Settings)

  • auto_capture（布尔值，默认 false）：是否启用定时自动定时抓拍循环。
  • capture_interval（秒，默认 1）：定时自动抓拍的时间间隔步长。

输出引脚 (Outputs)

  • output：从指定摄像头采集编码生成的全新图像工件（ImageArtifact）。

典型工作流示例 (Example)

典型的摄像头抓拍与图像增强流程：

  1. 将 Webcam 节点添加至工作流画布。
  2. 配置摄像头参数：
    • 将 camera_index 保持为 0（默认主摄）；
    • 将 resolution 选为 "1280x720" 获得高清画质。
  3. 点击 "Capture" 按钮完成实时抓拍。
  4. 将 output 引脚连接至 DisplayImage 查看捕获的照片。
  5. （可选）进一步连入 DescribeImage 或抠图滤镜节点进行多模态视觉理解与图像二次处理。

关键技术特性 (Important Notes)

  • 系统权限要求 (Camera Access)：节点工作依赖操作系统层级或宿主环境授予的摄像头设备硬件访问权限。
  • 低延迟瞬时捕获：按下 "Capture" 按钮触发瞬时帧捕获，并即时编码为图像工件。
  • 多机位支持 (Multiple Cameras)：通过递增 camera_index（0, 1, 2...）可轻松枚举并访问多机位摄录设备。

常见问题与排查 (Common Issues)

  • 未检测到摄像头设备 (No Camera Found)：请检查摄像头 USB 物理连线是否牢固，并确认未被 Zoom、OBS 或系统相机等其他后台进程独占占用。
  • 权限被拒 (Permission Denied)：请在系统隐私设置中为运行环境（或浏览器客户端）开启相机访问权限。
  • 抓拍画面模糊或噪点多：在光线充足的环境下拍摄，并在 resolution 中切换为更高分辨率（如 1080p）。

底层技术执行机制 (Technical Details)

节点通过跨平台硬件视频捕获接口与设备驱动进行交互：

  1. 设备句柄枚举：通过 OpenCV 类似的原生视频采集后端尝试打开 /dev/video* 或 DirectShow/MediaFoundation 设备索引句柄。
  2. 分辨率协商：向摄像头固件发送宽高采样协商请求，若硬件不支持该尺寸则自动降级为最近似的原生采样比率。
  3. 单帧抽取与压合：在稳定捕获帧流后锁定曝光，抽取清晰关键帧并将其打包为高质量图像内存工件。