Python

La documentación de referencia de la API de Python de VEX AIR 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 de Python de VEXcode AIR. Los proyectos de 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 drone.take_off(…).
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 height = 500.
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 500 in drone.take_off(climb_to=500).

Ejemplo de entrada de método

despegar

take_off starts the propellers and lifts the drone into the air. This method must be used before other movements can be made.

Uso:

drone.take_off(climb_to, units, wait)

Parámetros	Descripción
climb_to	La posición Z a la que volará el dron.
units	The unit to use: CM - Centimeters MM - Millimeters INCHES
wait	Optional. wait=True (default) - The drone waits until take_off is complete before executing the next line of code. wait=False - The drone starts the action and moves on to the next line of code right away, without waiting for take_off to finish.

# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()