pxt-calliope/docs/reference/radio/receive-number.md
Peli de Halleux 2b504d863d
Radiodocsupdate (#1430)
* a few updates

* more updates

* reorder radio blocks

* more shuffling of new radio apis

* fixing hot or ocold

* more doc fixes

* more updates

* fixing docs issues

* more doc fixes

* restore docs errors

* missing packate

* renamed argument of callback

* mssing radio

* more odcs fixes

* lock turtle

* ignore docs for now
2018-10-15 15:32:09 -07:00

1.6 KiB

Receive Number

Note: This API has been deprecated! Use on received number instead.

Receives the next number sent by a @boardname@ in the same radio group.

radio.receiveNumber();

Returns

  • the first number that the @boardname@ received. If it did not receive any numbers, this function will return 0.

Example: Simple number receiver

This example receives the number broadcasted another @boardname@ and shows it as a bar graph.

radio.onDataReceived(() => {
    led.plotBarGraph(radio.receiveNumber(), 1023);
})

Example: Light level receiver

This example shows the light level from the light level sender example as a number.

radio.setGroup(99)
basic.forever(() => {
    let level = radio.receiveNumber()
    basic.showNumber(level)
})

Example: Mailbot

This example receives the light level from the light level sender example and shows a text string like ALERT if the light level becomes much brighter. To find when the mail arrives, you can put the light level sender in your mailbox and it will tell you when someone opens the box. You can try this with a normal box too, like a present for a friend.

radio.setGroup(99)
let max = 0
basic.forever(() => {
    let level = radio.receiveNumber()
    if (level > max) {
        max = level
    }
    if (max > 10) {
        basic.showString("ALERT")
    }
})

See also

send number, on data received

radio