汽车集团#

要使 MotorGroup 命令出现在 VEXcode V5 中，必须在设备窗口中配置电机。

有关详细信息，请参阅以下文章：

电机组.旋转()#

motor_group.spin(direction, speed, units) 命令使用提供的参数旋转组中的所有电机。

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

参数	描述
方向	有效的 DirectionType。
速度	可选。使用此速度旋转电机，如果未提供，则将使用“motor_group.set_velocity”设置的默认速度。
单位	可选。有效的 VelocityUnit。默认值为 `RPM`。

**返回：**无。

# Spin the motor group forward for 2 seconds.
motor_group_1.spin(FORWARD)
wait(2, SECOND)

# Stop spinning the motor group.
motor_group_1.stop()

电机组.旋转到位置（）#

motor_group.spin_to_position(rotation, units, speed, units_v, wait) 命令使用提供的参数将组中的所有电机旋转到绝对位置。

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

参数	描述
旋转	电机旋转的位置。
单位	可选。有效的 RotationUnit。默认值为 `DEGREES`。
速度	可选。使用此速度旋转电机，如果未提供，则将使用 set_velocity 设置的默认速度。
单位	可选。有效的 VelocityUnit。默认值为 `RPM`。
等待	可选。确定命令是否阻止后续命令（`wait=True`）或允许立即执行（`wait=False`）。如果未指定，则 wait 参数的默认值为 `wait=True`。

**返回：**无。

电机组.spin_for()#

motor_group.spin_for(direction, value, units, speed, units_v, wait) 命令使用提供的参数将组中的所有电机旋转到相对位置。

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

参数	描述
方向	有效的 DirectionType。
价值	电机组旋转的值。
单位	可选。有效的 RotationUnit。默认值为 `DEGREES`。
速度	可选。使用此速度旋转电机，如果未提供，则将使用 set_velocity 设置的默认速度。
单位	可选。有效的 VelocityUnit。默认值为 `RPM`。
等待	可选。确定命令是否阻止后续命令（`wait=True`）或允许立即执行（`wait=False`）。如果未指定，则 wait 参数的默认值为 `wait=True`。

**返回：**无。

# Spin 180 degrees from the current position.
motor_group_1.spin_for(FORWARD, 180)

电机组.停止()#

motor_group.stop() 命令用于停止一个电机组。

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

**返回：**无。

# Spin the motor group forward for 2 seconds.
motor_group_1.spin(FORWARD)
wait(2, SECOND)

# Stop spinning the motor group.
motor_group_1.stop()

电机组.count()#

motor_group.count() 命令返回组中的电机数量。

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

**返回：**组中的电机数量。

电机组.设置速度（）#

motor_group.set_velocity(velocity, units) 命令用于设置组中所有电机的默认速度。如果未向该函数提供速度，则后续调用 spin 时将使用这个速度。

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

参数	描述
速度	为电机组设置的新速度。
单位	可选。有效的 VelocityUnit。默认值为 `RPM`。

**返回：**无。

电机组.设置停止()#

motor_group.set_stopping(mode) 命令设置组内所有电机的停止模式。设置电机停止时的操作。

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

参数	描述
模式	有效的 BrakeType。默认值为 `COAST`。

**返回：**无。

电机组.重置位置()#

motor_group.reset_position() 命令将电机组位置重置为 0。

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

**返回：**无。

电机组.设置位置（）#

motor_group.set_position(value, units) 命令设置组内所有电机的当前位置。motor_group.position() 函数返回的位置将设置为该值。

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

参数	描述
价值	新的职位。
单位	可选。有效的 RotationUnit。默认值为 `DEGREES`。

**返回：**无。

电机组.设置超时()#

motor_group.set_timeout(timeout, units) 命令设置组中所有电机使用的超时值。

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

参数	描述
暂停	新的超时。
单位	可选。有效的 TimeUnit。默认值为 `MSEC`。

**返回：**无。

电机组正在旋转（）#

如果电机组当前正在旋转，则 motor_group.is_spinning() 命令返回。

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

返回： 如果电机组当前正在旋转，则返回 True。如果不是，则返回 False。

电机组.is_done()#

如果电机组已完成其运动，则 motor_group.is_done() 命令返回。

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

返回： 如果电机组已完成其运动，则返回 True。如果尚未完成，则返回 False。

电机组.设置最大扭矩()#

motor_group.set_max_torque(value, units) 命令设置组内所有电机的最大扭矩。扭矩可以设置为扭矩、电流或最大值的百分比。

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

参数	描述
价值	新的最大使用扭矩。
单位	可选。有效的 TorqueUnit、`AMP` 或 `PERCENT`。

**返回：**无。

电机组.方向()#

motor_group.direction() 命令返回电机组当前旋转的方向。

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

**返回：**电机组当前旋转的 DirectionType。

电机组.位置()#

motor_group.position(units) 命令返回第一个电机的位置。

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

参数	描述
单位	可选。有效的 RotationUnit。默认值为 `DEGREES`。

返回： 以指定单位表示的电机组的当前位置。

电机组.速度（）#

motor_group.velocity(units) 命令返回电机组的当前速度。

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

参数	描述
单位	可选。有效的 VelocityUnit。默认值为 `RPM`。

**返回：**以指定单位表示的电机组当前速度。

电机组.电流（）#

motor_group.current(units) 命令返回电机组正在使用的电流。

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

参数	描述
单位	可选。当前唯一有效的单位是“AMP”。

返回： 电机组以指定单位吸收的电流。

电机组.功率()#

motor_group.power(units) 命令返回电机组消耗的功率。

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

参数	描述
单位	可选。功率的唯一有效单位是“瓦特”。

**返回：**电机组以指定单位消耗的功率。

电机组.扭矩（）#

motor_group.torque(units) 命令返回第一个电机提供的扭矩。

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

参数	描述
单位	可选。有效的 TorqueUnit。默认值为 `NM`。

**返回：**电机组以指定单位产生的扭矩。

电机组.效率()#

motor_group.efficiency(units) 命令返回电机组的效率。

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

参数	描述
单位	可选。效率的唯一有效单位是“百分比”。

**返回：**电机组的效率百分比。

电机组.温度()#

motor_group.temp(units) 命令返回电机组的温度。

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

参数	描述
单位	可选。有效的 TemperatureUnit。默认值为 `CELSIUS`。

**返回：**以指定单位表示的电机组温度。