# 轨迹列表

轨迹列表由 [ObjectTracker](https://docs.luxonis.com/software-v3/depthai/depthai-components/nodes/object_tracker.md)
节点生成。它们提供检测对象的跟踪信息，包括ROI、跟踪ID、标签、年龄和状态。

当跟踪器接收到带有空间数据的检测结果时，每个轨迹还会携带 spatialCoordinates（X/Y/Z，单位毫米）。velocity 和 speed 是可选的三维估算值，单位米/秒，当没有有效的空间状态（如仅RGB跟踪）时为空。

## 功能示例

 * [RGB对象跟踪](https://docs.luxonis.com/software-v3/depthai/examples/object_tracker/object_tracker.md)
 * [视频对象跟踪](https://docs.luxonis.com/software-v3/depthai/examples/object_tracker/object_tracker_replay.md)
 * [基于重映射的深度对象跟踪](https://docs.luxonis.com/software-v3/depthai/examples/object_tracker/object_tracker_remap.md)

## 参考

### dai::Tracklets

Kind: class

Tracklets message. Carries object tracking information.

#### LengthUnit unit

Kind: variable

Measurement unit used by all tracklets'

#### std::vector< Tracklet > tracklets

Kind: variable

Retrieve data for Tracklets . return: Vector of object tracker data, carrying tracking information.

#### int64_t sequenceNum

Kind: variable

#### Timestamp ts

Kind: variable

#### Timestamp tsDevice

Kind: variable

#### std::optional< Timestamp > tsSystem

Kind: variable

#### std::optional< ImgTransformation > transformation

Kind: variable

#### Tracklets()

Kind: function

Construct Tracklets message.

#### ~Tracklets()

Kind: function

#### Tracklets transformTo(const ImgTransformation & target)

Kind: function

Returns a new Tracklets message with the tracklets transformed into the target image transformation. For each tracklet, the
bounding box is assumed to lie on a plane parallel to the image plane at depth parameters: target: Target image transformation.

#### void serialize(std::vector< std::uint8_t > & metadata, DatatypeEnum & datatype)

Kind: function

#### DEPTHAI_SERIALIZE(Tracklets, tracklets, transformation, ts, tsDevice, tsSystem, sequenceNum, unit)

Kind: function

#### std::optional< ImgTransformation > getTransformation()

Kind: function

Returns the current transformation if set, else std::nullopt.

#### void setTransformation(const ImgTransformation & transformation)

Kind: function

Sets the current transformation.

### 需要帮助？

请前往 [OAKChina 官网](https://www.oakchina.cn/) 获取技术支持或解答您的任何疑问。