DepthAI v2 has been superseded by DepthAI v3. You are viewing legacy documentation.
此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • DepthAI
  • DepthAI 2.33
  • DepthAI 2.32
  • DepthAI 2.31
  • DepthAI 2.30
  • DepthAI 2.29
  • DepthAI 2.28
  • DepthAI 2.27
  • DepthAI 2.26
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

发布说明

最后更新

DepthAI

DepthAI 2.33

发布于 2026 年 9 月 2 日。GitHub 发布说明。

功能

  • 增加了对三星 63D ToF 传感器的支持。
  • 引导加载程序更新至 v0.29。

安装

Command Line
1python3 -m pip install depthai==2.33.0

DepthAI 2.32

功能:
  • 添加 device.getState 函数,该函数在运行时返回设备的固件状态
  • 添加 setProcessor 函数以选择 Sync 和 Demux 节点的处理器
杂项:
  • 扩展固件中的崩溃转储数据,提供更多关于导致崩溃的上下文信息

DepthAI 2.31

发布于 2025 年 11 月 28 日
  • 功能
    • 添加 IMX577 传感器的调优,移除之前存在的蓝色色调
    • 改进 RVC2 上 IMX678 的支持,通过更好的黑电平校正,提高亮度和色彩准确性
  • 新设备支持
    • 添加对 OAK-Thermal (R8) 新版本的支持
    • 添加对 OAK-ToF (R4) 的支持
    • 添加对 OAK-D-S2-[Pro]-Wide OV9728 变体 (R8) 新版本的支持
  • 错误修复和稳定性
    • 修复 IMU 阻止设备重启的罕见问题
    • 修复 BNO08x IMU 上的时间戳溢出错误
    • 修复 dai.Device 构造函数在设备在错误时间失去连接时可能无限期卡住的边缘情况,通过内部添加超时来解决
    • 在发现 RVC2 USB 设备时提前打开看门狗,以避免设备软砖,并处理设备进入该状态时在下次启动时恢复的情况
    • 当设置 DEPTHAI_CRASHDUMP=0 时,完全禁用崩溃转储提取
  • 杂项
    • 添加支持在 ObjectTracker 节点中显式移除跟踪器
    • 通过在固件中添加软件看门狗,将最大看门狗频率限制从 4.5 秒移除到无限(“无穷大”)

DepthAI 2.30

发布于 2025 年 3 月 18 日
  • 功能
    • 添加 OAK4/RVC4 发现,将抛出警告,提示用户应使用 DepthAI v3
    • 添加对新 VCM 的支持,在新 IMX378 CCM 上实现自动对焦
  • 错误修复

DepthAI 2.29

发布于 2024 年 11 月 25 日

功能

  • 增加了在运行时使用新的 dai::Device.setCalibration() 方法更改设备校准并使用 dai::Device.getCalibration() 检索校准的能力。
  • 新的 StereoDepth 预设:
    • DEFAULT
    • FACE
    • HIGH_DETAIL
    • ROBOTICS
  • 多摄像头改进(更多详情请参阅 https://github.com/luxonis/depthai-core/pull/972):
    • 在选择低于原生分辨率时暴露更多下采样模式
    • 在 IMX582/586 上选择 binning 时暴露更多 binning 模式(sum 和 avg)
    • IMX582/586 上的 HDR
    • 绕过 3A 以使手动曝光/ISO 更快生效的选项
    • 对新索尼 4K Stravis 传感器:IMX678 和 IMX715 的初步支持
    • 在多摄像头配置中设置主摄像头以驱动自动曝光和自动白平衡的选项
  • 改进的 StereoDepth 过滤和使用自定义过滤器顺序的选项
    • 视差首先缩放到 13 位,然后进行过滤,这使得过滤器更有效。

杂项

  • 移除设备销毁时发生的崩溃的虚假报告
  • 为 EncodedFrame 添加 getWidth() 和 getHeight() API

DepthAI 2.28

发布于 2024 年 8 月 20 日

功能

  • 更改了自动崩溃转储收集,除非设置了 DEPTHAI_DISABLE_CRASHDUMP_COLLECTION,否则始终开启。
  • 添加了 DEPTHAI_ENABLE_ANALYTICS_COLLECTION 环境变量 - 设置后,分析数据(仅限管道 schema)将发送给 Luxonis,用于进一步改进库。
  • 默认情况下,对 ToF 的两个输出进行去畸变。
  • 改进了 OAK-D-LR 上的 3A 同步。
  • 添加了对 YoloV10 的支持。

错误修复

  • 修复 Camera 节点以正确分配去畸变资源。
  • 修复 StereoDepth 节点在使用抽取滤波器和深度对齐时的问题。
  • 修复 OAK-T 上的主机时间戳以正确同步。

杂项

  • 更新了 XLink 以支持 Windows 上的 clangd 和共享库。
  • 移除了自定义断言,以始终生成崩溃转储,从而改善自动崩溃转储收集的用户体验。
  • 提高了设备端看门狗的优先级,以提高高负载下的稳定性。

DepthAI 2.27

发布于 2024 年 6 月 27 日

功能

  • 当设置 DEPTHAI_ENABLE_FEEDBACK_CRASHDUMP 时自动收集崩溃转储

修复和稳定性改进

  • 修复 ImageAlign 节点输出深度时 PointCloud 生成问题
  • 修复 IMX214 (OAK Lite) 在初始化更复杂管道时可能发生的崩溃
  • 修复 AF 运行时,在 1 秒后关闭摄像头流时可能发生的罕见崩溃

仅限 Python

  • 添加对 numpy 2 的支持

DepthAI 2.26

发布日期:2024 年 5 月 26 日

功能

  • ImageAlign 节点
    • 它可以将深度与设备上的任何其他传感器对齐 - 也适用于 ToF。
    • 它可以将两个传感器与静态深度(默认为无穷远)对齐,这对于热-RGB 对齐很有用
  • Cast 节点
    • 将 NNData 消息转换为 ImgFrame
    • 在应用程序需要使用 NeuralNetwork 节点的输出馈送到只接受 ImgFrame 的节点时很有用
  • 完整的 ToF 支持
    • 实时运行 30 FPS
    • 测量范围 20 厘米 - 6 米
    • 整个范围内的误差 < 1%
  • 在空间节点中支持 ToF
  • 通过 XLink setXLinkRateLimit(int maxRateBytesPerSecond, int burstSize, int delayUs) 限制带宽的选项

修复和稳定性改进

  • 改进了 PoE 重启时的稳定性 - 消除了有时需要对设备进行断电重启的情况
  • 通过提高 NoC 中摄像头的优先级,改进了重负载管道的运行时稳定性
  • 改进了 ImageManip 稳定性
  • 改进了 XLink 通信,能够检测内存损坏并避免它
  • 修复了当校准数据不包含两个输入之间的直接链接时,立体校正不准确的错误
    • 与 FFC 设备上的自定义设置相关

杂项

  • 改进了校正算法的数值稳定性
    • 提高了广角 FOV 传感器上的立体质量

仅限 Python

  • 为存根添加了文档字符串 - 现在默认在 vscode 中显示文档
  • 修复了存根/自动完成功能,使其能够正确地与 dai.Device() as device 一起使用
  • 修复了存根/自动完成功能,使其在 getCvFrame 函数中返回正确的类型。