create方法

Sensor.create(cam_id=0, config_path=None, api=None, check_serial=True, rectify_size=None, mac_addr=None)

创建一个传感器实例，使用完成后请调用 release() 释放资源。

Parameters:

• cam_id (int | str，可选) – 传感器 ID、序列号或视频路径。默认为 0。

• config_path (str | Path，可选) – 配置文件路径或目录。若为目录，需包含与传感器序列号同名的标定文件。

• api (Enum，可选) – 相机 API 类型（如 OpenCV 后端），用于指定相机访问方式。

• check_serial (bool，可选) – 是否检查传感器序列号。

• rectify_size (tuple[int, int]，可选) – 校正图像尺寸（宽, 高）。

• mac_addr (str，可选) – 远程连接使用的相机 MAC 地址。

Returns:

传感器实例，用于后续数据采集和处理。

Return type:

Sensor

Note

使用完毕后务必调用 release() 释放系统资源。

示例代码

示例 1:通过 SN 码开启传感器

from xensesdk import Sensor

# 使用传感器序列号（SN）创建实例
sensor = Sensor.create('OP000064')

# 使用完毕后释放资源
sensor.release()

示例 2:通过相机编号开启传感器

from xensesdk import Sensor

# 使用相机编号（如 0、1）创建实例
sensor = Sensor.create(0)

# 使用完毕后释放资源
sensor.release()

示例 3:连接远程算力板上的传感器

from xensesdk import Sensor

# 指定 MAC 地址连接远程传感器
master_service = "master_000000000000"
sensor = Sensor.create('OP000064', mac_addr="000000000000")

# 使用完毕后释放资源
sensor.release()

tips

如何获取示例 3中master_service 可参考 EzROS。