Python#

A Referência da API Python do VEXcode VR explica o que cada comando, método e função faz, que entradas utiliza, o que retorna e como pode ser utilizado num projeto.

Utilize esta referência quando pretende compreender um comando antes de o adicionar a um projeto, verificar que valores aceita ou devolve, ou comparar comandos relacionados numa categoria.

Os comandos Python são utilizados em projetos VEXcode VR Python. Os projetos em blocos utilizam a secção API de Blocos.

Os comandos Python no VEXcode VR podem variar dependendo do Playground e do robô que está a utilizar. Alguns robôs incluem métodos únicos que não estão presentes em todos os Playgrounds.

Parques infantis e robôs em realidade virtual#

Utilize a secção Playgrounds para ver qual o robô utilizado em cada Playground e para encontrar detalhes de configuração específicos do Playground, informações do campo e contexto do desafio.

Utilize a secção Robots para encontrar páginas Python específicas para robôs com métodos únicos. As páginas de Robôs também mostram em que Playgrounds cada robô é utilizado, para que possa saber quando um método específico de um robô está disponível no seu projeto.

Como ler uma entrada de método#

A maioria das entradas em Python inclui as seguintes partes:

  • Nome do comando - O nome oficial do comando, método ou função.

  • Descrição - Explica o que o comando faz e quando é útil.

  • Utilização - Mostra a sintaxe utilizada para escrever o comando no código.

  • Parâmetros - Lista as entradas que o comando aceita e explica o que cada uma faz.

  • Valor de retorno - Explica o que o comando retorna, caso devolva algum valor.

  • Código de exemplo - Mostra uma forma de utilizar o comando num projeto.

Elementos comuns da API do Python#

Elemento

O que significa

Método

Um comando chamado num objeto como drivetrain.rotation(…).

Função

Um comando chamado directamente, como por exemplo wait(…) ou print(…).

Parâmetro

Um valor passado para um método ou função para controlar o que faz.

Parâmetro opcional

Um parâmetro que pode ser omitido para que seja utilizado o comportamento padrão.

Valor de retorno

Um valor devolvido por um comando, como um número, texto ou valor booleano.

Vocabulário básico de Python#

Termo

O que significa

Variável

Um nome que armazena um valor, como por exemplo angle = 90.

Fio

Texto entre aspas, como “Hello”.

Número inteiro

Um número positivo ou negativo, como por exemplo 90.

Flutuar

Um número com decimais, como 25.5.

Booleano

Um valor que pode ser True ou False.

Discussão

Um valor passado para uma chamada de método ou função, como por exemplo DEGREES em drivetrain.rotation(DEGREES).

Exemplo de entrada de método#

rotação#

A rotação indica o quanto o robô rodou, medida em graus. No início de um projeto, o valor de rotação é definido como 0 graus. O comando rotation devolve a rotação atual do robô.

Virar para a direita aumenta a rotação, e virar para a esquerda diminui a rotação. Por exemplo, duas voltas completas para a direita resultarão numa rotação de 720 graus.

Usage:
drivetrain.rotation(units)

Parâmetros

Descrição

units

Opcional. Unidade de rotação: DEGREES (padrão).

 
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)
On this page