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

Un comando llamado sobre un objeto como robot.move_at(…).

Función

Un comando llamado directamente, como wait(…) o 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

Un nombre que almacena un valor, como por ejemplo speed = 50.

Cadena

Texto entre comillas, como por ejemplo “Hello”.

Entero

Un número positivo o negativo, como 90.

Flotar

Un número con decimales, como 25.5.

Booleano

Un valor que es True o False.

Argumento

Un valor pasado a una llamada a un método o función, como 0 en robot.move_at(0).

Ejemplo de entrada de método#

mover_en#

move_at mueve el robot indefinidamente en un ángulo específico. El robot continuará moviéndose hasta que se le dé otra acción, como moverse en un ángulo diferente, girar o detenerse.

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

Opcional. La velocidad de movimiento varía entre 0 % y 100 % al usar PERCENT, o entre 0 y 200 milímetros por segundo al usar MMPSPuede ser un número entero o decimal. Si no se especifica ninguna velocidad, el robot se mueve a la velocidad actual.

units

Opcional. La unidad de velocidad: PERCENT (predeterminado) o MMPS (milímetros por segundo).

# Move forward
robot.move_at(0)