Python#

La Referencia de la API de Python de VEXcode VR 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 proyectos VEXcode VR Python. Los proyectos de Blocks utilizan la sección API de Blocks en su lugar.

Los comandos de Python en VEXcode VR pueden depender del Playground y del robot que esté utilizando. Algunos robots incluyen métodos únicos que no aparecen en todos los patios de recreo.

Parques infantiles y robots en realidad virtual#

Utilice la sección Patios de recreo para ver qué robot se utiliza en cada patio de recreo y para encontrar detalles de configuración específicos del patio de recreo, información de campo y contexto del desafío.

Utilice la sección Robots para encontrar páginas de Python específicas para robots con métodos únicos. Las páginas de Robots también muestran en qué Playgrounds se utiliza cada robot, para que pueda saber cuándo está disponible un método específico de robot en su proyecto.

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 `drivetrain.rotation(…)`.
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 `angle = 90`.
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 `DEGREES` en `drivetrain.rotation(DEGREES)`.

Ejemplo de entrada de método#

rotación#

La rotación es cuánto ha girado el robot, medida en grados. Al comienzo de un proyecto, el valor de rotación se establece en 0 grados. La rotation devuelve la rotación actual del robot.

Girar a la derecha aumenta la rotación y girar a la izquierda disminuye la rotación. Por ejemplo, hacer dos giros completos a la derecha devolverá una rotación de 720 grados.

Usage:
drivetrain.rotation(units)

Parámetros	Descripción
`units`	Opcional. La unidad de rotación: `DEGREES` (por defecto).

def main():
    # Display the rotation after turning
    drivetrain.turn_for(RIGHT, 450, DEGREES)
    brain.print("Rotation: ")
    brain.print(drivetrain.rotation(DEGREES))

# VR threads - Do not delete
vr_thread(main)