80 lines
1.5 KiB
Markdown
80 lines
1.5 KiB
Markdown
|
# Events Library
|
||
|
|
|
||
|
|
The functions in the events namespace allow the BBC micro:bit to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart). The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device. The events accessible from Touch Develop are listed below.
|
||
|
|
|
||
|
|
### Remote control
|
||
|
|
|
||
|
|
Control the presentation of media content available on a remote device using the `remote control` function
|
||
|
|
|
||
|
|
```
|
||
|
|
export function remoteControl(event: string)
|
||
|
|
```
|
||
|
|
|
||
|
|
The remote control specific events include:
|
||
|
|
|
||
|
|
* play
|
||
|
|
* pause
|
||
|
|
* stop
|
||
|
|
* next track
|
||
|
|
* previous track
|
||
|
|
* forward
|
||
|
|
* rewind
|
||
|
|
* volume up
|
||
|
|
* volume down
|
||
|
|
|
||
|
|
### Camera
|
||
|
|
|
||
|
|
Access the photo/video-taking functionality of a remote device using the *camera* function:
|
||
|
|
|
||
|
|
```
|
||
|
|
export function camera(event: string)
|
||
|
|
```
|
||
|
|
|
||
|
|
The camera-specific events include:
|
||
|
|
|
||
|
|
* toggle front-rear
|
||
|
|
* launch photo mode
|
||
|
|
* take photo
|
||
|
|
* stop photo mode
|
||
|
|
* launch video mode
|
||
|
|
* start video capture
|
||
|
|
* stop video capture
|
||
|
|
* stop video mode
|
||
|
|
|
||
|
|
### Alert
|
||
|
|
|
||
|
|
Raise an alert on a remote device using the `alert` function
|
||
|
|
|
||
|
|
```
|
||
|
|
export function alert(event: string)
|
||
|
|
```
|
||
|
|
|
||
|
|
The set of alerting-specific events include:
|
||
|
|
|
||
|
|
* display toast
|
||
|
|
* vibrate
|
||
|
|
* play sound
|
||
|
|
* play ringtone
|
||
|
|
* find my phone
|
||
|
|
* alarm 1
|
||
|
|
* alarm 2
|
||
|
|
* alarm 3
|
||
|
|
* alarm 4
|
||
|
|
* alarm 5
|
||
|
|
* alarm 6
|
||
|
|
|
||
|
|
### Audio recorder
|
||
|
|
|
||
|
|
Access the audio recording capabilities of the device using the `audio recording` function
|
||
|
|
|
||
|
|
```
|
||
|
|
export function audioRecorder(event: string)
|
||
|
|
```
|
||
|
|
|
||
|
|
The set of audio recorder events include:
|
||
|
|
|
||
|
|
* launch
|
||
|
|
* start capture
|
||
|
|
* end capture
|
||
|
|
* stop
|