# collection

Python API: `depthai_nodes.message.collection`

## 类

### Collection

在 DepthAI 消息中存储一个运行时类型项的列表。

第一个项确定接受的类型。后续的赋值、追加和扩展必须包含该类型的实例。最初为空的集合在添加第一个项时推断其类型。

参数

 * `items`: 项的初始列表。

抛出

 * `TypeError`: 如果 `items` 不是列表或包含不兼容的项类型。

#### 方法

##### init

```python
def __init__(items: list[T]):
```

初始化集合并推断其运行时项类型。

参数

 * `items` (`list[T]`): 初始项。空列表会将类型推断推迟到第一次插入。

##### append

```python
def append(item: T):
```

追加一个项，如有必要则推断类型。

参数

 * `item` (`T`): 与首次插入项的类型兼容的项。

抛出

 * `TypeError`: 如果项与推断的运行时类型不兼容。

##### copy

```python
def copy(self) -> Collection:
```

复制项并保留容器时间戳和序列号。

返回

 * `Collection`: 一个新的 `Collection`，其中的项通过 `copy_message` 复制。即使在子类上调用，这也会返回基本容器；子类特定的字段不会被复制。

抛出

 * `TypeError`: 如果项无法通过 `copy_message` 复制。

##### extend

```python
def extend(items: list[T]):
```

验证组合列表后追加项。

参数

 * `items` (`list[T]`): 要追加的项。如果验证失败，现有内容保持不变。

抛出

 * `TypeError`: 如果任何项与推断的运行时类型不兼容。

##### items.setter

```python
def items.setter(value: list[T]):
```

检查运行时类型后替换项列表。

参数

 * `value` (`list[T]`): 替换列表。空列表保留先前推断的项类型。

抛出

 * `TypeError`: 如果值不是列表或包含与推断类型不兼容的项。

#### 属性

##### item_cls

一旦已知，项的推断运行时类型。

##### items

返回存储的项列表。

该列表是可变的。直接列表修改会绕过集合类型检查；当需要验证时，请使用 `append()`、`extend()` 或赋值给 `items`。

## 属性

### T
