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

connect

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

Синтаксис

Python
JavaScript
mailbox.connect("ipAddress")
mailbox.connect("ipAddress", port)
mailbox.connect("ipAddress");
mailbox.connect("ipAddress", port);
В качестве параметров необходимо указать IP-адрес робота и порт. В случае, если порт не указан, используется порт по умолчанию.

Пример

Python
JavaScript
mailbox.connect("192.168.0.20", 8889)
mailbox.connect("192.168.0.20", 8889);

hasMessages

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

Синтаксис

Python
JavaScript
mailbox.hasMessages()
mailbox.hasMessages();

myHullNumber

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

Синтаксис

Python
JavaScript
x = mailbox.myHullNumber()
var x = mailbox.myHullNumber();

newMessage

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

Синтаксис

Python
JavaScript
mailbox.newMessage.connect(lambda sender, message: print(message))
mailbox.newMessage.connect(function(sender, message) { print(message); });
Первый параметр — бортовой номер отправителя, второй — само сообщение.

receive

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

Синтаксис

Python
JavaScript
message = mailbox.receive()
var message = mailbox.receive();

send

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

Синтаксис

Python
JavaScript
mailbox.send("message")
mailbox.send(boardNumber, "message")
mailbox.send("message");
mailbox.send(boardNumber, "message");
В качестве параметра необходимо указать бортовой номер робота, которому хотите послать сообщение и сообщение. Если бортовой номер не указан, то сообщение отправляется всем роботам, зарегистрированным в сети.

Пример

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