概览硬件软件云平台
入门指南
车队管理
AI 与模型
教程
平台集成
组织
高级

本页目录

  • 为何重要
  • 心智模型
  • 实际核心能力
  • 核心概念
  • 设备
  • OAK Agent
  • OAK App
  • 集成与管理边界
  • 相关指南

Luxonis Hub 概述

Luxonis Hub 是面向 OAK 的控制平面，用于连接设备、管理应用、打开远程操作员会话、收集快照，并将这些工作流集成到您自己的软件中。请使用此页面了解核心操作模型，然后再进入设置、车队运营、应用管理或面向客户的集成部分。

为何重要

Hub 旨在消除围绕实际 OAK 部署的共享基础设施工作。您无需从头构建自己的设备管理、远程访问和应用操作层，而是可以使用 Hub 来操作设备、运行应用、收集数据，并将这些工作流连接到您自己的后端和产品中。

心智模型

将 Luxonis Hub 视为四个相互连接的层次：
  • 设备提供物理运行时环境。
  • OAK Agent将受支持的设备连接到 Hub，并管理本地应用/运行时桥接。
  • OAK Apps承载应用逻辑、配置和可选的前端。
  • 您的产品和后端可以将 Hub API 和流式传输原语集成到面向客户的工作流中。
显示设备、Agent、应用和 Hub 的概念图

实际核心能力

  • 设备管理：跟踪设备状态、连接性、软件版本和远程可操作性详情。
  • 应用生命周期：在受管理设备上安装、更新、停止和检查 OAK Apps。
  • 远程操作：在无法本地访问时使用 Web 终端、实时日志和远程可视化。
  • 数据收集：捕获快照及相关输出，以支持调试和模型改进。
  • 客户集成：将 Hub 连接到您自己的后端、前端和运营系统。
  • AI 与模型：在 Hub 中管理模型并将其转换为在 Luxonis 硬件上部署。

核心概念

设备

设备是 OAK Agent 运行的物理环境。实际上，通常是以下之一：
  • 已安装 Agent 的 Series 4 相机。
  • 受支持的 Linux 主机（例如 NUC 或 Jetson），已安装 Agent 并连接了受支持的 OAK 设备。
设备会出现在 Hub UI 中，您可以在其中检查状态、查看软件版本、部署应用，并打开远程会话进行调试或操作。
Luxonis Hub 中的设备概览页面
Luxonis Hub 中的设备详情视图示例。

OAK Agent

OAK Agent 是设备与 Luxonis Hub 之间的运行时桥接。它负责设备发现、应用部署、远程会话连接、日志传输和数据上传。
  • 在 Series 4 设备上，Agent 是受支持的 Hub 管理路径的一部分。
  • 在自托管 Linux 部署中，Agent 将主机和连接的硬件连接到 Hub。
对于自托管部署，主机操作系统仍由客户管理。Hub 预期的管理边界是 oak-agent 和应用层，而非完整的主机生命周期管理。

OAK App

OAK App 是您通过 Hub 部署和操作的容器化单元。它将您的运行时逻辑、配置和可选的静态前端打包成一个可部署的产物，用于受支持的设备。
  • 它通过 oakapp.toml 进行配置。
  • 它可以暴露静态前端，或回退到 Hub 的默认可视化路径。
  • 它可以发出日志、流式传输输出并生成快照或其他收集的产物。

构建并运行 OAK App

了解如何使用当前软件栈创建、配置和部署 OAK App。

应用示例

浏览常见 OAK 工作流的示例仓库和参考实现。

oakctl

oakctl 是用于 OAK App 开发和附近设备操作的主要本地 CLI。您可以使用它来构建应用、运行本地迭代、在开发过程中检查设备，并将应用产物发布到 Hub。了解有关 oakctl 的更多信息

集成与管理边界

对于面向客户的产品，默认的集成模型是：
  • 客户用户 -> 客户前端 -> 客户后端 -> Hub API 和流式传输原语
这意味着：
  • 客户认证由客户自己负责
  • Hub API 密钥仅保留在您的后端
  • 您的前端仅接收会话或可视化所需的派生负载
当您围绕 Luxonis 硬件构建自己的门户或运营后端，而不仅仅是依赖 Hub UI 时，这一点尤其有用。

相关指南

连接设备

启动 OAK4 采用和受支持的自托管连接流程的设置路径。

管理设备

检查设备状态、远程访问工作流以及受支持设备的 OTA 行为。

管理应用

在连接的设备上安装、运行、检查和故障排除 OAK Apps。

集成架构

查看推荐的客户自有前端/后端模式，用于 Hub 集成。