Класс Mailbox обеспечивает функции приёма и передачи данных между блоками EV3 посредством беспроводного канала передачи данных Bluetooth.
Методы класса Mailbox:
Create
Mailbox.Create(name)
Создаёт почтовый ящик с указанным именем, который будет принимать входящие сообщения, адресованные данному блоку EV3 для указанного имени ящика. Только после создания ящика соответствующие входящие сообщения будут в нём сохраняться. Максимальное количество создаваемых в одном блоке ящиков — 30.
name — Имя почтового ящика для создания
Возвращает: Цифровой идентификатор почтового ящика, который необходим для получения сообщения из ящика внутри блока (в запущенной программе).
Send
Mailbox.Send(blockname, name, message)
Отправляет сообщение на другой блок EV3 в указанный почтовый ящик.
blockname — Имя блока EV3, на который нужно отправить сообщение. Bluetooth-соединение с этим блоком должно быть уже установлено. Если это поле можно оставить пустым, тогда сообщение будет отправлено всем блокам EV3, с которыми уже установлено соединение.
name — Имя существующего почтового ящика в блоке, на который отправляется сообщение. Полученное сообщение можно будет считать в блоке из ящика с заданным именем, используя его цифровой идентификатор.
message — Данные для передачи в блок в формате текстовой строки.
IsAvailable
Mailbox.IsAvailable(id)
Проверка наличия нового сообщения в указанном почтовом ящике в данном блоке.
id — Цифровой идентификатор почтового ящика
Возвращает: «True» если сообщение получено и «False» — в противном случае
Receive
Mailbox.Receive(id)
Получает последнее сообщение из указанного почтового ящика в данном блоке. Если ящик пуст, метод не вернёт управление в программу до тех пор, пока в ящике не появится новое сообщение. После получения сообщения из ящика, оно будет автоматически удалено и следующий вызов метода Receive() будет ожидать появления в ящике следующего сообщения. Если почтовый ящик с таким именем не существует, команда возвратит пустую строку.
id — Цифровой идентификатор почтового ящика
Возвращает: последнее сообщение — данные, полученные из указанного почтового ящика, в формате текстовой строки.
Connect
Mailbox.Connect(blockname)
Устанавливает соединение с другим блоком EV3 по каналу Bluetooth. Только после того, как соединение с другим блоком установлено (этой командой или «вручную» — из меню блока EV3), сообщения могут отправляться и приниматься.
blockname — Имя блока EV3, с которым нужно установить соединение.