pxt-calliope/docs/reference/radio/set-group.md

35 lines
1.1 KiB
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Set Group
Sets the group id for ``radio`` communications. A micro:bit can only listen to one group ID at any time.
Unless specified, the group id is automatically inferred from the script source. Every script with the same exact source code with start with the same group id.
## Important Security Consideration
The functions in the ``radio`` namespace allow the BBC micro:bit to communicate with other micro:bits.
This API does not contain any form of encryption, authentication or authorization. It's purpose is solely for use as a teaching aid to demonstrate how simple communications operates, and to provide a sandpit through which learning can take place.
For serious applications, BLE should be considered a substantially more secure alternative.
```sig
radio.setGroup(1)
```
### Parameters
2016-04-16 00:02:26 +02:00
* ``id`` -- a [number](/reference/types/number) between ``0`` and ``255``.
2016-03-26 00:47:20 +01:00
### Example
Sets the group to 128.
```blocks
radio.setGroup(128)
```
### See also
2016-04-16 00:02:26 +02:00
[receive number](/reference/radio/receive-number), [send number](/reference/radio/send-number), [on data received](/reference/radio/on-data-received)
2016-03-26 00:47:20 +01:00