Blocos#

A Referência da API de Blocos VEX AIR explica o que cada bloco VEXcode faz, como as suas entradas alteram o comportamento do drone e como o bloco pode ser utilizado num projeto.

Utilize esta referência quando pretende compreender um bloco antes de o adicionar a um projeto, verificar o que um bloco reporta ou comparar blocos semelhantes numa categoria.

Os blocos são utilizados em projetos VEXcode AIR Blocks. Os projetos em Python utilizam a secção de API baseada em texto.

Como ler uma entrada de bloco#

A maioria das entradas de bloco inclui as seguintes partes:

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

  • Imagem do bloco - Mostra o aspeto do bloco no VEXcode AIR.

  • Parâmetros - Lista as entradas do bloco e explica como cada entrada afeta o drone ou o projeto.

  • Valor de retorno - Explica o que um bloco Booleano ou Reporter reporta.

  • Exemplo - Mostra uma forma de utilizar o bloco num projeto.

Tipos de blocos comuns#

Blocos de diferentes formatos têm funções diferentes num projeto.

Tipo de bloco

O que significa

Monte

Um bloco que executa uma ação. Os blocos empilhados ligam-se acima e abaixo de outros blocos numa pilha.

Chapéu

Um bloco que inicia uma pilha de blocos quando algo acontece, como quando o projeto é iniciado ou quando ocorre um evento.

Booleano

Um bloco que retorna Verdadeiro ou Falso. Os blocos booleanos são frequentemente utilizados dentro de condições, como blocos se então ou espere até.

Repórter

Um bloco que apresenta um valor, como um número ou texto. Os blocos de visualização são frequentemente utilizados dentro de outros blocos.

Bloco C

Um bloco que envolve outros blocos e controla quando ou como são executados, como blocos repetitivos ou blocos se então.

Exemplo de entrada em bloco#

mover#

O bloco mover move o drone em quatro direções específicas utilizando a velocidade de movimento atual.

mover bloco de pilha para a frente#
mover [frente v]

Parâmetros

Descrição

direção

Mova o drone numa das seguintes direções:

  • para a frente
  • para a direita
  • para a esquerda
  • para trás

Exemplo

quando iniciar
[Move forward for 2 seconds.]
decolar para [500] [mm v] ▶
mover [frente v]
aguardar [2] segundos
pousar ▶