双向视频

双向视频可以将 Web 端电脑的摄像头画面发送到被控主机。启用后，BliKVM 会在被控主机上模拟出一个标准的 USB 摄像头；视频会议、相机或直播软件可以像使用普通摄像头一样选择它，无需在被控主机上安装额外驱动。

这里的“双向”表示视频可以沿两个方向传输：

• 被控主机的 HDMI 画面由 BliKVM 采集，并显示在 Web 控制台中；
• Web 端电脑的摄像头画面经 BliKVM 转发，并作为 USB 摄像头提供给被控主机。

适用范围

当前实现使用 RK3566 的硬件视频编解码能力以及 USB Device/UVC 功能，适用于支持该功能的 RK3566 版本 BliKVM。实际可用性还取决于所安装的系统和 Web 服务版本；如果设置页面中没有 Video/UVC 或 Web Camera 选项，请先升级到支持该功能的版本。

视频路径

被控主机到 Web 端：

被控主机 HDMI 输出
  → BliKVM HDMI 采集
  → WebRTC
  → Web 端浏览器

Web 端到被控主机：

Web 端摄像头
  → 浏览器 getUserMedia
  → WebRTC/WHIP（H.264）
  → BliKVM MediaMTX
  → RK3566 硬件解码、编码（MJPEG）
  → USB UVC
  → 被控主机

浏览器上传的视频使用 H.264，BliKVM 会在设备端完成硬件转换。被控主机最终识别到的是兼容性较好的 UVC 1.1 MJPEG 摄像头。

使用前准备

1. 使用 USB 数据线连接 BliKVM 的 USB Device/OTG 接口与被控主机。仅连接 HDMI 无法向被控主机提供虚拟摄像头。
2. 使用支持摄像头采集和 WebRTC 的现代浏览器打开 BliKVM Web 控制台。
3. 允许该站点访问 Web 端电脑的摄像头。浏览器通常要求通过 HTTPS 或 localhost 才能授予摄像头权限；通过公网访问时建议为 BliKVM 配置 HTTPS。
4. 确认被控主机没有被安全策略禁止使用 USB 摄像头。

启用双向视频

1. 启用 USB 视频设备

进入 BliKVM 的 USB Device 设置，在 USB 设备类别中启用 Video/UVC，然后应用配置。

应用配置时，USB Gadget 会重新绑定，被控主机上的虚拟键盘、鼠标、存储设备和摄像头可能短暂断开并重新枚举。这是正常现象，通常无需拔插 USB 线。

2. 选择视频规格

在 Camera/Web Camera 设置中选择要使用的 UVC 规格：

规格	分辨率	帧率	建议用途
720p30	1280 × 720	30 FPS	默认选项，画质和流畅度较好
480p30	640 × 480	30 FPS	网络或 USB 资源有限，但希望保持流畅
480p15	640 × 480	15 FPS	优先降低带宽和设备负载

切换规格会重建 UVC 配置，被控主机上的 USB 设备会短暂重新枚举。为避免规格不一致，每次只会向被控主机公布当前选中的一种分辨率和帧率。

3. 打开 Web 端摄像头

点击 Open Web Camera（打开 Web Camera），在浏览器权限窗口中选择摄像头并允许访问。

这一步只会把摄像头视频发布到 BliKVM，还不会自动发送给被控主机。如果电脑连接了多个摄像头，请在浏览器或页面的设备选择器中确认使用了正确的设备。

4. 转发到被控主机

打开 Forward to USB UVC。BliKVM 会接收浏览器视频，将其转换为 MJPEG，并写入模拟的 USB 摄像头。

然后在被控主机上打开相机、视频会议或直播软件，在摄像头列表中选择 BliKVM 的 USB 视频设备。如果应用是在启用 UVC 之前启动的，请关闭并重新打开应用，让它重新扫描摄像头。

关闭视频转发

不再使用时，可以关闭 Forward to USB UVC，停止从浏览器到被控主机的视频转发。该操作不会移除 UVC 设备，也不会影响虚拟键盘和鼠标。

如果希望被控主机完全移除虚拟摄像头，请回到 USB Device 设置并禁用 Video/UVC。禁用 USB 类别会触发一次 USB 设备重新枚举。

常见问题

浏览器无法打开摄像头

• 检查浏览器地址栏中的摄像头权限，确保没有阻止当前站点；
• 通过公网访问时使用 HTTPS；
• 关闭正在独占摄像头的其他应用；
• 在操作系统隐私设置中允许浏览器访问摄像头。

被控主机中看不到摄像头

• 确认 BliKVM 的 USB Device/OTG 接口已连接到被控主机，而不是只连接了 HDMI；
• 确认 USB Device 设置中的 Video/UVC 已启用；
• 重新打开被控主机上的相机应用，必要时重新插拔 USB 数据线；
• Windows 用户可以在“设备管理器”的“相机”或“图像设备”中检查 UVC 设备是否已枚举。

能看到摄像头，但没有画面

• 确认已经同时打开 Open Web Camera 和 Forward to USB UVC；
• 检查浏览器中的本地摄像头预览是否正常；
• 将规格切换为 480p15 或 480p30 后重试；
• 确认网络连接稳定，尤其是通过公网访问 BliKVM 时。

启用后键盘或鼠标短暂失效

启用 UVC 或切换视频规格时，BliKVM 需要重新配置复合 USB 设备，因此键盘和鼠标会短暂断开。等待被控主机完成 USB 重新枚举后应自动恢复。

如果没有恢复，请重新插拔 BliKVM 与被控主机之间的 USB 数据线，然后检查 USB Device 设置中键盘和鼠标类别是否仍然启用。

USB 配置提示端点资源不足

键盘、两种鼠标模式、大容量存储、麦克风和视频都会占用 USB 端点。当前实现会在应用配置前检查端点预算；如果所选组合超过硬件容量，请禁用不需要的 USB 类别后再启用 Video/UVC。

隐私提示

摄像头视频只有在浏览器授予权限并打开 Web Camera 后才会采集。使用完成后，建议关闭视频转发和 Web Camera，并通过浏览器的摄像头指示图标确认采集已经停止。