距离传感器#

介绍#

The Distance Sensor can detect whether an object is in front of the sensor and return how far away that object is. It can also return the detected object’s relative velocity and estimate whether the object is small, medium, or large.

The Distance Sensor operates over a range of 20 mm to 2000 mm.

Below 200mm, accuracy is approximately ±15mm. Above 200mm, accuracy improves to about 5%.

The Distance Sensor uses a Class 1 laser. Detection is directed straight ahead and is classroom-safe.

The Distance Sensor.

This page uses distance_sensor as the example Distance Sensor name. Replace it with your own configured name as needed.

以下是可用方法列表：

  • object_distance — Returns the distance between the Distance Sensor and the nearest detected object.

  • object_velocity — Returns how quickly the detected object is moving toward or away from the Distance Sensor.

  • object_size — Returns the estimated size of the detected object.

  • is_object_detected — Returns whether the Distance Sensor currently detects an object.

  • changed — Registers a function to run whenever the Distance Sensor’s value changes.

Constructor — Manually initialize a Distance Sensor.

  • Distance — Creates a Distance Sensor.

物体距离#

object_distance returns the distance between the Distance Sensor and the nearest detected object as a decimal (float).

Usage:
distance_sensor.object_distance(units)

参数

描述

units

Optional. The distance unit: MM (default, 20 mm to 2000 mm) or INCHES (0.78 inches to 78.74 inches).

 
# Drive forward until the object is within 50 mm away
drivetrain.drive(FORWARD)
while not distance_sensor.object_distance(MM) < 50:
  pass
drivetrain.stop()

物体速度#

object_velocity returns the relative velocity of the detected object as a decimal (float) in m/s (meters per second).

Velocity shows how quickly the object is moving toward or away from the Distance Sensor. A value near 0 means the object is not moving much relative to the sensor.

Usage:
distance_sensor.object_velocity()

参数

描述

此方法没有参数。

对象大小#

object_size returns the estimated size of the object detected by the Distance Sensor.

The Distance Sensor estimates object size based on how much of the sensor’s view is taken up by the detected object.

  • ObjectSizeType(0, “NONE”) — No object is detected.

  • ObjectSizeType(1, “SMALL”) — A small object is detected.

  • ObjectSizeType(2, “MEDIUM”) — A medium object is detected.

  • ObjectSizeType(3, “LARGE”) — A large object is detected.

Usage:
distance_sensor.object_size()

参数

描述

此方法没有参数。

检测到物体#

is_object_detected returns whether the Distance Sensor currently detects an object.

  • True — The Distance Sensor detects an object.

  • False — The Distance Sensor does not detect an object.

Usage:
distance_sensor.is_object_detected()

参数

描述

此方法没有参数。

 
# Drive forward until the object is within 50 mm away
while True:
  drivetrain.drive(FORWARD)
  if distance_sensor.is_object_detected():
    if distance_sensor.object_distance(MM) < 50:
      drivetrain.stop()
      break

已更改#

changed registers a function to be called whenever the Distance Sensor’s value changes.

Usage:
distance_sensor.changed(callback, arg)

参数

描述

callback

先前定义的 函数，当距离传感器的值发生变化时执行。

arg

可选。包含要传递给回调函数的参数的元组。有关更多信息，请参阅使用带参数的函数。

 
def my_function():
  brain.screen.print("Distance changed")

# Call my_function whenever distance_sensor's value changes
distance_sensor.changed(my_function)

构造函数#

Constructors are used to manually create Distance objects, such as when configuring a Distance Sensor outside of VEXcode.

Distance#

Distance creates a Distance Sensor object.

Usage:
Distance(smartport)

范围

描述

smartport

The Smart Port that the Distance Sensor is connected to, written as Ports.PORTx, where x is the port number.

 
# Create a Distance Sensor in Port 10
distance_sensor = Distance(Ports.PORT10)
On this page