create方法

Sensor.create(cam_id=0, use_gpu=True, config_path=None, api=None, check_serial=True, rectify_size=None, ip_address=None, video_path=None)

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

Parameters:

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

• use_gpu (bool, 可选) – 是否使用 GPU 进行推理。

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

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

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

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

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

• video_path (str, 可选) – 离线模拟的视频路径。

Returns:

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

Return type:

Sensor

Note

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

示例代码

示例 1:通过 SN 码开启传感器示例 2:通过相机编号开启传感器示例 3:打开存储的离线数据示例 4:连接远程算力板上的传感器

from xensesdk import Sensor

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

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

tips

该方法的 mac_address 参数兼容设备 IP 地址，如何获取设备 MAC 可参考 EzROS。