Python#

La guía de referencia de la API de Python de VEXcode VR 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 VEXcode VR Python. Los proyectos de Blocks utilizan la sección de la API de Blocks.

Los comandos de Python en VEXcode VR pueden variar según el Playground y el robot que estés utilizando. Algunos robots incluyen métodos exclusivos que no aparecen en todos los Playgrounds.

Parques infantiles y robots en realidad virtual#

Utilice la sección Playgrounds para ver qué robot se utiliza en cada Playground y para encontrar detalles de configuración específicos de Playground, información del 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 un método específico de un robot está disponible 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.
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 `drivetrain.rotation(…)`.
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 `angle = 90`.
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 `DEGREES` in `drivetrain.rotation(DEGREES)`.

Ejemplo de entrada de método#

rotación#

Rotation is how much the robot has turned, measured in degrees. At the beginning of a project, the rotation value is set to 0 degrees. rotation returns the robot’s current rotation.

Girar a la derecha aumenta la rotación, y girar a la izquierda la disminuye. Por ejemplo, dar dos vueltas completas a la derecha produce una rotación de 720 grados.

Usage:
drivetrain.rotation(units)

Parámetros	Descripción
`units`	Optional. The rotation unit: `DEGREES` (default).

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)