message
最后更新
depthai_nodes.messageDepthAI v3 的原生解析器消息和自定义消息。解析器创建器返回原生 DepthAI 消息。该软件包需要 DepthAI 3.9 或更高版本,它提供了主机解析器使用的 Beta 消息类型。使用 depthai_nodes.message.creators 从数组构造消息,使用 depthai_nodes.message.utils 进行复制和检测几何。目录内容原生解析器消息
dai.ImgDetections包含检测,包括可选的关键点和实例掩码;dai.SpatialImgDetections添加了空间坐标。dai.SegmentationMask包含分割掩码。dai.beta.Classifications包含类名和分数,包括序列分类结果。dai.beta.Clusters和dai.beta.Cluster表示分组的 2D 点。dai.beta.Keypoints包含关键点和可选的骨架边缘。dai.beta.Lines和dai.beta.Line表示线条检测。dai.beta.Map2D存储数字地图,例如深度估计。dai.beta.Predictions和dai.beta.Prediction存储回归结果。dai.TrackedFeatures表示特征点和匹配。dai.ImgFrame和dai.NNData携带图像和嵌入张量。
自定义消息
append() 或 extend() 添加项目。第一个项目建立接受的类型;最初为空的集合在填充时推断其类型。分配 items 验证替换列表,但直接修改返回的列表会绕过该验证。copy() 通过 copy_message 复制每个项目,并保留消息时间戳和序列号。GatheredData 扩展了 Collection,带有一个引用消息。分配 reference_data 会将其时间戳和序列号复制到消息中。depthai_nodes.node.GatherData 通过匹配参考时间戳周围的消息来生成这些消息。SnapData 存储快照名称、包含图像和相关文件的 dai.FileGroup、可选标签和字符串元数据。将这些消息传递给 depthai_nodes.node.SnapsUploader,通过 Hub Events API 上传它们。示例
将检测与它们引用的帧分组:
Text
1import depthai as dai
2from depthai_nodes.message import GatheredData
3
4frame = dai.ImgFrame()
5detections = dai.ImgDetections()
6batch = GatheredData(reference_data=frame, items=[detections])
7assert batch.reference_data is frame注意
创建器函数填充有效负载。从管道发出消息的调用者还必须设置适当的时间戳、序列号和图像变换。原生消息副本可能共享像素存储;在修改复制的缓冲区之前,请参阅 depthai_nodes.message.utils.copy_message。