概览硬件软件云平台
此页面由 AI 自动翻译。查看英文原版
OAK 应用
DepthAI
AI
软件栈
故障排除

本页目录

  • 下载
  • 功能
  • 本地查看器和 OAK4 默认应用
  • 管道
  • 流和管道图
  • Advanced Pipeline 中的 Streams 功能
  • Stream panel
  • 故障排除设备发现
  • Release Notes
  • Version 3.2.1 (June 8, 2026)
  • Version 3.2.0 (June 8, 2026)
  • Version 3.0.2 (June 5, 2026)
  • Version 2.5.2 (June 2, 2026)
  • Version 2.5.1 (May 27, 2026)
  • Version 2.4.11 (May 25, 2026)
  • Version 1.6.3 (December 18, 2025)
  • Version 1.5.53 (December 8, 2025)

OAK Viewer

OAK Viewer 是一款 GUI 应用程序，可让您通过实时可视化其输出来轻松评估相机。

下载

Linux

OAK Viewer 3.2.1 for Ubuntu 24.04 / 22.04 (x86)

macOS

OAK Viewer 3.2.1 for macOS 12+ (ARM) | macOS 12+ (x86)

Windows

OAK Viewer 3.2.1 for 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。根据实际连接情况，通过 Internet 连接时可能会较低。在这种情况下，URL 将如下所示：https://viewer.luxonis.app/1.2.1/?t=xxxx。特定 URL 可以在应用程序日志中找到，或者可以通过 Hub 远程打开 UI，其中提供了正确的 URL。

管道

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

流和管道图

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

Advanced Pipeline 中的 Streams 功能

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

Stream panel

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

故障排除设备发现

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

Release Notes

Version 3.2.1 (June 8, 2026)

  • Backported DepthAI version due to Windows and Mac issues.
  • Reverted Point Cloud Alignment fix due.

Version 3.2.0 (June 8, 2026)

  • Fixed Windows and MacOS start device issues.

Version 3.0.2 (June 5, 2026)

  • Improved performance across the board.
  • Improved point cloud precision & responsiveness.
  • Improved error state handling, including cases where the app is already running or the device is offline.
  • Fixed device disconnect handling.
  • Added detection of insufficient device power.
  • Several bug fixes and UI/UX improvements.

Version 2.5.2 (June 2, 2026)

  • Improvements to stability and bugfixing.

Version 2.5.1 (May 27, 2026)

  • Fix crashes when running with hardware acceleration enabled on macOS and Windows.
  • Fix oakctl dependencies on Windows.
  • Improve error handling during OS update.
  • Improve error handling for cameras without a color sensor.

Version 2.4.11 (May 25, 2026)

  • RVC4 USB support
  • Initial TOF support (RVC2 only)
  • Expanded device support
  • Stability improvements
  • Neural Assisted Stereo (RVC4 only)

Version 1.6.3 (December 18, 2025)

  • Includes oakctl 0.17.0, with more robust handling of device setup and adoption to Hub.
  • Includes DAI 3.2.1 and DAI Nodes 0.3.6.
  • Improvements to OTA update flows.
  • Improved stream and annotation rendering performance.
  • Error toasts are now properly displayed when configuration changes fail.
  • Moved the distance slider to the top-right corner.
  • Added a link to USB camera troubleshooting documentation.

Version 1.5.53 (December 8, 2025)

  • Full support for OAK 4 device setup and adoption to Luxonis Hub, including migration to a different team when the device is already in Hub.
  • Fixed video encoder issues on Windows, resolving green stripe artifacts.
  • Fixed issues with loading information about connected devices.
  • Fixed connection issues when multiple devices are present.
  • Improved UI responsiveness across different resolutions and corrected the positioning of info toasts.
  • Corrected Flood Light and Dot Projector badges for OAK 4 D.
  • Improved Neural Depth configuration.
  • Includes Visualizer 2.68.8 (Improved responsiveness, Better NV12 decoding, Ability to change the point cloud camera).
  • Fixed the toast shown when another application is already running on OAK 4.