pxt-calliope/docs/reference/radio/send-value.md

46 lines
1.1 KiB
Markdown
Raw Normal View History

2016-06-17 00:15:14 +02:00
# Send Value
2016-06-15 14:09:40 +02:00
2016-11-02 01:44:37 +01:00
Send a [string]() and [number]() together by ``radio`` to other @boardname@s.
The maximum [string]() length is 12 characters.
2016-06-15 14:09:40 +02:00
2016-07-18 23:04:15 +02:00
```sig
radio.sendValue("name", 0);
2016-07-18 23:04:15 +02:00
```
2016-06-15 14:09:40 +02:00
### Parameters
2016-07-18 23:04:15 +02:00
* ``name`` is a [string](/reference/types/string) to send by radio
* ``value`` a [number](/reference/types/number) to send by radio
2016-06-15 14:09:40 +02:00
### Example: Broadcasting acceleration
2016-11-02 01:44:37 +01:00
This program sends your @boardname@'s **acceleration** (amount it is
2016-06-17 00:15:14 +02:00
speeding up or slowing down) in the `x` direction (left and right) to
2016-11-02 01:44:37 +01:00
other @boardname@s. This kind of program might be useful in a model car
2016-06-17 00:15:14 +02:00
or model rocket.
2016-06-15 14:09:40 +02:00
```blocks
2016-06-17 00:33:35 +02:00
radio.setGroup(99)
2016-06-15 14:09:40 +02:00
input.onButtonPressed(Button.A, () => {
radio.sendValue("acc", input.acceleration(Dimension.X))
2016-06-15 14:09:40 +02:00
})
```
2016-06-17 00:15:14 +02:00
This program receives the string and number sent by the last program.
Then it shows them on the LED screen.
```blocks
2016-06-17 00:33:35 +02:00
radio.setGroup(99)
radio.onDataPacketReceived(({ receivedString, receivedNumber }) => {
basic.showString(receivedString);
basic.showNumber(receivedNumber);
2016-06-17 00:15:14 +02:00
});
```
2016-06-15 14:09:40 +02:00
### See also
[on data packet received](/reference/radio/on-data-packet-received)
2016-06-15 14:09:40 +02:00
```package
radio
```