Python

La Referencia de API de Python de VEX AIR explica qué hace cada comando, método y función, qué entradas usa, qué devuelve y cómo se puede usar 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 VEXCODE AIR Python. Los proyectos de Blocks utilizan la sección API de Blocks en su lugar.

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.

• Devolver valor: explica qué informa el comando, si devuelve un valor.

• Código de ejemplo: muestra una forma en que se puede usar el comando en un proyecto.

Elementos comunes de la API de Python

Elemento	Qué significa
Método	Un comando llamado a un objeto como drone.take_off(…).
Función	Un comando llamado directamente, como wait(…) o print(…).
Parámetro	Un valor pasado 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 reporta un comando, como un número, texto o booleano.

Vocabulario básico de Python

Plazo	Qué significa
Variable	Un nombre que almacena un valor, como height = 500.
Cadena	Texto entre comillas, como “Hello”.
Entero	Un número positivo o negativo, como 90.
Flotar	Un número con un decimal, como 25.5.
Booleano	Un valor que es True o False.
Argumento	Un valor pasado a una llamada de método o función, como 500 en drone.take_off(climb_to=500).

Ejemplo de entrada de método

take_off

take_off arranca las hélices y levanta el dron en el aire. Este método debe usarse antes de que se puedan realizar otros movimientos.

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	La unidad a utilizar: CM - Centímetros MM - Milímetros INCHES
wait	Opcional. wait=True (predeterminado) - El dron espera hasta que take_off esté completo 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 de inmediato, sin esperar a que take_off termine.

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