Added documentation for on-bluetooth-connected and on-bluetooth-disconnected event handlers
This commit is contained in:
parent
343968cf09
commit
8faeeffecf
33
docs/reference/bluetooth/on-bluetooth-connected.md
Executable file
33
docs/reference/bluetooth/on-bluetooth-connected.md
Executable file
@ -0,0 +1,33 @@
|
||||
# On Bluetooth Connected
|
||||
|
||||
![](/static/bluetooth/Bluetooth_SIG.png)
|
||||
|
||||
For another device like a smartphone to use any of the Bluetooth "services" which the micro:bit has, it must first connect to the micro:bit. This block starts an [event handler](/reference/event-handler) which in this case will run when something connects to your micro:bit using Bluetooth.
|
||||
|
||||
You could use this event handler to display a letter "C" on the micro:bit LED grid so you know you have a Bluetooth connection. Or you might want to send some data you've been accumulating to your smartphone as soon as it connects to your micro:bit. Maybe you've been using the accelerometer in your micro:bit to count your steps for example. Using this event handler you could send the accumulated step count to your phone when it establishes a Bluetooth connection.
|
||||
|
||||
~~~~sig
|
||||
bluetooth.onBluetoothConnected(() => {
|
||||
});
|
||||
~~~~
|
||||
|
||||
### Example: Displaying "C" when another device connects to the micro:bit over Bluetooth
|
||||
|
||||
~~~~blocks
|
||||
bluetooth.onBluetoothConnected(() => {
|
||||
basic.showString("C");
|
||||
});
|
||||
~~~~
|
||||
|
||||
### Video - on Bluetooth connected
|
||||
|
||||
[![micro:bit Bluetooth demo video](/static/bluetooth/microbit_on_connected.png)](
|
||||
http://www.youtube.com/watch?v=HyBcsD9Eh6I "Click to launch YouTube video"
|
||||
)
|
||||
|
||||
### See also
|
||||
|
||||
[Bluetooth SIG](https://www.bluetooth.com)
|
||||
|
||||
[Bluetooth on micro:bit resources](http://bluetooth-mdw.blogspot.co.uk/p/bbc-microbit.html)
|
||||
|
33
docs/reference/bluetooth/on-bluetooth-disconnected.md
Executable file
33
docs/reference/bluetooth/on-bluetooth-disconnected.md
Executable file
@ -0,0 +1,33 @@
|
||||
# On Bluetooth Disconnected
|
||||
|
||||
![](/static/bluetooth/Bluetooth_SIG.png)
|
||||
|
||||
For another device like a smartphone to use any of the Bluetooth "services" which the micro:bit has, it must first connect to the micro:bit. This block starts an [event handler](/reference/event-handler) which in this case will run when a device which is connected to your micro:bit over Bluetooth disconnects.
|
||||
|
||||
You could use this event handler to display a letter "D" on the micro:bit LED grid so you know that the Bluetooth connection has been closed.
|
||||
|
||||
~~~~sig
|
||||
bluetooth.onBluetoothDisconnected(() => {
|
||||
});
|
||||
~~~~
|
||||
|
||||
### Example: Displaying "D" when a Bluetooth connection to the micro:bit is closed
|
||||
|
||||
~~~~blocks
|
||||
bluetooth.onBluetoothDisconnected(() => {
|
||||
basic.showString("D");
|
||||
});
|
||||
~~~~
|
||||
|
||||
### Video - on Bluetooth disconnected
|
||||
|
||||
[![micro:bit Bluetooth demo video](/static/bluetooth/microbit_on_disconnected.png)](
|
||||
http://www.youtube.com/watch?v=HyBcsD9Eh6I "Click to launch YouTube video"
|
||||
)
|
||||
|
||||
### See also
|
||||
|
||||
[Bluetooth SIG](https://www.bluetooth.com)
|
||||
|
||||
[Bluetooth on micro:bit resources](http://bluetooth-mdw.blogspot.co.uk/p/bbc-microbit.html)
|
||||
|
BIN
docs/static/bluetooth/microbit_on_connected.png
vendored
Executable file
BIN
docs/static/bluetooth/microbit_on_connected.png
vendored
Executable file
Binary file not shown.
After Width: | Height: | Size: 254 KiB |
BIN
docs/static/bluetooth/microbit_on_disconnected.png
vendored
Executable file
BIN
docs/static/bluetooth/microbit_on_disconnected.png
vendored
Executable file
Binary file not shown.
After Width: | Height: | Size: 272 KiB |
Loading…
Reference in New Issue
Block a user