概览硬件软件云平台
此页面由 AI 自动翻译。查看英文原版
Hub 控制
舰队管理
Luxonis HubAI
平台集成
组织
高级

本页目录

  • 重要性
  • 心智模型
  • 核心功能实践
  • 核心概念
  • 设备
  • OAK Agent
  • OAK App
  • 集成和管理边界
  • 相关指南

Luxonis Hub 概述

Luxonis Hub 是以 OAK 为中心的控制平面，用于连接设备、管理应用程序、打开远程操作员会话、收集快照以及将这些工作流集成到您自己的软件中。在进行设置、车队操作、应用程序管理或面向客户的集成之前，请使用此页面了解核心操作模型。

重要性

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

心智模型

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

核心功能实践

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

核心概念

设备

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

OAK Agent

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

OAK App

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

Build and run an OAK App

Learn how to create, configure, and deploy an OAK App using the current software stack.

Example apps

Browse example repositories and reference implementations for common OAK workflows.

oakctl

oakctl 是用于 OAK App 开发和附近设备工作的主要本地 CLI。使用它来构建应用程序、运行本地迭代、在开发过程中检查设备以及将应用程序工件发布到 Hub。详细了解 oakctl

集成和管理边界

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

相关指南

Connect a device

Start the setup path for OAK4 adoption and supported self-hosted connection flows.

Manage devices

Inspect device state, remote access workflows, and OTA behavior for supported devices.

Manage applications

Install, run, inspect, and troubleshoot OAK Apps on connected devices.

Integration architecture

See the recommended customer-owned frontend/backend pattern for Hub integrations.