跳到主要内容

release()

实例方法 | VTSensor 传感器类

📖 方法说明​

释放传感器实例占用的资源，包括关闭设备连接、释放内存等。使用完传感器后应调用此方法以确保资源正确释放。

📝 语法​

sensor.release()

🔧 参数​

无参数

📤 返回类型​

无返回值

💡 示例代码​

基本使用​

from pyvitaisdk import VTSensor, VTSDeviceFinder

# 初始化传感器
finder = VTSDeviceFinder()
devices = finder.get_devices()
sensor = VTSensor(devices[0])

# 使用传感器...
sensor.calibrate()
# ... 进行数据采集等操作 ...

# 释放资源
sensor.release()
print("传感器资源已释放")

使用 try-finally 确保资源释放​

from pyvitaisdk import VTSensor, VTSDeviceFinder, VTSDataType

finder = VTSDeviceFinder()
devices = finder.get_devices()
sensor = VTSensor(devices[0])

try:
    # 使用传感器
    sensor.calibrate()
    data = sensor.collect_sensor_data(VTSDataType.WARPED_IMG)
    # ... 处理数据 ...
    
finally:
    # 确保资源被释放
    sensor.release()
    print("资源已安全释放")

⚠️ 注意事项​

重要提醒
  • 使用完传感器后必须调用 release() 方法
  • 不释放资源可能导致设备无法被再次打开
  • 可能造成内存泄漏和资源占用
最佳实践

推荐使用方式（优先级从高到低）：

  1. try-finally 块 - 确保异常情况下也能释放资源
  2. 手动调用 - 需要记得在合适的时机调用
多传感器场景

如果同时使用多个传感器：

  • 每个传感器实例都需要单独释放
  • 建议按照创建的相反顺序释放
释放后的行为
  • 释放后的传感器实例不能再被使用
  • 需要重新创建实例才能再次使用传感器

🔗 相关方法​