# OAK Viewer

OAK Viewer 是一个 GUI 应用程序，允许您通过实时可视化输出来轻松评估摄像头。

## 下载

> 如果您通过
> [oakctl](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)
> 更新 OAK Viewer，则需要使用 0.15.0+ 版本才能获得最新的 OAK Viewer。

#### Linux

> Debian 软件包适用于 Ubuntu 24.04 / 22.04，支持 x86_64 (AMD64) 架构。

OAK Viewer 3.0.2 适用于 [Ubuntu 24.04 / 22.04 (x86)](https://oak-viewer-releases.luxonis.com/data/3.0.2/debian_x86_64/viewer.deb)

#### macOS

> Viewer 适用于 macOS 12 及更高版本，支持 ARM（Apple Silicon）和 x86_64（Intel）架构。

OAK Viewer 3.0.2 适用于 [macOS 12+ (ARM)](https://oak-viewer-releases.luxonis.com/data/3.0.2/macos_arm_64/Viewer.zip) | [macOS 12+
(x86)](https://oak-viewer-releases.luxonis.com/data/3.0.2/macos_x86_64/Viewer.zip)

#### Windows

> 请注意，您可能会收到 Microsoft Defender 的警告。Viewer 适用于 Windows 10/11，支持 x86_64（AMD64）架构。

OAK Viewer 3.0.2 适用于 [Windows 10/11 (x86)](https://oak-viewer-releases.luxonis.com/data/3.0.2/windows_x86_64/Viewer.msi)

## 功能

### 本地查看器与 OAK4 默认应用

> 请注意，查看器的所有功能仅在 Chrome 中有效。本地版本包含一个捆绑的 Chrome 浏览器。不过，网页版可以在任何浏览器中打开，但有一些限制。所有浏览器都应支持 RAW 流。编码流及其相关功能仅在 Chrome 中支持，因为它们需要完整的
> [WebCodecs API](https://developer.mozilla.org/en-US/docs/Web/API/VideoDecoder)
> ，而目前只有 Chrome 提供高质量和高性能的实现。

可以将查看器作为本地应用程序运行，也可以作为设备设置期间安装的默认应用程序运行。两个版本提供类似的功能。主要区别在于 OAK4 上的默认应用程序仅与设备本身配合使用。另一方面，本地版本在标题中包含一个设备选择器，显示查看器可以检测到的所有 OAK
摄像头，包括通过以太网和 USB 可用的设备。查看器使用 DepthAI V3 进行连接，因此支持任何 RVC2 或 RVC4 设备。

本地版本使用 WebSocket 进行前后端通信，因此仅受本地网络速度的限制。默认应用程序支持两种模式。第一种模式涉及直接连接到设备，通常使用 https://device-IP:9000。确切的 URL
可以在应用程序日志中找到。编码流需要自签名证书才能正常工作。如果运行多个应用程序，则使用第二个端口 9001。建议在应用程序日志中验证确切的 URL。

第二种以默认应用程序打开查看器的选项是通过远程访问。内部使用 WebRTC，因此理论上支持的带宽吞吐量约为本地 400 Mbps。如果通过互联网连接，可能会更低，具体取决于实际连接情况。在这种情况下，URL
将如下所示：https://viewer.luxonis.app/1.2.1/?t=xxxx。具体的 URL 可以在应用程序日志中找到，或者可以通过 Hub 远程打开 UI，其中提供了正确的 URL。

> 请注意，此 URL 仅有效 15 分钟，之后会重新生成。无需重新打开 UI，因为它会自动刷新，但无法将此 URL 添加到书签。

### 管线

您可以从四个预定义的管线中选择。每个管线使用其自己的 DepthAI 管线。

 * Vision 3D：专注于主摄像头输出和点云。
 * Vision AI：专注于所选神经网络 (NN) 模型的输出及其注释。
 * 动态校准：您可以在此管线中[重新校准](https://docs.luxonis.com/software-v3/depthai/depthai-components/host_nodes/dynamic_calibration.md)您的设备。支持所有
   OAK Series 2 全立体产品线（不包括 FFC）和 OAK Series 4
   全立体产品线。[了解更多。](https://discuss.luxonis.com/blog/6346-dynamic-calibration-keeping-stereo-depth-accurate)
 * 高级：允许对所有功能进行深入配置并访问校准数据。

### 流与管线图

查看器中有两个主要选项卡。第一个是 流。它显示设备可以提供的一组预定义流。这些流取决于支持的功能，例如主 RGB 摄像头、左/右摄像头（如果可用）、深度流、温度等。此外，还有来自所选 NN 模型的流。这些模型从 Luxonis Models ZOO
加载。如果选择了 YOLO 模型，则可以在 RGB 摄像头流上显示注释等。在这些流中，还有深度和点云，它们是在前端根据深度和 RGB 数据计算的，以实现带宽效率。所有这些功能都提供简单的配置选项。

> **自定义模型无法上传到 OAK Viewer**
> OAK Viewer 仅支持 Luxonis Models Zoo 模型的一个选定子集。用户无法上传自定义模型或运行该子集之外的模型。请参阅
> [在 HubAI 上使用自定义模型](https://docs.luxonis.com/cloud/tutorials/use-custom-models-on-hub-ai.md)
> 教程。

第二个标签页是管线图。此标签页显示查看器后端在 DepthAI V3 中创建的当前活跃管线，并以可视化方式呈现所有节点、参数及其连接关系。

### 高级管线中的流功能

在“流”界面中，可执行以下操作：

 * 配置：允许配置传感器、立体深度和高级设置。
 * 神经网络：显示来自 Luxonis 模型库的 NN 模型列表，可供快速测试和配置。
 * 流：根据当前配置，显示设备上所有可用的流列表。
 * 点云：基于深度数据实时显示点云，并由 RGB 相机着色。
 * 面板布局：提供快速设置可见面板布局的方式。

### 流面板

每个流面板都有唯一的名称、分辨率以及若干性能指标。它包含以下帧率指标：

 * 相机：根据配置请求的帧率。
 * 网络：通过网络传输的帧率。
 * 解码：客户端侧解码的帧率。
 * 渲染：客户端侧渲染的帧率。

吞吐量计算为查看器后端通过网络实际传输到浏览器客户端的所有帧的总和，不包括 DepthAI 与设备之间的流量。其他按钮提供控制可见标注、面板位置和全屏模式的选项。

## 设备发现故障排查

> **设备在 oakctl 中可见，但在 OAK 查看器中缺失**
> 在某些网络中，
> `oakctl list`
> 和 OAK 查看器的结果可能不一致。
> `oakctl`
> 的发现使用 mDNS，而 OAK 查看器使用的 DepthAI 发现依赖于本地网络广播行为。

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

## 发布说明

### 版本 3.0.2（2026 年 6 月 5 日）

 * 全面提升了性能。
 * 提升了点云的精度与响应速度。
 * 改进了错误状态处理，包括应用已在运行或设备离线等情况。
 * 修复了设备断开连接的处理。
 * 增加了对设备供电不足的检测。
 * 若干错误修复以及界面/用户体验改进。

### 版本 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 上的视频编码器问题，消除了绿色条纹伪影。
 * 修复了加载已连接设备信息的问题。
 * 修复了存在多个设备时的连接问题。
 * 改进了不同分辨率下的界面响应速度，并修正了信息提示的定位。
 * 修正了 OAK 4 D 的 Flood Light 和 Dot Projector 标签。
 * 改进了神经深度配置。
 * 包含 Visualizer 2.68.8（响应速度提升，更好的 NV12 解码，可更改点云相机）。
 * 修复了当另一个应用已在 OAK 4 上运行时显示的提示信息。