电磁铁#

初始化电磁铁类 #

使用以下构造函数创建电磁铁对象：

electromagnet 构造函数在指定的端口创建一个电磁铁对象：

范围	描述
`端口`	电磁铁所连接的有效智能端口。

// Construct an Electromagnet "magnet" with the
// electromagnet class.
electromagnet magnet = electromagnet(PORT1);

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

setPower(power) 方法设置用于拾取和放下的电磁铁的功率级别。

参数	描述
力量	功率级别设置在 0 - 100 范围内。

**返回：**无。

// Set the default power to 80%.
magnet.setPower(80);

该方法通过以下方式调用：

pickup() 方法激活电磁铁以 setPower() 方法指定的默认持续时间和默认功率拾取物体。

// Set the magnet to pickup.
magnet.pickup();

pickup(time, units) 方法激活电磁铁，使其在指定的时间内以 setPower() 方法指定的默认功率拾取物体。

参数	描述
时间	激活电磁铁的持续时间。
单位	有效的 timeUnit。默认值为“msec”。

// Set the magnet to pickup for 10 seconds.
magnet.pickup(10, seconds);

pickup(time, units, power) 方法激活电磁铁，以指定的功率在指定的时间内拾取物体。

// Set the magnet to pickup for 10 seconds at 90% power.
magnet.pickup(10, seconds, 90);

**返回：**无。

该方法通过以下方式调用：

drop() 方法激活电磁铁以默认持续时间和由 setPower() 方法指定的默认功率拾取物体。

**返回：**无。

// Set the magnet to drop.
magnet.drop();

drop(time, units) 方法可停用电磁铁，以 setPower() 方法指定的默认功率在指定的时间内放下物体。

参数	描述
时间	停用电磁铁的持续时间。
单位	有效的 timeUnit。默认值为“msec”。

**返回：**无。

// Set the magnet to drop for 10 seconds.
magnet.drop(10, seconds);

drop(time, units, power) 方法可使电磁铁以指定的功率在指定的时间内放下物体。

**返回：**无。

// Set the magnet to drop for 10 seconds at 90 percent power.
magnet.drop(10, seconds, 90);

temp(units) 方法返回电磁铁的温度。

参数	描述
单位	有效的温度单位。默认值为“摄氏度”。

**返回：**表示电磁铁温度的双精度数。

timestamp() 方法请求从电磁铁接收的最后一个状态包的时间戳。

**返回：**最后一个状态包的时间戳，以毫秒为单位的无符号 32 位整数。

如果电磁铁已连接，则 installed() 方法返回。

**返回：**如果安装了电磁铁，则返回 true。如果未安装，则返回 false。