Peli de Halleux 96d354a8a8 Merge pull request #316 from OwenBrotherwood/patch-1

Correction for max. length of advertised url to 17

2016-12-09 15:13:12 -08:00

1.3 KiB

Raw Blame History

Avertise Url

Advertises a URL via the Eddystone protocol over Bluetooth.

~hint

Eddystone

Bluetooth beacons are used to indicate proximity to a place or object of interest. Beacons use Bluetooth advertising to broadcast a small amount of data, which can be received and acted upon by anyone in range with a suitable device and software, typically a smartphone and application.

There are various beacon message formats, which define the way Bluetooth advertising packets are used as containers for beacon data. iBeacon is Apple's beacon message format. Eddystone comes from Google.

~

bluetooth.advertiseUrl("https://pxt.microbit.org/", 7, true);

Parameters

url - a string containing the URL to broadcast, at most 17 characters long, excluding the protocol (eg: https://) which gets encoded as 1 byte.
power - a number representing the power level between 0 (short) and 7 (maximum range).

Example: Broadcast a secret code

bluetooth.advertiseUrl("https://pxt.io?secret=42", 7, true);

1.3 KiB Raw Blame History