Python#

La documentación de referencia de la API de Python de VEX AIM explica qué hace cada comando, método y función, qué entradas utiliza, qué devuelve y cómo se puede utilizar en un proyecto.

Utilice esta referencia cuando desee comprender un comando antes de agregarlo a un proyecto, comprobar qué valores acepta o devuelve, o comparar comandos relacionados en una categoría.

Los comandos de Python se utilizan en los proyectos VEXcode AIM Python. Los proyectos Blocks utilizan la sección de la API de Blocks.

Cómo leer una entrada de método#

La mayoría de las entradas de Python incluyen las siguientes partes:

Nombre del comando - El nombre oficial del comando, método o función.
Descripción - Explica qué hace el comando y cuándo es útil.
Uso - Muestra la sintaxis utilizada para escribir el comando en código.
Parámetros - Enumera las entradas que acepta el comando y explica qué hace cada una.
Valor de retorno - Explica qué valor devuelve el comando, si es que devuelve alguno.
Código de ejemplo - Muestra una forma en que se puede utilizar el comando en un proyecto.

Elementos comunes de la API de Python#

Elemento	Qué significa
Método	A command called on an object such as `robot.move_at(…)`.
Función	A command called directly, such as `wait(…)` or `print(…)`.
Parámetro	Un valor que se pasa a un método o función para controlar lo que hace.
Parámetro opcional	Un parámetro que se puede omitir para que se utilice el comportamiento predeterminado.
Valor de retorno	Un valor que devuelve un comando, como un número, un texto o un valor booleano.

Vocabulario básico de Python#

Término	Qué significa
Variable	A name that stores a value, such as `speed = 50`.
Cadena	Text inside quotes, such as `“Hello”`.
Entero	A positive or negative number, such as `90`.
Flotar	A number with a decimal, such as `25.5`.
Booleano	A value that is either `True` or `False`.
Argumento	A value passed into a method or function call, such as `0` in `robot.move_at(0)`.

Ejemplo de entrada de método#

mover_en#

move_at moves the robot forever at a specific angle. The robot will continue to move until it is given another action, like moving at a different angle, turning, or stopping.

Usage:
robot.move_at(angle, velocity, units)

Parámetros	Descripción
`angle`	El ángulo, en grados, que describe el movimiento del robot. Puede ser un número entero o decimal entre -360 y 360.
`velocity`	Optional. The velocity to move with from 0% to 100% when using `PERCENT`, or from 0 to 200 millimeters per second when using `MMPS`. This can be an integer or decimal. If no velocity is provided, the robot moves at the current move velocity.
`units`	Optional. The velocity unit: `PERCENT` (default) or `MMPS` (millimeters per second).

# Move forward
robot.move_at(0)