Python#

A Referência da API Python do VEX AIR 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 AIR Python. Os projetos em blocos utilizam a secção API de Blocos.

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 drone.take_off(…).

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 height = 500.

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 500 em drone.take_off(climb_to=500).

Exemplo de entrada de método#

descolar#

O comando take_off aciona as hélices e eleva o drone no ar. Este método deve ser utilizado antes que outros movimentos possam ser feitos.

Utilização:

drone.take_off(climb_to, units, wait)

Parâmetros

Descrição

climb_to

A posição z para onde o drone irá voar.

units

Unidades a utilizar:

  • CM - Centímetros
  • MM - Milímetros
  • INCHES

wait

Opcional.

  • wait=True (default) - O drone espera até que take_off esteja concluído antes de executar a próxima linha de código.
  • wait=False - O drone inicia a ação e passa para a linha de código seguinte imediatamente, sem esperar que take_off termine.

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