HDMI 采集卡实时预览

1. 运行环境（必须）

• 浏览器摄像头 API 仅在 安全上下文 下可用：请通过 localhost 或 https 访问，直接双击 file:// 打开可能无法枚举设备名称。
• 本地起服务（任选其一）：
  • 本目录下执行 python3 -m http.server 8000，然后访问 http://localhost:8000
  • 或使用 VSCode 插件 Live Server 打开本文件
• 首次打开时浏览器会请求摄像头权限，请选择“允许”。

2. 摄像机建议设置（SONY HVR-Z5C）

• HDMI 输出优先设为 720p 或 1080p 下变换，避免 1080i 隔行扫描在预览/截图中出现梳齿状锯齿。
• 菜单中开启 Clean Output / 关闭信息显示，避免把摄像机 OSD 参数一起采集进画面。
• 户外强光下按需启用 ND 滤镜，保证快门与曝光正常。
• 摄像机需处于拍摄/待机出图状态（非关机、非回放菜单界面）。

3. 常见黑屏 / 无信号排查

• 画面全黑且实测帧率为 0：检查摄像机是否已开机并出图、HDMI 线是否插紧、采集卡 HDMI IN / Type-C 接口是否接对。
• 报错 NotReadableError / Could not start video source：设备被其他软件（OBS、腾讯会议等）占用，关闭后重试。
• 报错 NotAllowedError / Permission denied：浏览器权限被拒绝，点击地址栏左侧锁形图标重置权限。
• 下拉框里看不到设备名称只有“摄像头 1”：说明页面未获得权限或不在 localhost/https 环境。
• 本页面内置黑屏检测：连续数秒画面平均亮度接近 0 时会在状态栏提示“疑似无信号”。