#

初始化灯光类#

使用以下构造函数创建光传感器:

灯(端口)

此构造函数使用一个参数:

范围

描述

端口

光传感器连接到的 3 线端口,无论它是 大脑 上的端口,还是 3 线扩展器 上的端口。

必须先创建 Brain3-Wire Expander,然后才能使用 Light Class 构造函数创建对象。

# Create the Brain.
brain = Brain()
# Construct a Light Sensor "light" with the Light class.
light = Light(brain.three_wire_port.a)

当引用 Light 类方法时,此“light”对象将在整个 API 文档的所有后续示例中使用。

类方法#

brightness()#

brightness(units) 方法返回照射到光传感器上的光的亮度级别。光传感器的亮度是根据传感器原始值估算的。

亮度 0% 表示原始值大于或等于 900。亮度 100% 表示原始值等于 0。

参数

描述

单位

**可选。**亮度的唯一有效单位是“百分比”。

**返回:**光传感器的亮度级别在 0% - 100% 范围内。

# Get Light Sensor brightness in range of 0% - 100%.
value = light.brightness()

changed()#

changed(callback, arg) 方法注册一个回调函数,用于光传感器的值发生变化时调用。

这是一个非等待命令,允许下一个命令无延迟运行。

参数

描述

打回来

当光传感器的值发生变化时调用的回调函数。

arg

**可选。**传递给回调函数的参数元组。

**返回:**无。

# Define a function light_changed()
def light_changed():
    # The Brain will print that the Light Sensor value changed 
    # on the Brain's screen.
    brain.screen.print("Light Sensor value changed")
# Run light_changed when the value of this Light Sensor changes.
light.changed(light_changed)