pxt-calliope/docs/reference/radio/on-received-string.md
2018-07-09 11:17:32 -07:00

1.2 KiB

on Received String

Run part of a program when the @boardname@ receives a string over radio.

radio.onReceivedString(function (receivedString) {})

Parameters

  • receivedString: The string that was sent in this packet or the empty string if this packet did not contain a string. See send string and send value

Example

This program continuously sends a cheerful message. It also receives a messages from nearby @boardname@s. It shows these messages on the screen.

basic.forever(() => {
    radio.sendString("I'm happy");
})
radio.onReceivedString(function (receivedString) {
    basic.showString(receivedString)
})

Troubleshooting

The ||radio:on received string|| event can only be created once, due to the hardware restrictions.

The radio set group might need to be set, synchronized , before the radio events will function.

See also

on received number, send number, send string, send value, set group

radio