此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 整体录制
  • 环境变量配置
  • 功能示例
  • 整体回放
  • 功能示例
  • 限制
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

整体录制与回放

最后更新
为了简化应用程序的开发以及后续的测试和调试,您可以录制和回放测试数据。这可以通过使用环境变量和配置文件来完成,无需对代码进行任何更改。您可以使用 holistic_record.py 脚本创建整体录制,然后通过将 DEPTHAI_REPLAY 环境变量设置为录制路径来回放。整体录制和回放的工作原理是:录制应用程序中使用的源节点(Camera 和 IMU)的校准信息、相机功能信息和数据(消息),然后可以像源节点再次发送相同数据一样进行回放。

整体录制

整体录制将启用的源节点流录制到 tar 文件中。这可以在代码中启用:

Python

Python
1with dai.Pipeline as pipeline:
2    config = dai.RecordConfig()
3    config.outputDir = "./recordings";
4    config.videoEncoding.enabled = True # 使用视频编码
5    config.videoEncoding.profile = dai.VideoEncoderProperties.Profile.H264_MAIN
6
7    pipeline.enableHolisticRecord(config)

C++

C++
1dai::Pipeline pipeline;
2dai::RecordConfig config;
3config.outputDir = "./recordings";
4config.videoEncoding.enabled = true;  // 使用视频编码
5config.videoEncoding.profile = dai::VideoEncoderProperties::Profile::H264_MAIN;
6
7pipeline.enableHolisticRecord(config);
或者通过使用 DEPTHAI_RECORD 环境变量:
Command Line
1DEPTHAI_RECORD="./recordings" python3 application.py

环境变量配置

在上面的示例中,DEPTHAI_RECORD 环境变量设置为录制输出目录。这启用了整体录制,并使用了默认配置选项。如果您想要更多控制,可以将变量设置为配置文件的路径:
JSON
1{
2    "outputDir": "recordings/",
3    "compressionLevel": 3,
4    "syncCameraOutputs": true,
5    "videoEncoding": {
6	"enabled": true,
7        "bitrate": 0,
8        "lossless": false,
9        "profile": "MJPEG",
10        "quality": 80
11    }
12}
配置参数如下:
  • outputDir 设置录制的输出目录
  • compressionLevel 配置元数据的压缩级别。范围从 0 到 5(包括),对应于以下压缩级别:NONE、FASTEST、FAST、DEFAULT、SLOW、SLOWEST
  • syncCameraOutputs 启用相机输出同步。这可以防止在回放至 StereoDepth 或需要同步帧的类似节点时,消息丢失导致问题。
  • videoEncoding 配置编码相机流的 VideoEncoder:
    • enabled 启用 VideoEncoder。当 false 时,录制 Camera 节点的输出,这可以降低设备 CPU 使用率,同时增加带宽使用率
    • profile 设置编码配置文件
    • bitrate 设置 VideoEncoder 比特率(设置为 0 时自动确定)
    • lossless 确定在适用情况下编码是否无损
    • quality 确定在适用情况下的编码质量

功能示例

整体回放

整体回放回放录制的源流。它会自动循环输入流并相应地更新消息时间戳和序列号。与整体录制类似,它可以在代码中启用:

Python

Python
1with dai.Pipeline as pipeline:
2    pipeline.enableHolisticReplay("./recordings/recording.tar")

C++

C++
1dai::Pipeline pipeline;
2pipeline.enableHolisticReplay("./recordings/recording.tar");
或者通过使用 DEPTHAI_REPLAY 环境变量:
Command Line
1DEPTHAI_REPLAY="./recordings/recording.tar" python3 application.py

功能示例

限制

此功能仍在开发中,并存在一些限制:
  • 由于回放需要将消息从主机发送到设备,因此使用此功能会显著降低管道的帧率。
  • 回放时,每次循环帧时间戳可能会漂移,因为循环时间戳偏移是为每个相机流独立计算的。这可能会导致一段时间后消息同步出现问题。
  • 目前,只能整体录制和回放单个设备管道。