集成架构

在您设计需要依赖 Luxonis Hub 的客户门户、运营仪表板或后端集成时，请参考本页面。它说明了生产环境集成的默认架构，以及身份验证、控制平面 API 调用和浏览器会话引导应处于的位置。

经典架构

对于大多数生产部署，Luxonis Hub 应位于您自己的产品后端之后，而不是作为主要前端身份验证边界。默认的集成模型如下：

请明确遵守以下规则：

这是面向客户的 Hub 集成最常见的实际形态：

这样可将身份验证和 Hub 凭据保留在服务器端，同时在需要时仍允许直接的浏览器端会话传输。

Luxonis Hub 目前对外提供两种客户导向的 API 风格：

这种划分是正常的。如果您的产品同时使用车队控制和工作流管理，您将需要与两者集成。对于外部 GraphQL 集成，请使用公共的 team { ... } 查询面。

对于浏览器端的设备和应用会话，您的后端应调用 GraphQL 控制 API，并将引导有效载荷返回给前端。相关的 GraphQL 操作包括：

这样可将 Hub 凭据保留在您的后端，同时允许浏览器直接连接到远程会话传输通道。

对于客户门户，推荐的渲染原语是可视化器 (visualizer)。当您需要以下功能时，请使用可视化器：

若可视化器不适用，可将完全自定义渲染视为高级/自定义路径。直接同局域网 websocket 或设备本地访问仍可用作备用路径，但它并非客户门户的标准远程集成模型。

在您的集成设计中，请明确以下边界：

了解用于控制平面集成的公共 team { ... } 请求结构。

使用推荐的后端中介引导流程，用于浏览器会话和客户门户。

从用于列出和检查设备的公共读取路径开始。

使用独立的模型 API 进行高级模型注册和转换自动化。