Diferenças do WebSocket AIM

Esta página descreve as principais diferenças entre a API Python baseada em WebSocket e a API Python do VEXcode AIM. Inclui funcionalidades adicionais, classes removidas e suporte para casos de utilização avançados, como o controlo de múltiplos robôs.

Métodos adicionais

reproduzir_ficheiro_local

O método play_local_file reproduz um ficheiro de som armazenado no computador e emite o som através do altifalante do robô. Isto permite reproduzir ficheiros personalizados .wav ou .mp3 no robô sem ter de os carregar.

Usage:
robot.sound.play_local_file(filepath: str, volume = 100)

Parâmetros	Descrição
caminho do ficheiro	Uma string que especifica o caminho para um ficheiro .wav ou .mp3 no computador.
volume	Opcional. O volume de reprodução em percentagem, de 0 a 100. O predefinido é 100.

Para ver um exemplo de implementação, abra play_sounds.py

obter_imagem_da_câmara

O método get_camera_image captura o quadro atual do sensor de visão de IA do robô e devolve-o como um objeto JPEG comprimido de bytes . Isto é normalmente utilizado com ferramentas como o OpenCV para exibir um fluxo de vídeo ao vivo.

Usage:
robot.vision.get_camera_image()

Parâmetros	Descrição
	Este método não tem parâmetros.

Para ver um exemplo de implementação, consulte stream_video.py.

Utilizar vários robôs em simultâneo

Pode ligar-se a vários robôs especificando manualmente o endereço IP de cada robô ao criar Robot.

Usage:
Robot(address)

Parâmetros	Descrição
morada	Opcional. O endereço IP do robô. Se for omitido, o endereço no campo host de settings.json será utilizado por defeito.

Para ver um exemplo de implementação, abra multiple_robots.py.

Aulas removidas

As seguintes classes disponíveis na API Python do VEXcode não estão disponíveis na versão WebSocket:

• Controller

• Event

Funcionalidades apenas disponíveis no VEXcode

As seguintes características não são atualmente suportadas pela API WebSocket do AIM e requerem ligação através do VEXcode AIM:

• Atualizando o firmware do robô

• Carregar imagens personalizadas

• Carregando sons personalizados

• Mensagens de robô para robô