此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 下载
  • 功能
  • 本地查看器和 OAK4 默认应用程序
  • 管道
  • 流和管道图
  • 高级管道中的流功能
  • 流面板
  • 设备发现故障排除
  • 发布说明
  • 版本 4.1.6 (2026 年 9 月 24 日)
  • 版本 4.1.5 (2026 年 9 月 18 日)
  • 版本 3.9.8 (2026 年 9 月 1 日)
  • 版本 3.8.2 (2026 年 8 月 12 日)
  • 版本 3.7.0 (2026 年 7 月 20 日)
  • 版本 3.2.1 (2026 年 6 月 8 日)
  • 版本 3.2.0 (2026 年 6 月 8 日)
  • 版本 3.0.2 (2026 年 6 月 5 日)
  • 版本 2.5.2 (2026 年 6 月 2 日)
  • 版本 2.5.1 (2026 年 5 月 27 日)
  • 版本 2.4.11 (2026 年 5 月 25 日)
  • 版本 1.6.3 (2025 年 12 月 18 日)
  • 版本 1.5.53 (2025 年 12 月 8 日)
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包
最后更新
OAK Viewer 是一个 GUI 应用程序,允许您通过实时可视化其输出来轻松评估摄像头。

下载

Linux

OAK Viewer 4.1.6 适用于 Ubuntu 24.04 / 22.04 (x86) | Ubuntu 24.04 / 22.04 (ARM)

macOS

OAK Viewer 4.1.6 适用于 macOS 12+ (ARM) | macOS 12+ (x86)

Windows

OAK Viewer 4.1.6 适用于 Windows 10/11 (x86)

功能

本地查看器和 OAK4 默认应用程序

可以将 Viewer 作为本地应用程序运行,也可以作为在设备设置期间可以安装的默认应用程序运行。这两个版本都提供类似的功能。主要区别在于 OAK4 上的默认应用程序仅适用于设备本身。另一方面,本地版本在标题中包含一个设备选择器,显示 Viewer 可以检测到的所有 OAK 摄像头,包括通过以太网和 USB 可用的设备。Viewer 使用 DepthAI V3 进行连接,因此支持任何 RVC2 或 RVC4 设备。
本地版本使用 WebSocket 进行前端和后端之间的通信,因此它仅受本地网络速度的限制。默认应用程序支持两种模式。第一种模式涉及与设备的直接连接,通常使用 https://device-IP:9000。确切的 URL 可以在应用程序日志中找到。编码流要正常工作需要自签名证书。如果运行多个应用程序,则使用第二个端口 9001。建议在应用程序日志中验证确切的 URL。打开 Viewer 作为默认应用程序的第二个选项是通过远程访问。在内部,使用 WebRTC,因此理论上支持的带宽吞吐量在本地约为 400 Mbps。当连接通过互联网时,根据实际连接情况,可能会更低。在这种情况下,URL 将如下所示:https://viewer.luxonis.app/1.2.1/?t=xxxx。具体的 URL 可以在应用程序日志中找到,或者可以通过 Hub 远程打开 UI,其中提供了正确的 URL。

管道

您可以从四个预定义管道中进行选择。每个管道都使用自己的 DepthAI 管道。
  • Vision 3D:专注于主摄像头输出和点云。
  • Vision AI:专注于选定神经网络 (NN) 模型及其注释的输出。
  • 动态校准:您可以在此管道中重新校准您的设备。支持所有 OAK Series 2 全立体声系列(不包括 FFC)和 OAK Series 4 全立体声系列。了解更多。
  • 高级:允许深入配置所有功能并访问校准数据。

流和管道图

Viewer 中有两个主要选项卡可用。第一个是流。它显示设备可以提供的一组预定义流。这些流取决于支持的功能,例如主 RGB 摄像头、左/右摄像头(如果可用)、深度流、温度等。此外,还有一个来自选定 NN 模型的流。这些模型从 Luxonis Models ZOO 加载。如果选择了 YOLO 模型,则可以在 RGB 摄像头流上显示注释,依此类推。在流中,还有深度和点云,它们是基于深度和 RGB 数据在前端计算的,以实现带宽效率。所有这些功能都提供简单的配置选项。第二个选项卡是管道图。此选项卡显示 Viewer 后端在 DepthAI V3 中创建的活动管道。它提供了所有节点、其参数和连接的可视化表示。

高级管道中的流功能

流屏幕上提供以下操作:
  • 配置:允许配置传感器、立体深度和高级设置。
  • 神经网络:显示 Luxonis ZOO 中可以快速测试和配置的 NN 模型列表。
  • 流:显示设备上根据当前配置可用的所有流的列表。
  • 点云:显示基于深度数据并由 RGB 摄像头着色的实时点云。
  • 面板布局:提供一种快速设置可见面板布局的方法。

流面板

每个流面板都有唯一的名称、分辨率和几个性能指标。它包括以下 FPS 指标:
  • 摄像头:根据配置请求的 FPS。
  • 网络:通过网络传输的 FPS。
  • 解码:客户端解码的 FPS。
  • 渲染:客户端渲染的 FPS。
吞吐量计算为从 Viewer 后端通过网络实际传输到浏览器客户端的所有帧的总和。它不包括 DepthAI 和设备之间的流量。其他按钮提供控制哪些注释可见、面板位置和全屏模式的选项。

设备发现故障排除

  1. 更新到最新版本:
    • 在主机上运行 oakctl self-update。
    • 为摄像头运行 oakctl device update。
  2. 验证主机和摄像头在同一子网中,并且网络上未阻止广播流量。
  3. 检查主机上的防火墙规则:
    • 允许 11491/udp 用于发现。
    • 允许 11490/tcp 用于 XLink 连接。
  4. 暂时禁用 VPN 并再次测试。
  5. 如果主机有多个接口(例如 Wi-Fi 和以太网),请设置路由,以便通过正确的接口访问摄像头子网。

发布说明

版本 4.1.6 (2026 年 9 月 24 日)

  • 所有模型的默认神经深度 FPS 增加

版本 4.1.5 (2026 年 9 月 18 日)

  • 全面性能改进
  • 显著的稳定性改进
  • 重新设计的操作系统更新流程 (RVC4)
  • 电源状态处理 (RVC4)
  • macOS 版本现在使用 DMG 安装程序
  • UI/UX 改进

版本 3.9.8 (2026 年 9 月 1 日)

  • 增加了对 RVC2 设备引导加载程序更新的支持
  • 增加了对多个 RVC4 设备上更新 Luxonis OS 的支持
  • 增加了对 ARM 平台上的 Ubuntu 的支持 *
  • UI/UX 改进

版本 3.8.2 (2026 年 8 月 12 日)

  • RVC4 ToF 支持
  • 包含 oakctl 0.27.1 以支持最新设备和功能
  • 暗模式
  • UI/UX 改进

版本 3.7.0 (2026 年 7 月 20 日)

  • 点云对齐修复
  • OAK D SR 修复
  • 更新了旧版前端依赖项
  • 渲染性能和响应性优化

版本 3.2.1 (2026 年 6 月 8 日)

  • 由于 Windows 和 Mac 问题,回溯了 DepthAI 版本。
  • 由于 Windows 和 MacOS 问题,恢复了点云对齐修复。

版本 3.2.0 (2026 年 6 月 8 日)

  • 修复了 Windows 和 MacOS 启动设备问题。

版本 3.0.2 (2026 年 6 月 5 日)

  • 全面提升性能。
  • 提升点云精度和响应速度。
  • 改进错误状态处理,包括应用程序已运行或设备离线的情况。
  • 修复设备断开连接处理。
  • 增加了对设备供电不足的检测。
  • 修复了多项错误并改进了 UI/UX。

版本 2.5.2 (2026 年 6 月 2 日)

  • 稳定性改进和错误修复。

版本 2.5.1 (2026 年 5 月 27 日)

  • 修复了在 macOS 和 Windows 上启用硬件加速时崩溃的问题。
  • 修复了 Windows 上的 oakctl 依赖项。
  • 改进了操作系统更新期间的错误处理。
  • 改进了无彩色传感器的摄像头的错误处理。

版本 2.4.11 (2026 年 5 月 25 日)

  • RVC4 USB 支持
  • 初始 TOF 支持(仅限 RVC2)
  • 扩展设备支持
  • 稳定性改进
  • 神经辅助立体声(仅限 RVC4)

版本 1.6.3 (2025 年 12 月 18 日)

  • 包含 oakctl 0.17.0,具有更强大的设备设置和 Hub 采用处理能力。
  • 包含 DAI 3.2.1 和 DAI Nodes 0.3.6。
  • 改进了 OTA 更新流程。
  • 改进了流和注释渲染性能。
  • 配置更改失败时,现在会正确显示错误提示。
  • 将距离滑块移至右上角。
  • 添加了 USB 摄像头故障排除文档链接。

版本 1.5.53 (2025 年 12 月 8 日)

  • 全面支持 OAK 4 设备设置和 Luxonis Hub 采用,包括设备已在 Hub 中时迁移到其他团队。
  • 修复了 Windows 上的视频编码器问题,解决了绿色条纹伪影。
  • 修复了加载连接设备信息的问题。
  • 修复了存在多个设备时的连接问题。
  • 改进了不同分辨率下的 UI 响应能力,并纠正了信息提示的位置。
  • 纠正了 OAK 4 D 的泛光灯和点投影仪徽章。
  • 改进了神经深度配置。
  • 包含 Visualizer 2.68.8(改进了响应能力,更好的 NV12 解码,能够更改点云摄像头)。
  • 修复了当另一个应用程序已在 OAK 4 上运行时显示的提示。