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

本页目录

  • 下载
  • 功能
  • 本地查看器和 OAK4 默认应用
  • 管道
  • 流和管道图
  • Streams 功能在高级管线中
  • Stream 面板
  • 故障排除设备发现
  • 发行说明
  • 版本 1.6.3 (2025 年 12 月 18 日)
  • 版本 1.5.53 (2025 年 12 月 8 日)

OAK Viewer

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

下载

Linux

OAK Viewer 1.6.3 for Ubuntu 24.04 / 22.04 (x86)

macOS

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

Windows

OAK Viewer 1.6.3 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。当通过互联网连接时，它可能会更低，具体取决于实际连接情况。在这种情况下，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 中创建的活动管道。它提供了所有节点、其参数和连接的可视化表示。

Streams 功能在高级管线中

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

Stream 面板

每个流面板都有一个唯一的名称、分辨率和几个性能指标。它包括以下 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 和以太网），请设置路由，以便通过正确的接口访问摄像机子网。

发行说明

版本 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 的 Flood Light 和 Dot Projector 徽章。
  • 改进了 Neural Depth 配置。
  • 包含 Visualizer 2.68.8（改进了响应能力、更好的 NV12 解码、更改点云摄像头的能力）。
  • 修复了当 OAK 4 上已运行其他应用程序时显示的提示信息。