Python#

A Referência da API Python do VEX AIM 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 AIM 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 `robot.move_at(…)`.
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 `speed = 50`.
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 `0` em `robot.move_at(0)`.

Exemplo de entrada de método#

mover_em#

O comando move_at move_at move o robô indefinidamente num ângulo específico. O robô continuará a mover-se até receber outra ação, como mudar de ângulo, rodar ou parar.

Usage:
robot.move_at(angle, velocity, units)

Parâmetros	Descrição
`angle`	O ângulo, em graus, que o robô se desloca. Pode ser um número inteiro ou decimal de -360 a 360.
`velocity`	Opcional. A velocidade de movimento, de 0% a 100% quando se utiliza `PERCENT`, ou de 0 a 200 milímetros por segundo quando se utiliza `MMPS`Pode ser um número inteiro ou decimal. Se não for fornecida qualquer velocidade, o robô move-se à velocidade de movimento atual.
`units`	Opcional. A unidade de velocidade: `PERCENT` (padrão) ou `MMPS` (milímetros por segundo).

# Move forward
robot.move_at(0)