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	Un comando llamado en un objeto como drone.take_off(…).
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 height = 500.
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 500 en drone.take_off(climb_to=500).

Ejemplo de entrada de método

despegar

El comando take_off pone en marcha las hélices y eleva el dron. Este método debe utilizarse antes de realizar cualquier otro movimiento.

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	Unidad a utilizar: CM - Centímetros MM - Milímetros INCHES
wait	Opcional. wait=True (predeterminado) - El dron espera hasta que take_off se complete antes de ejecutar la siguiente línea de código. wait=False - El dron inicia la acción y pasa a la siguiente línea de código inmediatamente, sin esperar a que take_off termine.

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