Объект «mailbox»

Реализует связь между роботами в сети посредством механизма почтовых ящиков.

Метод	Описание
connect	Подключается к роботу с заданным IP-адресом по заданному порту (или порту по умолчанию), сообщает ему свой бортовой номер и регистрируется в сети «почтовых ящиков».
hasMessages	Возвращает true, если роботу пришло новое сообщение.
myHullNumber	Возвращает бортовой номер робота.
newMessage	Посылает сообщение после получения сообщения.
receive	Получает новое сообщение или блокирует исполнение скрипта до тех пор, пока сообщение не придёт.
send	Посылает роботу с указанным бортовым номером (или всем роботам) указанное сообщение.

connect

Подключается к роботу с заданным IP-адресом по заданному порту (или порту по умолчанию), сообщает ему свой бортовой номер и регистрируется в сети «почтовых ящиков».

Синтаксис

Python

mailbox.connect("ipAddress")
mailbox.connect("ipAddress", port)

JavaScript

mailbox.connect("ipAddress");
mailbox.connect("ipAddress", port);

В качестве параметров необходимо указать IP-адрес робота и порт. В случае, если порт не указан, используется порт по умолчанию.

Пример

Python

mailbox.connect("192.168.0.20", 8889)

JavaScript

mailbox.connect("192.168.0.20", 8889);

hasMessages

Возвращает true, если роботу пришло новое сообщение.

Синтаксис

Python

mailbox.hasMessages()

JavaScript

mailbox.hasMessages();

myHullNumber

Возвращает бортовой номер робота.

Синтаксис

Python

x = mailbox.myHullNumber()

JavaScript

var x = mailbox.myHullNumber();

newMessage

Посылает сообщение после получения нового сообщения.

Синтаксис

Python

mailbox.newMessage.connect(lambda sender, message: print(message))

JavaScript

mailbox.newMessage.connect(function(sender, message) { print(message); });

Первый параметр — бортовой номер отправителя, второй — само сообщение.

receive

Получает новое сообщение или блокирует исполнение скрипта до тех пор, пока сообщение не придёт.

Синтаксис

Python

message = mailbox.receive()

JavaScript

var message = mailbox.receive();	

send

Посылает роботу с указанным бортовым номером (или всем роботам) указанное сообщение.

Синтаксис

Python

mailbox.send("message")
mailbox.send(boardNumber, "message")

JavaScript

mailbox.send("message");
mailbox.send(boardNumber, "message");

В качестве параметра необходимо указать бортовой номер робота, которому хотите послать сообщение и сообщение. Если бортовой номер не указан, то сообщение отправляется всем роботам, зарегистрированным в сети.

Пример

Python

mailbox.send(1, "Hello") # отправка сообщения роботу с бортовым номер 1

JavaScript

mailbox.send(1, "Hello"); // отправка сообщения роботу с бортовым номер 1