pxt-calliope/docs/projects/mini-chat.md
Juri Wolf a93febb5b7
Map and clean deprecated functions (#175)
* add image and deprecated arrow functions

* update locales

* map basic.showArrow

* map arrow blocks

* map & remove arrow images

* remove arrow blocks

* update locales

* remove & patch:
rgbw -> rgb
button/pin pressed -> button/pin event
loudness -> soundLevel

* update ts mappings for arrows

* add wip ts patch rules

* update .blocks files

* use Click instead of Down as default in Documentation and tests

* patch test.blocks

* fix lowercase name tag

* update test.blocks

* update blocks test files

* update blocks test files

* format block files

* pass blocks file tests

* fix ts mapping

* fix color.defl value

closes https://github.com/microsoft/pxt-calliope/issues/136

* fix ts mappings

- add optional spacing at the end of rgbw()
- map up to v4.0.19

* add suggested changes

* replace innerText by textContent

Co-authored-by: JW <gitkraken@juriwolf.de>
Co-authored-by: Juri <info@juriwolf.de>
2022-04-26 10:28:42 -07:00

1.9 KiB

Mini Chat

Introduction @unplugged

Two @boardname@ connected via radio

Use the radio to send and receive messages with other @boardname@.

Sending a message @fullscreen

Use ||input:on button pressed|| to send a text message over radio with ||radio:send string||. Every @boardname@ nearby will receive this message.

input.onButtonEvent(Button.A, ButtonEvent.Down, () => {
    radio.sendString("Yo");
});

Receiving a message @fullscreen

Add a ||radio:on received string|| block to run when a message is received.

radio.onReceivedString(function (receivedString) {
})

Displaying text @fullscreen

Add a ||basic:show string|| to display the string on the screen. Pull the ||variables:receivedString|| out of ||radio:on received string|| and put it into ||basic:show string||.

radio.onReceivedString(function (receivedString) {
    basic.showString(receivedString);
})

Testing in the simulator @fullscreen

Press button A on the simulator, you will notice that a second @boardname@ appears (if your screen is too small, the simulator might decide not to show it). Try pressing A again and notice that the "Yo" message gets displayed on the other @boardname@.

input.onButtonEvent(Button.A, ButtonEvent.Down, () => {
    radio.sendString("Yo");
});
radio.onReceivedString(function (receivedString) {
    basic.showString(receivedString);
})

Try it for real @fullscreen

If you two @boardname@s, download the program to each one. Press button A on one and see if the other gets a message.

Groups @fullscreen

Use the ||radio:set group|| block to assign a group number to your program. You will only receive messages from @boardname@s within the same group. Use this to avoid receiving messages from every @boardname@ that is transmitting.

radio.setGroup(123)
radio