a93febb5b7
* 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>
68 lines
1.9 KiB
Markdown
68 lines
1.9 KiB
Markdown
# Mini Chat
|
|
|
|
## Introduction @unplugged
|
|
|
|
|
|
|
|
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.
|
|
|
|
```blocks
|
|
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.
|
|
|
|
```blocks
|
|
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||``.
|
|
|
|
```blocks
|
|
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@.
|
|
|
|
```blocks
|
|
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.
|
|
|
|
```blocks
|
|
radio.setGroup(123)
|
|
```
|
|
|
|
|
|
```package
|
|
radio
|
|
```
|